sections done

[Graham Percival]

Ok, I think we've reached the point of diminishing returns.  The latest 
sectioning is pretty solid.  There will still be a few problems, but 
we'll tackle those when we investigate each section individually.  I 
don't think it's worth holding up the main part of GDP any more.

John, could you do the following:
- make a new branch in git   ( doc/gdp ?  whatever the appropriate name 
would be)    (I tried to remove the doc-experimental, but I'm not 
certain if it actually worked or not.  If it's still there, please kill it)
- split the Learning manual away from the main manual (just like Program 
usage).  For now, take all of chapters 1-5.
- point the "tutorial" link in Documentation/index.html.in  to the table 
of contents of the Learning Manual.
- make a directory Documentation/user/notation/
- split up basic-notation, instrument-specific, and advanced-notation 
into section files inside notation.  ie
   ./notation/pitches.itely
   ./notation/rhythms.itely
   ./notation/expressive.itely

Having one .itely file for the whole thing would be too awkward.  We 
could invisibly keep stuff split up into basic- and instrument- , but 
that's also awkward.  Plus, having the files split up this way will make 
it much easier to coordinate with the trivial/easy helpers.

- I really wish I could do some of these steps.  Are you sure that it's 
easier for you in the long term (ie not screwing up Translations) if you 
do this all yourself?  :(


I'll start preparing guidelines for the trivial/easy helpers.  BTW, if 
anybody has a snazzy name for them, I'd love to hear it.  I feel as 
though I'm insulting them every time I write "trivial/easy", and that's 
the _last_ thing I want to do.  :)


Here's my current sections.  Let me know when you plan on doing the 
actual rearrangement, just in case somebody sends an absolutely 
compelling rearrangement proposal in the next $foo hours.

    * 1 Musical notation
          o 1.1 Pitches
                1.1.1 Writing pitches
                    + Normal pitches
                    + Accidentals
                    + Cautionary accidentals
                    + Micro tones
                    + Note names in other languages
                1.1.2 Changing multiple pitches
                    + Relative octaves
                    + Octave check
                    + Transpose
                1.1.3 Displaying pitches
                    + Clef
                    + Key signature
                    + Ottava brackets
                    + Instrument transpositions
          o 1.2 Rhythms
                1.2.1 Writing rhythms
                    + Durations
                    + Augmentation dots
                    + Tuplets
                    + Scaling durations
                1.2.2 Writing rests
                    + Rests
                    + Skips
                    + Multi measure rests
                1.2.3 Displaying rhythms
                    + Time signature
                    + Upbeats
                    + Unmetered music
                    + Polymetric notation
                    + Automatic note splitting
                1.2.4 Beams
                    + Automatic beams
                    + Manual beams
                    + Feathered beams
                1.2.5 Bars
                    + Bar check
                    + Bar lines
                    + Bar numbers
                    + Barnumber check
                    + Rehearsal marks
                1.2.6 Special rhythmic concerns
                    + Grace notes
                    + Aligning to cadenzas
                    + Time administration
                    + Proportional notation (introduction)
          o 1.3 Expressive marks
                1.3.1 Attached to notes
                    + Articulations
                    + Dynamics
                1.3.2 Curves
                    + Ties
                    + Slurs
                    + Phrasing slurs
                    + Laissez vibrer ties
                    + Breath marks
                    + Falls and doits
                1.3.3 Lines
                    + Glissando
                    + Analysis brackets
                    + Arpeggio
                    + Trills
          o 1.4 Repeats
                1.4.1 Writing repeats
                    + Repeat types
                    + Repeat syntax
                    + Manual repeat commands
                    + Repeats and MIDI
                1.4.2 Other repeats
                    + Tremolo repeats
                    + Tremolo subdivisions
                    + Measure repeats
          o 1.5 Polyphony
                1.5.1 Single voice
                    + Chords
                    + Clusters
                1.5.2 Multiple voices
                    + Basic polyphony
                    + Explicitly instantiating voices
                    + Collision resolution
                    + Automatic part combining
                    + Writing music in parallel
          o 1.6 Staff notation
                1.6.1 Displaying staves
                    + System start delimiters
                    + Staff symbol
                    + Hiding staves
                1.6.2 Writing parts
                    + Metronome marks
                    + Instrument names
                    + Quoting other voices
                    + Formatting cue notes
          o 1.7 Educational use   (or "increasing readibility" ?)
                1.7.1 Note heads
                    + Easy Notation note heads
                    + Shape note heads
                    + Improvisation
                    + Special noteheads
                1.7.2 Inside the staff
                    + Selecting notation font size
                    + Fingering instructions
                    + Hidden notes
                    + Coloring objects
                    + Parentheses
                    + Ambitus
                    + Stems
                1.7.3 Outside the staff
                    + Balloon help
                    + Grid lines
                    + Blank music sheet
          o 1.8 Text
                1.8.1 Writing text
                    + Text scripts
                    + Text and line spanners
                    + Text spanners
                    + Text marks
                    + New dynamic marks
                1.8.2 Text markup
                    + Text markup
                    + Nested scores
                    + Page wrapping text
                    + Font selection
          o 1.9 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.9 Other vocal issues
          o 1.10 Chord names
                + Introducing chord names
                + Chords mode
                + Printing chord names
                + Figured bass
          o 1.11 Piano music
                + Pedals
                + Automatic staff changes
                + Manual staff switches
                + Staff switch lines
                + Cross staff stems
          o 1.12 Percussion
                + 8.3.1 Showing melody rhythms
                + 8.3.2 Entering percussion
                + 8.3.3 Percussion staves
                + 8.3.4 Ghost notes
          o 1.13 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 1.14 Other instrument-specific
                + 8.6.1 Artificial harmonics (strings)
                + 8.5.1 Bagpipe definitions
                + 8.5.2 Bagpipe example
          o 1.15 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

Overview of text markup commands => appendix