Re: [Lilypond-auto] Issue 4052 in lilypond: Document more details on Staff Group Hierarchy

[lilypond]

Comment #3 on issue 4052 by address@hidden: Document more details on  
Staff Group Hierarchy
https://code.google.com/p/lilypond/issues/detail?id=4052

Here is an 'ASCII' Hierarchical diagram (a la the ROADMAP):

--snip--
Score - This is the top level notation context.  No other context can
|       contain a Score ontext.  This context handles the administration
|       of time signatures.  It also makes sure that items such as
|       clefs, time signatures, and key-signatures are aligned across
|       staves.  You cannot explicitly instantiate a Score context
|       (since it is not contained in any other context).
|
| - ChoirStaff - Identical to StaffGroup except that the contained
|     |          staves are not connected vertically.
|     |
|     | - ChoirStaff
|     | - ChordNames
|     | - DrumStaff
|     | - FiguredBass
|     | - GrandStaff
|     | - Lyrics
|     | - PianoStaff
|     | - RhythmicStaff
|     | - Staff
|     | - StaffGroup
|
| - ChordNames - Typesets chord names.
|
| - Devnull - Silently discards all musical information given to this
|             context.
|
| - DrumStaff - Handles typesetting for percussion.
|     |
|     | - CueVoice
|     | - DrumVoice
|     | - NullVoice
|
| - FiguredBass - A context for printing a figured bass line.
|
| - FretBoards - A context for displaying fret diagrams.
|
| - GrandStaff - A group of staves, with a brace on the left side,
|     |          grouping the staves together.  The bar lines of the
|     |          contained staves are connected vertically.
|     |
|     | - ChordNames
|     | - DrumStaff
|     | - Dynamics
|     | - FiguredBass
|     | - Lyrics
|     | - RhythmicStaff
|     | - Staff
|     | - TabStaff
|
| - GregorianTranscriptionStaff - Same as Staff context, except that it
|     |                           is accommodated for typesetting a
|     |                           piece in Gregorian Chant notation.
|     |
|     | - CueVoice
|     | - GregorianTranscriptionVoice
|     | - NullVoice
|
| - KievanStaff - Same as Staff context, except that it is accommodated
|     |           for typesetting a piece in Kievan style.
|     |
|     | - CueVoice
|     | - KievanVoice
|     | - NullVoice
|
| - Lyrics - Corresponds to a voice with lyrics.  Handles the printing
|            of a single line of lyrics
|
| - MensuralStaff - Same as Staff context, except that it is
|     |             accommodated for typesetting a piece in
|     |             Mensural style.
|     |
|     | - CueVoice
|     | - MensuralVoice
|     | - NullVoice
|
| - NoteNames - A context for printing the names of notes.
|
| - NullVoice - For aligning lyrics without printing notes.
|
| - PetrucciStaff - Same as Staff context, except that it is
|     |             accommodated for typesetting a piece in
|     |             Petrucci style.
|     |
|     | - CueVoice
|     | - NullVoice
|     | - PetrucciVoice
|
| - PianoStaff - Just like GrandStaff, but the staves are only removed
|     |          together, never separately.
|     |
|     | - ChordNames
|     | - DrumStaff
|     | - Dynamics
|     | - FiguredBass
|     | - Lyrics
|     | - RhythmicStaff
|     | - Staff
|     | - TabStaff
|
| - RhythmicStaff - A context like Staff but for printing rhythms.
|     |             Pitches are ignored; the notes are printed on
|     |             one line.
|     |
|     | - CueVoice
|     | - Voice
|
| - Staff - Handles clefs, bar lines, keys and accidentals.
|     |
|     | - CueVoice
|     | - NullVoice
|     | - Voice
|
| - StaffGroup - Groups staves while adding a bracket on the left side,
|     |          grouping the staves together.  The bar lines of the
|     |          contained staves are connected vertically.  StaffGroup
|     |          only consists of a collection of staves, with a bracket
|     |          in front and spanning bar lines.
|     |
|     | - ChordNames
|     | - ChoirStaff
|     | - DrumStaff
|     | - FiguredBass
|     | - GrandStaff
|     | - Lyrics
|     | - PianoStaff
|     | - RhythmicStaff
|     | - Staff
|     | - StaffGroup
|     | - TabStaff
|
| - TabStaff - Context for generating tablature.  It accepts only
|     |        TabVoice contexts and handles the line spacing, the
|     |        tablature clef etc. properly.
|     |
|     | - CueVoice
|     | - NullVoice
|     | - TabVoice
|
| - VaticanaStaff - Same as Staff context, except that it is
|     |             accommodated for typesetting Gregorian Chant in the
|     |             notational style of Editio Vaticana.
|     |
|     | - CueVoice
|     | - NullVoice
|     | - VaticanaVoice

--snip-

This might be appropriate in an Appendix perhaps?

--
You received this message because this project is configured to send all  
issue notifications to this address.
You may adjust your notification preferences at:
https://code.google.com/hosting/settings