]> git.donarmstrong.com Git - lilypond.git/commit
Doc: Adjusted CG Policy on @lilypond[] variables
authorJames Lowe <james.lowe@datacore.com>
Tue, 26 Apr 2011 21:39:28 +0000 (22:39 +0100)
committerJames Lowe <james.lowe@datacore.com>
Tue, 3 May 2011 15:18:52 +0000 (16:18 +0100)
commita0112838d85cb2187e3b27f24f68f8f51fb90fea
tree61ece29168f31dafe954e82ced9d896eff7a9029
parentb7878ed5b1fe275110d39ff2f1d6bb6bc780b898
Doc: Adjusted CG Policy on @lilypond[] variables

As a reuslt of work on NR 3.2 Titles and Headers, it was necessary to
define some more explicit requirements for using the variables in the
@lilypond[ ... ] construct. Ssuch as removing staffsize
and page sizes within the actual @lilypond example which only add more noise
to the examples.

Also when the need to show taglines and/or page breaks and footers is required then
\book is needed in the example and this will result in unnecessary white space between top and bottom
of the page. So showing page breaking features or numbering examples becomes
problematic within the documentation.

The new @lilypond[papersize=X] variable allows for explicit page sizing without
the need to include it in the example itself. Allowing for better clarity.

The papersize=X takes variables from the scm/paper.scm else 'a4' is presumed.

Moved existing material to the front of this section so that it makes more sense
and added the new requirements for the various preferred variables.
Documentation/contributor/doc-work.itexi