Doc: Appendix - Articulations and Ornamentation - part 2

Doc: Appendix - Articulations and Ornamentation - part 2
    
    Issue 1189
    
    Create Texifo @multitable entries for the
    List of Articulations appendix.
    
    As there are a lot of separate scripts being
    documented this Issue is going to be split
    into multiple, smaller, parts to aid in the
    review process. Part 1 was commit 8553021
    
    This is part 2 and covers 'Fermata', 'Instrument
    specific', 'Repeat signs' and 'Ancient' scripts.
    
    Also, after more consideration, a third example
    of each script has been added to show the
    explicit differences between the up/down/neutral
    positions. Not every script has a different
    up/down glyph nor is positioned up/down when
    placed on a note that is either top or bottom of
    the Staff without explicit positioning. So this,
    I hope just clarifies things (regardless whether
    the position is musically 'correct' notation).
    
    I have also sey the @code{} script examples into
    the same column as the @lilypond examples; saving
    a significant of wasted page space. Also I have
    removed unnecessary lilypond-book variables making
    the texinfo code less noisy.

[pkx166h, 2014-07-16 12:58:30]

Changed from 5 to 4 column @multitable entries to see if this allows make doc

[dak, 2014-07-16 13:09:55]

https://codereview.appspot.com/114840043/diff/1/Documentation/notation/notati...
File Documentation/notation/notation-appendices.itely (right):

https://codereview.appspot.com/114840043/diff/1/Documentation/notation/notati...
Documentation/notation/notation-appendices.itely:1547: @multitable
@columnfractions .20 .20 .20 .20 .20
No @headitem?

https://codereview.appspot.com/114840043/diff/1/Documentation/notation/notati...
Documentation/notation/notation-appendices.itely:1606: @multitable
@columnfractions .20 .20 .20 .20
Missing the fifth .20 here, no?

https://codereview.appspot.com/114840043/diff/1/Documentation/notation/notati...
Documentation/notation/notation-appendices.itely:1691: @multitable
@columnfractions .20 .20 .20 .20
Same here?

https://codereview.appspot.com/114840043/diff/1/Documentation/notation/notati...
Documentation/notation/notation-appendices.itely:1800: @multitable
@columnfractions .20 .20 .20 .20
I count only 3 columns now, but that should not be a problem  But wants to be
five eventually?

[pkx166h, 2014-07-20 12:18:48]

Added third example in each case so as to use up/down/neutral positions.
Corrected some previous inconsistencies in the previous iteration of this patch
compared to the

[pkx166h, 2014-07-20 12:23:09]

Thanks David for the review, I have also edited the commit message.

https://codereview.appspot.com/114840043/diff/1/Documentation/notation/notati...
File Documentation/notation/notation-appendices.itely (right):

https://codereview.appspot.com/114840043/diff/1/Documentation/notation/notati...
Documentation/notation/notation-appendices.itely:1547: @multitable
@columnfractions .20 .20 .20 .20 .20
On 2014/07/16 13:09:55, dak wrote:
> No @headitem?

Because I moved everything for each script into a single column it made having
headers redundant.

https://codereview.appspot.com/114840043/diff/1/Documentation/notation/notati...
Documentation/notation/notation-appendices.itely:1606: @multitable
@columnfractions .20 .20 .20 .20
On 2014/07/16 13:09:55, dak wrote:
> Missing the fifth .20 here, no?

I could see my inconsistecy in my last iteration of this patch. Make doc
complained when I used 5 columns but lilypond-book on its own didn't. However as
I have now added a third example for each script
having 5 columns makes it all look too squashed together so I have gone
back to 4 columns.

https://codereview.appspot.com/114840043/diff/1/Documentation/notation/notati...
Documentation/notation/notation-appendices.itely:1691: @multitable
@columnfractions .20 .20 .20 .20
On 2014/07/16 13:09:55, dak wrote:
> Same here?

See above.

