From 7205cabda0f3ab0918657796413c082c30b0fa08 Mon Sep 17 00:00:00 2001 From: John Mandereau Date: Thu, 14 Aug 2008 16:32:34 +0200 Subject: [PATCH] Rename nodes and start "Tweaking output" proofreading - get rid of backslashes in node names, - rename "Objects connected to the input" to "The @code{\tweak} command", - start "Tweaking output" proofreading: only formatting nits so far. --- Documentation/de/user/changing-defaults.itely | 98 ++++++++--------- Documentation/es/user/changing-defaults.itely | 20 ++-- Documentation/es/user/editorial.itely | 8 +- Documentation/es/user/rhythms.itely | 2 +- Documentation/es/user/tweaks.itely | 2 +- Documentation/fr/user/changing-defaults.itely | 18 +-- Documentation/fr/user/editorial.itely | 2 +- Documentation/user/changing-defaults.itely | 104 +++++++++--------- Documentation/user/chords.itely | 6 +- Documentation/user/editorial.itely | 6 +- Documentation/user/rhythms.itely | 2 +- Documentation/user/tweaks.itely | 84 +++++++------- 12 files changed, 177 insertions(+), 175 deletions(-) diff --git a/Documentation/de/user/changing-defaults.itely b/Documentation/de/user/changing-defaults.itely index 9a4b13c96b..dba72b917c 100644 --- a/Documentation/de/user/changing-defaults.itely +++ b/Documentation/de/user/changing-defaults.itely @@ -17,13 +17,13 @@ UNTRANSLATED NODE: IGNORE ME @menu -* Interpretation contexts:: -* Explaining the Internals Reference:: -* Modifying properties:: -* Useful concepts and properties:: -* Common properties:: -* Advanced tweaks:: -* Discussion of specific tweaks:: +* Interpretation contexts:: +* Explaining the Internals Reference:: +* Modifying properties:: +* Useful concepts and properties:: +* Common properties:: +* Advanced tweaks:: +* Discussion of specific tweaks:: @end menu @node Interpretation contexts @@ -35,12 +35,12 @@ UNTRANSLATED NODE: IGNORE ME @menu -* Contexts explained:: -* Creating contexts:: -* Modifying context plug-ins:: -* Changing context default settings:: -* Defining new contexts:: -* Aligning contexts:: +* Contexts explained:: +* Creating contexts:: +* Modifying context plug-ins:: +* Changing context default settings:: +* Defining new contexts:: +* Aligning contexts:: @end menu @node Contexts explained @@ -52,10 +52,10 @@ UNTRANSLATED NODE: IGNORE ME @menu -* Score - the master of all contexts:: -* Top-level contexts - staff containers:: -* Intermediate-level contexts - staves:: -* Bottom-level contexts - voices:: +* Score - the master of all contexts:: +* Top-level contexts - staff containers:: +* Intermediate-level contexts - staves:: +* Bottom-level contexts - voices:: @end menu @node Score - the master of all contexts @@ -139,10 +139,10 @@ UNTRANSLATED NODE: IGNORE ME @menu -* Navigating the program reference:: -* Layout interfaces:: -* Determining the grob property:: -* Naming conventions:: +* Navigating the program reference:: +* Layout interfaces:: +* Determining the grob property:: +* Naming conventions:: @end menu @node Navigating the program reference @@ -186,11 +186,11 @@ UNTRANSLATED NODE: IGNORE ME @menu -* Overview of modifying properties:: -* The \set command:: -* The \override command:: -* \set versus \override:: -* Objects connected to the input:: +* Overview of modifying properties:: +* The set command:: +* The override command:: +* set versus override:: +* The tweak command:: @end menu @node Overview of modifying properties @@ -201,7 +201,7 @@ UNTRANSLATED NODE: IGNORE ME @end ifhtml -@node The \set command +@node The set command @subsection The @code{\set} command @ifhtml @@ -209,7 +209,7 @@ UNTRANSLATED NODE: IGNORE ME @end ifhtml -@node The \override command +@node The override command @subsection The @code{\override} command @ifhtml @@ -217,7 +217,7 @@ UNTRANSLATED NODE: IGNORE ME @end ifhtml -@node \set versus \override +@node set versus override @subsection @code{\set} vs. @code{\override} @ifhtml @@ -225,8 +225,8 @@ UNTRANSLATED NODE: IGNORE ME @end ifhtml -@node Objects connected to the input -@subsection Objects connected to the input +@node The tweak command +@subsection The @code{\tweak} command @ifhtml UNTRANSLATED NODE: IGNORE ME @@ -242,10 +242,10 @@ UNTRANSLATED NODE: IGNORE ME @menu -* Input modes:: -* Direction and placement:: -* Distances and measurements:: -* Spanners:: +* Input modes:: +* Direction and placement:: +* Distances and measurements:: +* Spanners:: @end menu @node Input modes @@ -289,10 +289,10 @@ UNTRANSLATED NODE: IGNORE ME @menu -* Controlling visibility of objects:: -* Line styles:: -* Rotating objects:: -* Aligning objects:: +* Controlling visibility of objects:: +* Line styles:: +* Rotating objects:: +* Aligning objects:: @end menu @node Controlling visibility of objects @@ -304,11 +304,11 @@ UNTRANSLATED NODE: IGNORE ME @menu -* Removing the stencil:: -* Making objects transparent:: -* Painting objects white:: -* Using break-visibility:: -* Special considerations:: +* Removing the stencil:: +* Making objects transparent:: +* Painting objects white:: +* Using break-visibility:: +* Special considerations:: @end menu @node Removing the stencil @@ -384,10 +384,10 @@ UNTRANSLATED NODE: IGNORE ME @menu -* Vertical grouping of grobs:: -* Modifying ends of spanners:: -* Modifying stencils:: -* Modifying shapes:: +* Vertical grouping of grobs:: +* Modifying ends of spanners:: +* Modifying stencils:: +* Modifying shapes:: @end menu @node Vertical grouping of grobs @@ -431,7 +431,7 @@ UNTRANSLATED NODE: IGNORE ME @menu -* old Contexts explained:: +* old Contexts explained:: @end menu @node old Contexts explained diff --git a/Documentation/es/user/changing-defaults.itely b/Documentation/es/user/changing-defaults.itely index dbc9397137..0e59a7021c 100644 --- a/Documentation/es/user/changing-defaults.itely +++ b/Documentation/es/user/changing-defaults.itely @@ -423,7 +423,7 @@ compás independiente. @node Changing context default settings @subsection Changing context default settings -Los ajustes de las secciones previas ( @ref{The \set command}, +Los ajustes de las secciones previas ( @ref{The set command}, @ref{Modifying context plug-ins} y @ref{Overview of modifying properties}) también se pueden escribir separados de la música dentro del bloque @code{\layout}: @@ -967,10 +967,10 @@ UNTRANSLATED NODE: IGNORE ME @menu * Overview of modifying properties:: -* The \set command:: -* The \override command:: -* \set versus \override:: -* Objects connected to the input:: +* The set command:: +* The override command:: +* set versus override:: +* The tweak command:: @end menu @@ -1097,7 +1097,7 @@ valores Scheme de propiedades pueden producir cuelgues o salidas abruptas, o las dos cosas. -@node The \set command +@node The set command @subsection The @code{\set} command @cindex propiedades @@ -1228,7 +1228,7 @@ usuario. -@node The \override command +@node The override command @subsection The @code{\override} command Las instrucciones que modifican la salida tienen por lo general un @@ -1273,7 +1273,7 @@ causarína problemas. Mostraremos a continuación cómo localizar esta información en el manual de notación y en la referencia de funcionamiento interno. -@node \set versus \override +@node set versus override @subsection @code{\set} vs. @code{\override} Hemos visto dos formas de cambiar las propiedades: @code{\set} y @@ -1326,8 +1326,8 @@ Al ser éste un cambio muy común, se creó la propiedad especial (modificada con @code{\set}). -@node Objects connected to the input -@subsection Objects connected to the input +@node The tweak command +@subsection The @code{\tweak} command @funindex \tweak diff --git a/Documentation/es/user/editorial.itely b/Documentation/es/user/editorial.itely index ccc485a6c2..4a6a568155 100644 --- a/Documentation/es/user/editorial.itely +++ b/Documentation/es/user/editorial.itely @@ -305,8 +305,8 @@ gis4 a @seealso Referencia de la notación: -@ref{List of colors}, @ref{Objects connected to -the input}. +@ref{List of colors}, @ref{The +tweak command}. Fragmentos de código: @rlsr{Editorial annotations}. @@ -324,8 +324,8 @@ sea: @code{#blue}, azul, @code{#green}, verde, @code{#red}, rojo). Las notas de un acorde no se pueden colorear con @code{\override}; en -su lugar utilice @code{\tweak}. Consulte @ref{Objects connected to -the input} para ver más detalles. +su lugar utilice @code{\tweak}. Consulte @ref{The +tweak command} para ver más detalles. @node Parentheses diff --git a/Documentation/es/user/rhythms.itely b/Documentation/es/user/rhythms.itely index fce14fa01c..cd85c3465b 100644 --- a/Documentation/es/user/rhythms.itely +++ b/Documentation/es/user/rhythms.itely @@ -255,7 +255,7 @@ Manual de aprendizaje: Referencia de la notación: @ref{Time administration}, @ref{Scaling durations}, -@ref{Objects connected to the input}, +@ref{The tweak command}, @ref{Polymetric notation}. Fragmentos de código: diff --git a/Documentation/es/user/tweaks.itely b/Documentation/es/user/tweaks.itely index 93a8731623..8db1ef5cf7 100644 --- a/Documentation/es/user/tweaks.itely +++ b/Documentation/es/user/tweaks.itely @@ -384,7 +384,7 @@ tresillo corto. @end lilypond Encontrará más detalles de la instrucción @code{\tweak} en -@ruser{Objects connected to the input}. +@ruser{The tweak command}. Si los grupos anidados no comienzan en el mismo momento, su apariencia se puede modificar de la forma usual mediante instrucciones diff --git a/Documentation/fr/user/changing-defaults.itely b/Documentation/fr/user/changing-defaults.itely index 5606cb51d4..ad0cf4ef0b 100644 --- a/Documentation/fr/user/changing-defaults.itely +++ b/Documentation/fr/user/changing-defaults.itely @@ -72,7 +72,7 @@ des listes, des chaînes de caractères ou des symboles, en Scheme.} @menu * Automatic notation:: * Interpretation contexts:: -* The \override command:: +* The override command:: @end menu @@ -921,7 +921,7 @@ de la partition, mais chaque contexte @context{Staff}, @context{Lyrics}, etc. possède son propre @code{VerticalAxisGroup}. -@node The \override command +@node The override command @section The @code{\override} command La commande @code{\override} permet de modifier la mise en page @@ -940,9 +940,9 @@ La propriété @var{propriété} de l'objet @var{objet}, appartenant au contexte * Navigating the program reference:: * Layout interfaces:: * Determining the grob property:: -* Objects connected to the input:: -* Using Scheme code instead of \tweak:: -* \set versus \override:: +* The tweak command:: +* Using Scheme code instead of tweak:: +* set versus override:: * Difficult tweaks:: @end menu @@ -1317,8 +1317,8 @@ Le graveur Fingering_engraver fait partie des contextes : @dots{} @rinternals{Vo @end quotation -@node Objects connected to the input -@subsection Objects connected to the input +@node The tweak command +@subsection The @code{\tweak} command @funindex \tweak @@ -1367,7 +1367,7 @@ pas directement rendue ; c'est pourquoi le code suivant ne sera d'aucun effet : Voir pour plus de détails @ref{Displaying music expressions}. -@node Using Scheme code instead of \tweak +@node Using Scheme code instead of tweak @subsection Using Scheme code instead of @code{\tweak} L'inconvénient principal de la commande @code{\tweak} est la rigidité de sa @@ -1413,7 +1413,7 @@ Le dernier élément, dans ce bloc @code{let}, est la valeur finale de @samp{m} lui-même. -@node \set versus \override +@node set versus override @subsection @code{\set} vs. @code{\override} Si les propriétés peuvent être modifiées de deux façons, par les commandes diff --git a/Documentation/fr/user/editorial.itely b/Documentation/fr/user/editorial.itely index 4236c4547d..60f4e85fd7 100644 --- a/Documentation/fr/user/editorial.itely +++ b/Documentation/fr/user/editorial.itely @@ -261,7 +261,7 @@ normale ayant un nom similaire. Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec @code{\override}. si besoin est, utilisez @code{\tweak}. -Pour plus de détails, consultez @ref{Objects connected to the input}. +Pour plus de détails, consultez @ref{The tweak command}. @node Parentheses diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely index 719e0fb898..0650193c30 100644 --- a/Documentation/user/changing-defaults.itely +++ b/Documentation/user/changing-defaults.itely @@ -73,13 +73,13 @@ on entering numbers, lists, strings, and symbols in Scheme.} @menu -* Interpretation contexts:: -* Explaining the Internals Reference:: -* Modifying properties:: -* Useful concepts and properties:: -* Common properties:: -* Advanced tweaks:: -* Discussion of specific tweaks:: +* Interpretation contexts:: +* Explaining the Internals Reference:: +* Modifying properties:: +* Useful concepts and properties:: +* Common properties:: +* Advanced tweaks:: +* Discussion of specific tweaks:: @end menu @@ -89,12 +89,12 @@ on entering numbers, lists, strings, and symbols in Scheme.} This section describes what contexts are, and how to modify them. @menu -* Contexts explained:: -* Creating contexts:: -* Modifying context plug-ins:: -* Changing context default settings:: -* Defining new contexts:: -* Aligning contexts:: +* Contexts explained:: +* Creating contexts:: +* Modifying context plug-ins:: +* Changing context default settings:: +* Defining new contexts:: +* Aligning contexts:: @end menu @@ -127,10 +127,10 @@ further explanation and with links to the IR. Contexts are arranged heirarchically: @menu -* Score - the master of all contexts:: -* Top-level contexts - staff containers:: -* Intermediate-level contexts - staves:: -* Bottom-level contexts - voices:: +* Score - the master of all contexts:: +* Top-level contexts - staff containers:: +* Intermediate-level contexts - staves:: +* Bottom-level contexts - voices:: @end menu @node Score - the master of all contexts @@ -540,7 +540,7 @@ time signature. @subsection Changing context default settings The adjustments of the previous subsections ( -@ref{The \set command}, @ref{Modifying context plug-ins}, and +@ref{The set command}, @ref{Modifying context plug-ins}, and @ref{Overview of modifying properties}) can also be entered separately from the music in the @code{\layout} block, @@ -803,10 +803,10 @@ ossia = { f4 f f f } @menu -* Navigating the program reference:: -* Layout interfaces:: -* Determining the grob property:: -* Naming conventions:: +* Navigating the program reference:: +* Layout interfaces:: +* Determining the grob property:: +* Naming conventions:: @end menu @node Navigating the program reference @@ -1124,11 +1124,11 @@ LP-specific? @section Modifying properties @menu -* Overview of modifying properties:: -* The \set command:: -* The \override command:: -* \set versus \override:: -* Objects connected to the input:: +* Overview of modifying properties:: +* The set command:: +* The override command:: +* set versus override:: +* The tweak command:: @end menu @@ -1246,7 +1246,7 @@ or crashes, or both. -@node The \set command +@node The set command @subsection The @code{\set} command @cindex properties @@ -1371,7 +1371,7 @@ Translation @expansion{} Tunable context properties. -@node The \override command +@node The override command @subsection The @code{\override} command Commands which change output generally look like @@ -1413,7 +1413,7 @@ We demonstrate how to glean this information from the notation manual and the program reference. -@node \set versus \override +@node set versus override @subsection @code{\set} vs. @code{\override} We have seen two methods of changing properties: @code{\set} and @@ -1464,8 +1464,8 @@ objects. Since this is a common change, the special property (modified with @code{\set}) was created. -@node Objects connected to the input -@subsection Objects connected to the input +@node The tweak command +@subsection The @code{\tweak} command TODO: can't use \tweak in a variable @@ -1518,10 +1518,10 @@ details. @menu -* Input modes:: -* Direction and placement:: -* Distances and measurements:: -* Spanners:: +* Input modes:: +* Direction and placement:: +* Distances and measurements:: +* Spanners:: @end menu @node Input modes @@ -1737,10 +1737,10 @@ restricted to a sub-set of the spanners. @section Common properties @menu -* Controlling visibility of objects:: -* Line styles:: -* Rotating objects:: -* Aligning objects:: +* Controlling visibility of objects:: +* Line styles:: +* Rotating objects:: +* Aligning objects:: @end menu @c TODO Add new subsection Shapes of objects @@ -1768,11 +1768,11 @@ certain layout objects. These are covered under Special considerations. @menu -* Removing the stencil:: -* Making objects transparent:: -* Painting objects white:: -* Using break-visibility:: -* Special considerations:: +* Removing the stencil:: +* Making objects transparent:: +* Painting objects white:: +* Using break-visibility:: +* Special considerations:: @end menu @@ -2256,8 +2256,8 @@ Both layout objects and elements of markup text can be rotated by any angle about any point, but the method of doing so differs. @menu -* Rotating layout objects:: -* Rotating markup:: +* Rotating layout objects:: +* Rotating markup:: @end menu @node Rotating layout objects @@ -2322,10 +2322,10 @@ fis^\markup { \rotate #30 "an F-Sharp" } @section Advanced tweaks @menu -* Vertical grouping of grobs:: -* Modifying ends of spanners:: -* Modifying stencils:: -* Modifying shapes:: +* Vertical grouping of grobs:: +* Modifying ends of spanners:: +* Modifying stencils:: +* Modifying shapes:: @end menu @@ -2364,7 +2364,7 @@ VerticalAxisGroup. @section Discussion of specific tweaks @menu -* old Contexts explained:: +* old Contexts explained:: @end menu diff --git a/Documentation/user/chords.itely b/Documentation/user/chords.itely index df34a18956..7cfba369cd 100644 --- a/Documentation/user/chords.itely +++ b/Documentation/user/chords.itely @@ -725,7 +725,7 @@ example, the vertical spacing of the figures may be set with @seealso Music Glossary: -@rglos{Figured Bass}. +@rglos{figured bass}. Snippets: @rlsr{Chords} @@ -915,7 +915,7 @@ End of continuation line @c @rlearning{}. @c Notation Reference: -@c @ruser{}. +@c @ref{}. @c Application Usage: @c @rprogram{}. @@ -1022,7 +1022,7 @@ or below the staff. @c @rlearning{}. @c Notation Reference: -@c @ruser{}. +@c @ref{}. @c Application Usage: @c @rprogram{}. diff --git a/Documentation/user/editorial.itely b/Documentation/user/editorial.itely index 7bdca44e34..6a7f212357 100644 --- a/Documentation/user/editorial.itely +++ b/Documentation/user/editorial.itely @@ -350,8 +350,8 @@ gis4 a @seealso Notation Reference: -@ref{List of colors}, @ref{Objects connected to -the input}. +@ref{List of colors}, @ref{The +tweak command}. Snippets: @rlsr{Editorial annotations}. @@ -373,7 +373,7 @@ and @code{'ForestGreen}. For web use normal colors are recommended Notes in a chord cannot be colored with @code{\override}; use -@code{\tweak} instead, see @ref{Objects connected to the input}. +@code{\tweak} instead, see @ref{The tweak command}. @node Parentheses diff --git a/Documentation/user/rhythms.itely b/Documentation/user/rhythms.itely index e251cb98f4..3bf7512e5f 100644 --- a/Documentation/user/rhythms.itely +++ b/Documentation/user/rhythms.itely @@ -267,7 +267,7 @@ Learning Manual: @rlearning{Tweaking methods}. Notation Reference: @ref{Time administration}, @ref{Scaling durations}, -@ref{Objects connected to the input}, +@ref{The tweak command}, @ref{Polymetric notation}. Snippets: diff --git a/Documentation/user/tweaks.itely b/Documentation/user/tweaks.itely index e59614f71a..8094700d47 100644 --- a/Documentation/user/tweaks.itely +++ b/Documentation/user/tweaks.itely @@ -124,15 +124,15 @@ We met some object naming conventions previously, in @ref{Contexts and engravers}. Here for reference is a list of the most common object and property types together with the conventions for naming them and a couple of examples of -some real names. We have used A to stand for any capitalized -alphabetic character and aaa to stand for any number of +some real names. We have used @q{A} to stand for any capitalized +alphabetic character and @q{aaa} to stand for any number of lower-case alphabetic characters. Other characters are used verbatim. @multitable @columnfractions .33 .33 .33 @headitem Object/property type @tab Naming convention - @tab Example + @tab Examples @item Contexts @tab Aaaa or AaaaAaaaAaaa @tab Staff, GrandStaff @@ -170,7 +170,7 @@ properties. We have already met the commands @code{\set} and @code{\with}, used to change the properties of @strong{contexts} and to remove and add @strong{engravers}, in -@ref{Modifying context properties} and @ref{Adding +@ref{Modifying context properties}, and @ref{Adding and removing engravers}. We now must meet some more important commands. @@ -185,17 +185,16 @@ how this is done. The general syntax of this command is: @example -\override @emph{context}.@emph{layout_object} - #'@emph{layout_property} = #@emph{value} +\override @var{Context}.@var{LayoutObject} #'@var{layout-property} = #@var{value} @end example @noindent -This will set the property with the name @emph{layout_property} +This will set the property with the name @var{layout-property} of the layout object with the name -@emph{layout_object}, which is a member of the @emph{context} -context, to the value @emph{value}. +@var{LayoutObject}, which is a member of the @var{Context} +context, to the value @var{value}. -The @emph{context} can be omitted (and usually is) when the +The @var{Context} can be omitted (and usually is) when the required context is unambiguously implied and is one of lowest level contexts, i.e., @code{Voice}, @code{ChordNames} or @code{Lyrics}, and we shall omit it in many of the following @@ -235,11 +234,11 @@ value; note, not its previous value if several @code{\override} commands have been issued. @example -\revert @emph{context}.@emph{layout_object} #'@emph{layout_property} +\revert @var{Context}.@var{LayoutObject} #'@var{layout-property} @end example -Again, just like @emph{context} in the @code{\override} command, -@emph{context} is often not needed. It will be omitted +Again, just like @var{Context} in the @code{\override} command, +@var{Context} is often not needed. It will be omitted in many of the following examples. Here we revert the color of the note head to the default value for the final two notes: @@ -294,7 +293,7 @@ within a chord, whereas @code{\tweak} affects just the following item in the input stream. Here's an example. Suppose we wish to change the size of the -middle note (the E) in a C major chord. Let's first see what +middle note head (the E) in a C major chord. Let's first see what @code{\once \override} would do: @lilypond[quote,fragment,ragged-right,verbatim,relative=1] @@ -304,7 +303,7 @@ middle note (the E) in a C major chord. Let's first see what @end lilypond -We see the override affects @emph{all} the notes in the chord. +We see the override affects @emph{all} the note heads in the chord. This is because all the notes of a chord occur at the same @emph{musical moment}, and the action of @code{\once} is to apply the override to all layout objects of the type specified @@ -314,9 +313,9 @@ command itself. The @code{\tweak} command operates in a different way. It acts on the immediately following item in the input stream. However, it is effective only on objects which are created directly from -the input stream, essentially note heads and articulations. -(Objects such as stems and accidentals are created later and -cannot be tweaked in this way). Furthermore, when it is applied +the input stream, essentially note heads and articulations; +objects such as stems and accidentals are created later and +cannot be tweaked in this way. Furthermore, when it is applied to note heads these @emph{must} be within a chord, i.e., within single angle brackets, so to tweak a single note the @code{\tweak} command must be placed inside single angle brackets with the @@ -335,10 +334,10 @@ of the @code{\override} command. Neither the context nor the layout object should be specified; in fact, it would generate an error to do so. These are both implied by the following item in the input stream. So the general syntax of the -@code{\tweak} command is simply: +@code{\tweak} command is simply @example -\tweak #'@emph{layout_property} = #@emph{value} +\tweak #'@var{layout-property} = #@var{value} @end example A @code{\tweak} command can also be used to modify just one in @@ -350,6 +349,7 @@ a ^Black -\tweak #'color #green _Green @end lilypond +@noindent Note that the @code{\tweak} command must be preceded by an articulation mark as if it were an articulation itself. @@ -381,10 +381,7 @@ printed in red on the first short tuplet bracket. } @end lilypond -You can find more details of the @code{\tweak} command in -@ruser{Objects connected to the input}. - -If nested tuplets do not begin at the same moment their +If nested tuplets do not begin at the same moment, their appearance may be modified in the usual way with @code{\override} commands: @@ -403,6 +400,11 @@ appearance may be modified in the usual way with } @end lilypond +@seealso + +Notation Reference: +@ruser{The tweak command}. + @node The Internals Reference manual @section The Internals Reference manual @@ -449,7 +451,7 @@ yourself with just a little practice. Let's use a concrete example with a simple fragment of real music: -@lilypond[quote,fragment,ragged-right,verbatim,relative=2] +@lilypond[quote,verbatim,relative=2] { \time 6/8 { @@ -472,7 +474,7 @@ this we must look in the Internals Reference, or IR for short. The IR for the version of LilyPond you are using may be found on the LilyPond website at @uref{http://lilypond.org}. Go to the documentation page and click on the Internals Reference link. -For learning purposes you should use the standard html version, +For learning purposes you should use the standard HTML version, not the @q{one big page} or the PDF. For the next few paragraphs to make sense you will need to actually do this as you read. @@ -485,18 +487,17 @@ The page that appears lists all the layout objects used in your version of LilyPond, in alphabetic order. Select the link to Slur, and the properties of Slurs are listed. -(An alternative way of finding this page is from the Notation -Reference. On one of the pages that deals with slurs you may -find a link to the Internals Reference. This link will -take you directly to this page, but often it is easier to go -straight to the IR and search there.) +An alternative way of finding this page is from the Notation +Reference. On one of the pages that deals with slurs you may find a +link to the Internals Reference. This link will take you directly to +this page, but if you have an idea about the name of the layout object +to be tweaked, it is easier to go straight to the IR and search there. -This Slur page in the IR tells us first that Slur objects are -created by the -Slur_engraver. Then it lists the standard settings. Note -these are @strong{not} in alphabetic order. Browse down -them looking for a property that might control the heaviness -of slurs, and you should find +This Slur page in the IR tells us first that Slur objects are created +by the Slur_engraver. Then it lists the standard settings. Note +these are @strong{not} in alphabetic order. Browse down them looking +for a property that might control the heaviness of slurs, and you +should find @example @code{thickness} (number) @@ -533,7 +534,7 @@ placed?} While you are unsure and learning, the best answer is, @q{Within the music, before the first slur and close to it.} Let's do that: -@lilypond[quote,fragment,ragged-right,verbatim,relative=2] +@lilypond[quote,verbatim,relative=2] { \time 6/8 { @@ -597,7 +598,7 @@ is encountered, it is simply discarded. So the command with @code{\once} must be repositioned as follows: -@lilypond[quote,fragment,ragged-right,verbatim,relative=2] +@lilypond[quote,verbatim,relative=2] { \time 6/8 { @@ -631,7 +632,7 @@ heavier? Well, we could use two commands, each preceded by @code{\once} placed immediately before each of the notes where the slurs begin: -@lilypond[quote,fragment,ragged-right,verbatim,relative=2] +@lilypond[quote,verbatim,relative=2] { \time 6/8 { @@ -656,7 +657,7 @@ or we could omit the @code{\once} command and use the to return the @code{thickness} property to its default value after the second slur: -@lilypond[quote,fragment,ragged-right,verbatim,relative=2] +@lilypond[quote,verbatim,relative=2] { \time 6/8 { @@ -688,6 +689,7 @@ additional features of the IR, and partly to give you more practice in extracting information from it. These examples will contain progressively fewer words of guidance and explanation. + @node Properties found in interfaces @subsection Properties found in interfaces -- 2.39.5