[Lilypond-auto] Issue 3045 in lilypond: Document changing default rest position in NR 1.2.2

[lilypond]

Status: Accepted
Owner: ----
Labels: Type-Documentation

New issue 3045 by address@hidden: Document changing default rest  
position in NR 1.2.2
http://code.google.com/p/lilypond/issues/detail?id=3045

Arle Lommel reported here:

http://lists.gnu.org/archive/html/bug-lilypond/2012-12/msg00141.html

> I’m not top posting.

NR 1.2.2 Rests currently documents how to change the default vertical
position of multi-measure rests but not how to change the default
vertical position of normal rests. As a result finding information about
this functionality requires looking in a section that is not immediately
obvious as the correct location and extrapolating from there to find the
proper command.

It is suggested that the first subsection, Rests, receive the following
addition at the end before Selected snippets.

Sometimes it may desirable to change the default staff position of rests
in a voice. This effect can be achieved using \override Rest
#'staff-position, as shown below. Note that the method is parallel to
that shown in <a
href="#index-positioning-multi_002dmeasure-rests">Positioning
multi-measure rests</a> below [CONTRIBUTOR’S NOTE: link is in the same
HTML page].

That would be followed by an example something like this:

\version "2.16.0"

\header {
}

\score {
  \new Staff = "main" {
    <<
      { \new Voice {
        \voiceOne
        \relative c' {
          \override Rest #'staff-position = #-5
          \voiceOneStyle r4 c d e |
          \override Rest #'staff-position = #4
          \voiceOneStyle r2 g'4 a  |
        }
      } }
    \\
      {\new Voice {
        \voiceTwo
        \relative c''' {
          \override Rest #'staff-position = #7
          \voiceTwoStyle r8 c b r a r g r |
          \override Rest #'staff-position = #0
          c,4 b r a |
        }
      } }
    >>
  }
}


\layout {
}

(I realize this is contrived as an example, but it illustrates the usage.)

I would be absolutely happy to receive feedback on this or work
to improve the example.