Re: Docs: example for line-break-permission and page-break-permission

[Paul Morris]

Trevor Daniels wrote
> However, I'm not sure that the change proposed by Paul is correct.
> I think the current wording is correct.
> 
> Try this, and you'll see the long line runs off the right side of the
> page.
> No line break is inserted to prevent it; only the manual ones are
> actioned.

I tried this and I see what you mean.  Also this for testing pagebreak:

\paper {
  indent = #0
  ragged-right = ##t
  ragged-bottom = ##t
}

music = \relative c'' { c8 c c c c c c c }

\score {
  \new Staff {
    \repeat unfold 110 { \music } 
  }
  \layout {
    \context {
      \Score
      \override NonMusicalPaperColumn.page-break-permission = ##f
    }
  }
}

No auto page breaks were inserted, the music was compressed onto one page,
and I got these:
warning: cannot fit music on page: overflow is 27.591750
warning: compressing music to fit

So I think Trevor is right that this is an accurate statement:

"When line-break-permission is overridden to false, Lily will insert line
breaks at explicit \break commands and nowhere else. When
page-break-permission is overridden to false, Lily will insert page breaks
at explicit \pageBreak commands and nowhere else."

(And if that's the case then it convinces me that what I reported in the
other thread is indeed a bug.)

That means that this statement is potentially misleading:

"Lily sometimes rejects explicit \break and \pageBreak commands. There are
two commands to override this behavior:"

If these commands prevent automatic breaks, then that is different from, and
unrelated to, preventing rejecting explicit breaks.

So I like James' suggestion for a more thorough explanation that would
remove this ambiguity.


Trevor Daniels wrote
> Yes.  I'd remove the pagebreak from this example (since its effect is not
> clear in the docs anyway); use a smaller example showing a line break
> being
> inserted and being suppressed; and simply say page-break-permission
> works the same way.  I'd also give the music variable a full bar of notes
> rather than half a bar so the repeat counts correspond with the number
> of bars in the lines.

This makes sense to me.  Here's a smaller and more focused example:

% default output
\repeat unfold 10 { c'4 c' c' c' } 

% automatic line breaks suppressed
\score {
  \new Staff {
    \repeat unfold 10 { c'4 c' c' c' } 
  }
  \layout {
    \context {
      \Score
      \override NonMusicalPaperColumn.line-break-permission = ##f
    }
  }
}

Maybe a clearer name for these commands would have been:

  automatic-line-breaks = ##f
  automatic-page-breaks = ##f

-Paul





--
View this message in context: 
http://lilypond.1069038.n5.nabble.com/Docs-example-for-line-break-permission-and-page-break-permission-tp159803p159851.html
Sent from the Bugs mailing list archive at Nabble.com.