From: Graham Percival Date: Tue, 23 May 2006 05:26:09 +0000 (+0000) Subject: Changes to fix pdf doc creation, and some minor doc additions. X-Git-Tag: release/2.9.6~12 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=9b79b0f4972f7ac809cdaddaa7c01ea549a781b4;p=lilypond.git Changes to fix pdf doc creation, and some minor doc additions. --- diff --git a/ChangeLog b/ChangeLog index 183f534720..c74e64cd2d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2006-05-23 Graham Percival + + * stepmake/stepmake/texinfo-rules.make: added -E, allows + pdf doc creation. + + * Documentation/user/ various: stuff that might have helped + to fix the pdf creation, plus some minor doc additions. + 2006-05-23 Han-Wen Nienhuys * lily/beaming-pattern.cc (beamify): deal with negative start diff --git a/Documentation/user/advanced-notation.itely b/Documentation/user/advanced-notation.itely index 5c667ea854..a3f5fdbc7c 100644 --- a/Documentation/user/advanced-notation.itely +++ b/Documentation/user/advanced-notation.itely @@ -2217,5 +2217,10 @@ event, >4-\parenthesize -. @end lilypond +This only functions inside chords, even for single notes + +@example +< \parenthesize NOTE> +@end example diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely index 58a5945ec8..e3c86964d9 100644 --- a/Documentation/user/changing-defaults.itely +++ b/Documentation/user/changing-defaults.itely @@ -1306,14 +1306,14 @@ flow of information within the program, following links like this: @item @internalsref{Fingering}: @internalsref{Fingering} objects are created by: -@b{@internalsref{Fingering_engraver}} +@b{ @internalsref{Fingering_engraver} } @item @internalsref{Fingering_engraver}: -Music types accepted: @b{@internalsref{fingering-event}} +Music types accepted: @b{ @internalsref{fingering-event} } @item @internalsref{fingering-event}: Music event type @code{fingering-event} is in Music expressions named -@b{@internalsref{FingerEvent}} +@b{ @internalsref{FingerEvent} } @end itemize This path goes against the flow of information in the program: it @@ -1500,7 +1500,7 @@ fact can also be deduced from the program reference, for the page for the @internalsref{Fingering_engraver} plug-in says @quotation -Fingering_engraver is part of contexts: @dots{} @b{@internalsref{Voice}} +Fingering_engraver is part of contexts: @dots{} @b{ @internalsref{Voice} } @end quotation diff --git a/Documentation/user/instrument-notation.itely b/Documentation/user/instrument-notation.itely index aa4085bdb3..519c2ba6ad 100644 --- a/Documentation/user/instrument-notation.itely +++ b/Documentation/user/instrument-notation.itely @@ -777,7 +777,8 @@ opening brace is not balanced \lyricmode @{ twinkle@} @end example -@funindex \property, in @code{\lyricmode +@funindex \property in \lyricmode + @noindent Similarly, a period which follows an alphabetic sequence is included in the resulting string. As a consequence, spaces must be inserted around @@ -805,9 +806,10 @@ non-ascii characters (such as the heart symbol or slanted quotes), simply insert the characters directly into the input file and save it with utf-8 encoding. See @ref{Text encoding} for more info. -@example -\lyricmode @{ He said: “Let my peo ple go”. @} -@end example +@lilypond[quote,ragged-right,fragment,verbatim] +\relative { e4 f e d e f e2 } +\addlyrics { He said: “Let my peo ple go”. } +@end lilypond To use normal quotes in lyrics, add a backslash before the quotes. For example, diff --git a/Documentation/user/invoking.itely b/Documentation/user/invoking.itely index 6e23569449..df1c72e9e4 100644 --- a/Documentation/user/invoking.itely +++ b/Documentation/user/invoking.itely @@ -535,7 +535,7 @@ that the bug can be reproduced in all paper sizes. @c the bug database is not up to date enough. When you've found a bug, have a look at our -@uref{http://@/lilypond@/.org/@/doc/@/v2.5/@/bugs/,bug database} to see if +@uref{http://@/lilypond@/.org/@/bugs/@/v2.8/@/,bug database} to see if it has already been reported. You could also try to do a few searches on the mailing list for the bug. Sometimes the bug will have already been reported and a fix or workaround is already known. diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index 52ba59228b..6bd484d72d 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -149,7 +149,7 @@ Notation Reference * Global issues:: What LilyPond produces. * Interfaces for programmers:: Expert usage. -Technical Details +Program usage * Running LilyPond:: Operation. * LilyPond-book:: Integrating text and music. @@ -191,8 +191,6 @@ Appendices @include converters.itely - - @include literature.itely @include scheme-tutorial.itely @include notation-appendices.itely @@ -200,7 +198,6 @@ Appendices @include cheatsheet.itely @include fdl.itexi - @node LilyPond command index @appendix LilyPond command index diff --git a/Documentation/user/macros.itexi b/Documentation/user/macros.itexi index 4227b8572b..68b52bb513 100644 --- a/Documentation/user/macros.itexi +++ b/Documentation/user/macros.itexi @@ -53,10 +53,10 @@ @c @inforef{\NAME\,,lilypond-internals}@c @c using @ref without punctuation is OK without for formats other than info -@macro internalsref{NAME}@c @c annoying parentheses stripped by add-html-footer.py -@ref{\NAME\,,,lilypond-internals}@c +@macro internalsref{NAME} @vindex \NAME\ +@ref{\NAME\,,,lilypond-internals} @end macro @c usage: @inputfileref{input@/regression,FILE@/-NAME.ly} @@ -64,10 +64,10 @@ @uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c @end macro -@macro rglos{NAME}@c @c annoying parentheses stripped by add-html-footer.py -@ref{\NAME\,,,music-glossary}@c +@macro rglos{NAME} @vindex \NAME\ +@ref{\NAME\,,,music-glossary} @end macro @end ifhtml @@ -77,17 +77,17 @@ @c ***** DOCBOOK-XML ***** @macro internalsref{NAME} -@ref{\NAME\,,,lilypond-internals}@c -@vindex @code{\NAME\} +@vindex \NAME\ +@ref{\NAME\,,,lilypond-internals} @end macro @macro inputfileref{DIR,NAME} -@uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c +@uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}} @end macro -@macro rglos{NAME}@c -@ref{\NAME\,,,music-glossary}@c +@macro rglos{NAME} @vindex \NAME\ +@ref{\NAME\,,,music-glossary} @end macro @end ifdocbook @@ -97,8 +97,8 @@ @c **** INFO **** @macro internalsref{NAME} -@inforef{\NAME\,,lilypond-internals}@c -@vindex \NAME\@c +@vindex \NAME\ +@inforef{\NAME\,,lilypond-internals} @end macro @macro inputfileref{DIR,NAME} @@ -106,12 +106,12 @@ @end macro @macro rglos{NAME}@c -@inforef{\NAME\,,,music-glossary}@c @vindex \NAME\ +@inforef{\NAME\,,,music-glossary} @end macro @macro usermanref{NAME} -@inforef{\NAME\}@c +@inforef{\NAME\} @end macro @end ifinfo @@ -120,18 +120,18 @@ @c **** TEX **** @iftex -@macro internalsref{NAME}@c -@vindex \NAME\ @c -@code{\NAME\}@c +@macro internalsref{NAME} +@vindex \NAME\ +@code{\NAME\} @end macro -@macro inputfileref{DIR,NAME}@c -@file{\DIR\/@/\NAME\}@c +@macro inputfileref{DIR,NAME} +@file{\DIR\/@/\NAME\} @end macro @macro rglos {NAME} -@vindex \NAME\ @c -@code{\NAME\}@c +@vindex \NAME\ +@code{\NAME\} @end macro @macro seeinternals{NAME} @@ -153,13 +153,15 @@ user manual, @internalsref{\NAME\} @ifnotinfo @macro usermanref{NAME} -@ref{\NAME\}@c +@ref{\NAME\} @end macro @end ifnotinfo @end ifnottex +@c **** ALL **** + @macro refbugs @noindent @subsubheading Bugs @@ -178,9 +180,9 @@ user manual, @internalsref{\NAME\} @end macro -@macro context{NAME}@c +@macro context{NAME} +@vindex \NAME\ @code{\NAME\}@c should use internalsref -@vindex \NAME\@c @end macro @macro refcommand{WHAT} diff --git a/Documentation/user/tweaks.itely b/Documentation/user/tweaks.itely index 495c2a381a..8224f4eef2 100644 --- a/Documentation/user/tweaks.itely +++ b/Documentation/user/tweaks.itely @@ -126,7 +126,6 @@ c4^"piu mosso" d e f c4^"piu mosso" d e f @end lilypond - @seealso This manual: @ref{The \override command}, @ref{Common tweaks}. @@ -189,8 +188,10 @@ used to apply generic tweaks. @itemize @bullet -@funindex padding -@item The @code{padding} property can be set to increase +@cindex padding + +@item +The @code{padding} property can be set to increase (or decrease) the distance between symbols that are printed above or below notes. This applies to all objects with @code{side-position-interface}. @@ -218,8 +219,10 @@ is handled in the @code{Score} context, property changes in the @code{Voice} context will not be noticed. For more details, see @ref{Constructing a tweak}. -@funindex extra-offset -@item The @code{extra-offset} property moves objects around +@cindex extra-offset + +@item +The @code{extra-offset} property moves objects around in the output; it requires a pair of numbers. The first number controls horizontal movement; a positive number will move the object to the right. The second number controls vertical @@ -238,7 +241,7 @@ f-5 f-5 @end lilypond -@item + @item Setting the @code{transparent} property will cause an object to be printed in `invisible ink': the object is not printed, but all its other behavior is retained. The object still takes up space, it takes part in diff --git a/stepmake/stepmake/texinfo-rules.make b/stepmake/stepmake/texinfo-rules.make index 3f0432b2e1..94bff9f874 100644 --- a/stepmake/stepmake/texinfo-rules.make +++ b/stepmake/stepmake/texinfo-rules.make @@ -22,7 +22,7 @@ $(outdir)/%/%.html: $(outdir)/%.texi $(outdir)/%.dvi: $(outdir)/%.texi - cd $(outdir); texi2dvi --batch $(TEXINFO_PAPERSIZE_OPTION) $(