https://codereview.appspot.com/114840043/diff/1/Documentation/notation/notati...
Documentation/notation/notation-appendices.itely:1800: @multitable
@columnfractions .20 .20 .20 .20
On 2014/07/16 13:09:55, dak wrote:
> I count only 3 columns now, but that should not be a problem  But wants to be
> five eventually?

Again See above.

[pkx166h, 2014-07-20 12:26:45]

ugh.. missed the @multitable settings between copying/pasting on my scratch
lilypond-book file to test the layouts. Which explains the last set of
inconsistencies

[pkx166h, 2014-07-20 12:33:13]

Added remaining tables upto but not including Percussion. That will be handled
in a separate patch.

[pkx166h, 2014-07-20 14:26:08]

You can download a 2 page PDF showing just the lilypond-book output from here:

https://www.hightail.com/download/ZUcyak96Y1NCSWNkVU1UQw

[Mark Polesky, 2014-07-24 20:22:39]

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
File Documentation/notation/notation-appendices.itely (right):

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1513: attached to notes (eg.
@samp{f\accent}).  Each example shows the script
(eg. @samp{f\accent} or @samp{f->}).

(see comments below)

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1558: @code{\accent}
It would make sense to also include the shortcuts here too.  One of these should
work, I think:

@item
@code{\accent}
@code{->}

@item @code{\accent}
@itemx @code{->}

@item
@code{\accent}@*@code{->}

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1568: @code{\marcato}
@code{-^}

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1573: @code{\portato}
@code{-_}

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1579: @code{\staccatissimo}
@code{-!}

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1584: @code{\staccato}
@code{-.}

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1589: @code{\tenuto}
@code{--}

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1795: @code{\stopped}
@code{-+}

[pkx166h, 2014-07-25 17:33:05]

Mark P's suggestion about adding shorttcuts

[pkx166h, 2014-07-25 17:34:56]

Thanks Mark. Note I went with @code{} or @code{} and have had to include a
forced break for \stacatissimo as the automatic linebreak looked awkward.

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
File Documentation/notation/notation-appendices.itely (right):

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1513: attached to notes (eg.
@samp{f\accent}).  Each example shows the script
On 2014/07/24 20:22:38, Mark Polesky wrote:
> (eg. @samp{f\accent} or @samp{f->}).
> 
> (see comments below)

Done.

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1558: @code{\accent}
On 2014/07/24 20:22:38, Mark Polesky wrote:
> It would make sense to also include the shortcuts here too.  One of these
should
> work, I think:
> 
> @item
> @code{\accent}
> @code{->}
> 
> @item @code{\accent}
> @itemx @code{->}
> 
> @item
> @code{\accent}@*@code{->}

Done.

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1568: @code{\marcato}
On 2014/07/24 20:22:38, Mark Polesky wrote:
> @code{-^}

Done.

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1573: @code{\portato}
On 2014/07/24 20:22:38, Mark Polesky wrote:
> @code{-_}

Done.

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1579: @code{\staccatissimo}
On 2014/07/24 20:22:38, Mark Polesky wrote:
> @code{-!}

Done.

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1584: @code{\staccato}
On 2014/07/24 20:22:38, Mark Polesky wrote:
> @code{-.}

Done.

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1589: @code{\tenuto}
On 2014/07/24 20:22:38, Mark Polesky wrote:
> @code{--}

Done.

https://codereview.appspot.com/114840043/diff/80001/Documentation/notation/no...
Documentation/notation/notation-appendices.itely:1795: @code{\stopped}
On 2014/07/24 20:22:38, Mark Polesky wrote:
> @code{-+}

Done.

[pkx166h, 2014-07-31 21:26:36]

author	James Lowe <pkx166h@gmail.com>	
	Tue, 15 Jul 2014 21:21:10 +0000 (22:21 +0100)
committer	James Lowe <pkx166h@gmail.com>	
	Thu, 31 Jul 2014 21:24:43 +0000 (22:24 +0100)
commit	4d6f2a27cc17261bc0970327de8665a6b771734b