[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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

From: Paul Morris
Subject: Re: Docs: example for line-break-permission and page-break-permission
Date: Tue, 25 Feb 2014 11:44:28 -0800 (PST)

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 {
      \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 {
      \override NonMusicalPaperColumn.line-break-permission = ##f

Maybe a clearer name for these commands would have been:

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


View this message in context: 
Sent from the Bugs mailing list archive at Nabble.com.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]