RE: rearrange manual

[Trevor Daniels]

I feel the vocal music bits are a little buried in the Text
section.  Perhaps if this section were renamed "Text and
Lyrics" it would improve matters.

Trevor

> -----Original Message-----
> From: address@hidden
> [mailto:lilypond-user-bounces+t.daniels=treda.co.u
> address@hidden Behalf Of
> Graham Percival
> Sent: 09 September 2007 12:58
> To: lilypond-user Mailinglist; lily-devel
> Subject: GDP: rearrange manual
>
>
> Despite me being fairly happy with out table of
> contents, I think we
> could still improve the arrangement of
> subsections.  Here's my proposal.
>
> LIMITED DISCUSSION
> To keep discussion focused and as un-confused as
> possible, this is a
> discussion *only* about the arrangement of
> subsections.  Other parts of
> GDP will be discussed later.
>
> This means:
> - propose new/changed chapter/sections
> - propose renamings of chapter/sections
> - *do not* discuss new subsections or renamings
> of subsections.  That
>   will come later.
>
> GENERAL IDEAS
> - the manual will be split even more into
> Learning Manual / Notation
>   Reference.  This is the notation reference, so
> we assume that users
>   have read the LM.  They know about music
> expressions, \override, etc.
>   The LM will be increased to accomodate for
> this, but that's a separate
>   discussion.
>
>
>     * 6 Basic musical notation
>           o 6.1 Pitches
>                 + 6.1.1 Normal pitches
>                 + 6.1.2 Accidentals
>                 + 6.1.3 Cautionary accidentals
>                 + 6.1.4 Micro tones
>                 + 6.1.5 Note names in other languages
>                 + 6.1.6 Relative octaves
>                 + 6.1.7 Octave check
>                 + 6.1.8 Rests
>                 + 6.1.9 Skips
>           o 6.2 Affecting multiple pitches
>                 + 6.2.1 Clef
>                 + 6.2.2 Key signature
>                 + 6.2.3 Transpose
>                 + 6.2.4 Instrument transpositions
>                 + 6.2.5 Ottava brackets
>           o 6.3 Rhythms
>                 + 6.3.1 Durations
>                 + 6.3.2 Augmentation dots
>                 + 6.3.3 Tuplets
>                 + 6.3.4 Scaling durations
>                 + 6.3.5 Automatic note splitting
>                 + 6.3.6 Aligning to cadenzas
>           o 6.4 Meter
>                 + 6.4.1 Time signature
>                 + 6.4.2 Partial measures
>                 + 6.4.3 Unmetered music
>                 + 6.4.4 Polymetric notation (alternating)
>                 + 6.4.5 Polymetric notation (simultaneous)
>                 + 6.4.6 Time administration
>                 + 6.4.7 Proportional notation
> (introduction)
>                 + 6.4.8 Automatic beams
>                 + 6.4.9 Manual beams
>                 + 6.4.10 Feathered beams
>           o 6.5 Bars
>                 + 6.5.1 Bar check
>                 + 6.5.2 Barnumber check
>                 + 6.5.3 Multi measure rests
>                 + 6.5.4 Bar lines
>                 + 6.5.5 Bar numbers
>                 + 6.5.6 Rehearsal marks
>           o 6.6 Polyphony
>                 + 6.6.1 Chords
>                 + 6.6.2 Stems
>                 + 6.6.3 Basic polyphony
>                 + 6.6.4 Explicitly instantiating voices
>                 + 6.6.5 Collision resolution
>                 + 6.6.6 Clusters
>                 + 6.6.7 Automatic part combining
>                 + 6.6.8 Writing music in parallel
>     * 7 Decorating musical notation
>           o 7.1 Connecting notes
>                 + 7.1.1 Ties
>                 + 7.1.2 Slurs
>                 + 7.1.3 Phrasing slurs
>                 + 7.1.4 Laissez vibrer ties
>                 + 7.1.5 Grace notes
>                 + 7.1.6 Analysis brackets
>           o 7.2 Expressive marks
>                 + 7.2.1 Articulations
>                 + 7.2.2 Dynamics (absolute)
>                 + 7.2.3 Dynamics (crescendi)
>                 + 7.2.4 Breath marks
>                 + 7.2.5 Trills
>                 + 7.2.6 Glissando
>                 + 7.2.7 Arpeggio
>                 + 7.2.8 Falls and doits
>           o 7.3 Staff notation
>                 + 7.3.1 System start delimiters
>                 + 7.3.2 Staff symbol
>                 + 7.3.3 Hiding staves
>                 + 7.3.4 Metronome marks
>                 + 7.3.5 Instrument names
>                 + 7.3.6 Quoting other voices
>                 + 7.3.7 Formatting cue notes
>           o 7.4 Repeats
>                 + 7.4.1 Repeat types
>                 + 7.4.2 Repeat syntax
>                 + 7.4.3 Repeats and MIDI
>                 + 7.4.4 Manual repeat commands
>                 + 7.4.5 Tremolo repeats
>                 + 7.4.6 Tremolo subdivisions
>                 + 7.4.7 Measure repeats
>           o 7.5 Educational use
>                 + 7.5.1 Balloon help
>                 + 7.5.2 Fingering instructions
>                 + 7.5.3 Blank music sheet
>                 + 7.5.4 Grid lines
>                 + 7.5.5 Shape note heads
>                 + 7.5.6 Easy Notation note heads
>           o 7.6 Special use
>                 + 7.6.1 Special noteheads
>                 + 7.6.2 Improvisation
>                 + 7.6.3 Selecting notation font size
>                 + 7.6.4 Hidden notes
>                 + 7.6.5 Coloring objects
>                 + 7.6.6 Parentheses
>     * 8 Instrument-specific notation
>           o 8.1 Piano music
>                 + 8.1.1 Pedals
>                 + 8.1.2 Automatic staff changes
>                 + 8.1.3 Manual staff switches
>                 + 8.1.4 Staff switch lines
>                 + 8.1.5 Cross staff stems
>           o 8.2 Chord names
>                 + 8.2.1 Introducing chord names
>                 + 8.2.2 Chords mode
>                 + 8.2.3 Printing chord names
>                 + 8.2.4 Figured bass
>           o 8.3 Rhythmic music
>                 + 8.3.1 Showing melody rhythms
>                 + 8.3.2 Entering percussion
>                 + 8.3.3 Percussion staves
>                 + 8.3.4 Ghost notes
>           o 8.4 Guitar
>                 + 8.4.1 String number indications
>                 + 8.4.2 Tablatures basic
>                 + 8.4.3 Non-guitar tablatures
>                 + 8.4.4 Banjo tablatures
>                 + 8.4.5 Fret diagrams
>                 + 8.4.6 Right hand fingerings
>                 + 8.4.7 Other guitar issues
>           o 8.5 Bagpipe
>                 + 8.5.1 Bagpipe definitions
>                 + 8.5.2 Bagpipe example
>           o 8.6 Bowed strings
>                 + 8.6.1 Artificial harmonics
>           o 8.7 Ancient notation
>                 + 8.7.1 Ancient note heads
>                 + 8.7.2 Ancient accidentals
>                 + 8.7.3 Ancient rests
>                 + 8.7.4 Ancient clefs
>                 + 8.7.5 Ancient flags
>                 + 8.7.6 Ancient time signatures
>                 + 8.7.7 Ancient articulations
>                 + 8.7.8 Custodes
>                 + 8.7.9 Divisiones
>                 + 8.7.10 Ligatures
>                       # 8.7.10.1 White mensural ligatures
>                       # 8.7.10.2 Gregorian square
> neumes ligatures
>                 + 8.7.11 Gregorian Chant contexts
>                 + 8.7.12 Mensural contexts
>                 + 8.7.13 Musica ficta accidentals
>     * 9 Text
>           o 9.1 Text in a score
>                 + 9.1.1 Text scripts
>                 + 9.1.2 Text and line spanners
>                 + 9.1.3 Text spanners
>                 + 9.1.4 Text marks
>           o 9.2 Text markup section
>                 + 9.2.1 Text markup
>                 + 9.2.2 Nested scores
>                 + 9.2.3 Page wrapping text
>                 + 9.2.4 Overview of text markup commands
>                 + 9.2.5 Overview of text markup
> list commands
>                 + 9.2.6 Font selection
>                 + 9.2.7 New dynamic marks
>           o 9.3 Vocal music
>                 + 9.3.1 Setting simple songs
>                 + 9.3.2 Entering lyrics
>                 + 9.3.3 Aligning lyrics to a melody
>                       # 9.3.3.1 Automatic
> syllable durations
>                       # 9.3.3.2 Another way of
> entering lyrics
>                       # 9.3.3.3 Assigning more
> than one syllable to a
>                       # single note
>                       # 9.3.3.4 More than one
> note on a single syllable
>                       # 9.3.3.5 Extenders and hyphens
>                 + 9.3.4 Working with lyrics and
> identifiers
>                 + 9.3.5 Flexibility in placement
>                       # 9.3.5.1 Lyrics to
> multiple notes of a melisma
>                       # 9.3.5.2 Divisi lyrics
>                       # 9.3.5.3 Switching the
> melody associated with a
>                       # lyrics line
>                       # 9.3.5.4 Lyrics
> independent of notes
>                 + 9.3.6 Spacing lyrics
>                 + 9.3.7 More about stanzas
>                       # 9.3.7.1 Adding stanza numbers
>                       # 9.3.7.2 Adding dynamics marks
>                       # 9.3.7.3 Adding singer names
>                       # 9.3.7.4 Printing stanzas
> at the end
>                       # 9.3.7.5 Printing stanzas
> at the end in multiple
>                       # columns
>                 + 9.3.8 Ambitus
>                 + 9.3.9 Other vocal issues
>           o 9.4 Titles and headers
>                 + 9.4.1 Creating titles
>                 + 9.4.2 Custom titles
>                 + 9.4.3 Reference to page numbers
>                 + 9.4.4 Table of contents
>     * 10 Input and output
>           o 10.1 Input files
>                 + 10.1.1 File structure (introduction)
>                 + 10.1.2 File structure
>                 + 10.1.3 A single music expression
>                 + 10.1.4 Multiple scores in a book
>                 + 10.1.5 Extracting fragments of notation
>                 + 10.1.6 Including LilyPond files
>                 + 10.1.7 Different editions from
> one source
>                 + 10.1.8 Text encoding
>           o 10.2 MIDI output
>                 + 10.2.1 Creating MIDI files
>                 + 10.2.2 MIDI block
>                 + 10.2.3 MIDI instrument names
>           o 10.3 Displaying LilyPond notation
>           o 10.4 Skipping corrected music
>     * 11 Changing defaults
>
>
>
>
>
>
> _______________________________________________
> lilypond-user mailing list
> address@hidden
> http://lists.gnu.org/mailman/listinfo/lilypond-user
>
>