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. _______________________________________________ bug-lilypond mailing list bug-lilypond@gnu.org https://lists.gnu.org/mailman/listinfo/bug-lilypond