Doc: Removed [fragment] from @lilypond examples NR

Doc: fixes for previous patch.


Doc: Removed [fragment] from @lilypond examples NR

Where appropriate replaced with [relative] or added { } construct within
@lilypond example

All except ancient.itely have been amended because some ancient music
examples gave unexpected results.

[Graham Percival (old account), 2010-10-31 11:16:04]

Docs look ok, but I'm not 100% certain about the changes to chords, or whether
Trevor wants us changing vocal.itely.

(this is a git-cl-merge of James Lowe's initial doc patch, and a few fixes I
applied to that one; I don't think it's worth separating this into two separate
patch-sets, but if you want, I could do that)

[Carl, 2010-10-31 13:54:01]

I've only reviewed the chords section, since Graham was unsure about it.

I think that it most cases, there should be no \relative in these sections.

Thanks,

Carl

http://codereview.appspot.com/2810041/diff/1/Documentation/notation/chords.itely
File Documentation/notation/chords.itely (right):

http://codereview.appspot.com/2810041/diff/1/Documentation/notation/chords.it...
Documentation/notation/chords.itely:140:
@lilypond[quote,ragged-right,verbatim,relative=1]
I don't think any of these \chordmode examples should use relative, even though
it's there in some of the previous file.

We don't need to surround \chordmode with \relative.  In fact, as the
documentation says, all pitches in \chordmode are interpreted as absolute.  I've
tested this, just to make sure.

I guess it doesn't hurt to have it this way, as the code compiles.  But I would
question manual code that had \chordmode surrounded with \relative, so I think
it would be best to omit the \relative.

http://codereview.appspot.com/2810041/diff/1/Documentation/notation/chords.it...
Documentation/notation/chords.itely:814:
@lilypond[verbatim,quote,ragged-right,relative=1]
Figures also ignore octaves (in fact, the octave makes no sense to a figure), so
please eliminate the relative here, as well.

I think the relative should only be included with figures:

1.  When there are notes, and
2.  When we want the notes in relative mode.

I don't think there are any examples like this in this section.

[Graham Percival (old account), 2010-10-31 14:11:50]

On 2010/10/31 13:54:01, Carl wrote:
> I think the relative should only be included with figures:
> 
> 1.  When there are notes, and
> 2.  When we want the notes in relative mode.

Ok, I've removed all [relative=?] unless there's a combination of notes with
\chordmode or \figures.  Will upload once the docs finished compiling from
scratch.

[Trevor Daniels, 2010-11-01 18:35:14]

I'm happy with the changes to vocal.itely, although ragged-right could also be
removed in many (maybe all) of the @lilyponds.

Trevor

[Graham Percival (old account), 2010-11-02 19:48:52]

On 2010/11/01 18:35:14, Trevor Daniels wrote:
> I'm happy with the changes to vocal.itely, although ragged-right could also be
> removed in many (maybe all) of the @lilyponds.

Aye, [ragged-right] should be removed from (almost?) all @lilypond.  But this
patch is too big already.

Thanks, pushed.

Cheers,
- Graham