From: James Lowe Date: Sun, 11 Mar 2012 13:45:36 +0000 (+0000) Subject: NR: General tidy up - @seealso @knownissue spacing X-Git-Tag: release/2.15.34-1~25 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=80340bdefc128536c79733d8c6f3467d91b01f72;p=lilypond.git NR: General tidy up - @seealso @knownissue spacing No new information added. Trying to make @seealso sections follow CG policy including line breaks for consistent visual layout in *.itely files. Notation Reference only: Made sure all existing @seealso entries were i. In the correct order as per the CG ii. Each @seealso was labelled correctly (i.e. 'Extending LilyPond' instead of just 'Extending' - as per CG). iii. Correct punctuation marks at the end of each line entry iv. Made line breaks between each section consistent (one line space after main sections). Kept one line space between @seealso and @knownissues. Made sure two line breaks before next @node. Any @cindex have line space either side of entry. Removed line space between @seealso and @knownissues and their respective text entries. v. Removed @c sections that contained empty @seealso entries that were just 'placeholders' for the 'future' - as this isn't standard practice. --- diff --git a/Documentation/notation/ancient.itely b/Documentation/notation/ancient.itely index 8dd363d712..0e7d043e61 100644 --- a/Documentation/notation/ancient.itely +++ b/Documentation/notation/ancient.itely @@ -83,7 +83,6 @@ Notation Reference: @node Overview of the supported styles @subsection Overview of the supported styles - Three styles are available for typesetting Gregorian chant: @itemize @@ -339,12 +338,12 @@ supported are @code{vaticana}, @code{medicaea}, @code{hufnagel}, and Music Glossary: @rglos{custos}. -Internals Reference: -@rinternals{Custos}. - Snippets: @rlsr{Ancient notation}. +Internals Reference: +@rinternals{Custos}. + @node Figured bass support @unnumberedsubsubsec Figured bass support @@ -408,7 +407,6 @@ entering the chant, as the following excerpt demonstrates: } @end lilypond - @seealso Music Glossary: @rglos{mensural notation}. @@ -531,7 +529,6 @@ Music Glossary: Notation Reference: @ref{Clef}. - @knownissues The mensural g clef is mapped to the Petrucci g clef. @@ -749,13 +746,11 @@ There is no particular flag style for neo-mensural or Petrucci notation. @c music, the default flag style should be used. There are no flags in Gregorian chant notation. - @seealso Music Glossary: @rglos{mensural notation}, @rglos{flag}. - @knownissues The attachment of ancient flags to stems is slightly off. @c due to a change in early 2.3.x. @@ -807,7 +802,6 @@ Notation Reference: Snippets: @rlsr{Ancient notation}. - @knownissues The glyph for the maxima rest in mensural style is actually a perfect longa rest; use two (or three) longa rests to print a maxima rest. @@ -898,7 +892,6 @@ ficta = { \once \set suggestAccidentals = ##t } } @end lilypond - @seealso Internals Reference: @rinternals{Accidental_engraver}, @@ -1015,6 +1008,7 @@ Notation Reference: Horizontal spacing of ligatures is poor. Accidentals may collide with previous notes. + @node Typesetting Gregorian chant @subsection Typesetting Gregorian chant @@ -1044,6 +1038,7 @@ Notation Reference: @ref{White mensural ligatures}, @ref{Ligatures}. + @node Gregorian chant contexts @unnumberedsubsubsec Gregorian chant contexts @@ -1220,7 +1215,6 @@ hufnagel style combined do/fa clef @end lilypond @end multitable - @seealso Music Glossary: @rglos{clef}. @@ -1269,7 +1263,6 @@ The style for accidentals and key signatures is controlled by the @code{\override Staff.Accidental #'glyph-name-alist = #alteration-mensural-glyph-name-alist} - @seealso Music Glossary: @rglos{accidental}, @@ -1369,7 +1362,7 @@ Notation Reference: @ref{Breath marks}. Installed Files: -@file{gregorian.ly}. +@file{ly/gregorian.ly}. @node Gregorian articulation signs @@ -1398,7 +1391,6 @@ specifically designed for use with notation in } @end lilypond - @seealso Notation Reference: @ref{Articulations and ornamentations}. @@ -1414,7 +1406,6 @@ Internals Reference: @rinternals{ScriptEvent}, @rinternals{Script_engraver}. - @knownissues Some articulations are vertically placed too closely to the corresponding note heads. @@ -1442,7 +1433,6 @@ note that you can say @code{\augmentum @{a g@}} as a shortcut for } @end lilypond - @seealso Notation Reference: @ref{Breath marks}. @@ -2404,7 +2394,6 @@ Notation Reference: @ref{White mensural ligatures}, @ref{Ligatures}. - @knownissues When an @code{\augmentum} dot appears at the end of the last staff within a ligature, it is sometimes vertically placed wrong. As a @@ -2453,7 +2442,6 @@ same source. @c use snippet Transcription-of-ancient-music-with-incipit TBC - @c @seealso @c ... and reference to other sections ... @@ -2478,7 +2466,6 @@ orientation aids that bar lines give. @c from lsr and -user @c TBC - @c @seealso @c ... and reference to other sections ... @@ -2702,4 +2689,3 @@ TBC @c @seealso @c ... and reference to other sections ... - diff --git a/Documentation/notation/changing-defaults.itely b/Documentation/notation/changing-defaults.itely index fb19a18e38..235d5c6158 100644 --- a/Documentation/notation/changing-defaults.itely +++ b/Documentation/notation/changing-defaults.itely @@ -67,7 +67,6 @@ This section describes what contexts are, and how to modify them. * Context layout order:: @end menu - @seealso Learning Manual: @rlearning{Contexts and engravers}. @@ -1010,18 +1009,16 @@ is encountered when there is no suitable context available to contain it. This can give rise to unexpected new staves or scores. @seealso -Usage Manual: +Application Usage: @rprogram{An extra staff appears}. Installed Files: @file{ly/engraver-init.ly}. - @node Explaining the Internals Reference @section Explaining the Internals Reference - @menu * Navigating the program reference:: * Layout interfaces:: @@ -1474,22 +1471,19 @@ such as @end ignore @seealso -Internals: +Internals Reference: @rinternals{Backend}, @rinternals{All layout objects}, @rinternals{OverrideProperty}, @rinternals{RevertProperty}, @rinternals{PropertySet}. - @knownissues - The back-end is not very strict in type-checking object properties. Cyclic references in Scheme values for properties can cause hangs or crashes, or both. - @node The set command @subsection The @code{@bs{}set} command @@ -1624,12 +1618,9 @@ Translation @expansion{} Tunable context properties. @end ifnothtml @seealso - Internals Reference: - @rinternals{Tunable context properties}. - @cindex grob properties @cindex properties, grob @funindex \override @@ -1792,10 +1783,10 @@ and the program reference. @end ignore @seealso - Internals Reference: @rinternals{Backend} + @node The tweak command @subsection The @code{\tweak} command @@ -1956,18 +1947,16 @@ determining what may be modified by a @code{\tweak} command, or in determining how to adjust the input to make a @code{\tweak} apply. - @seealso Learning Manual: @rlearning{Tweaking methods}. -Extending: +Extending LilyPond: @rextend{Displaying music expressions}. - @knownissues - @cindex tweaks in a variable + The @code{\tweak} command cannot be used inside a variable. @cindex tweaks in lyrics @@ -1979,6 +1968,7 @@ The @code{\tweak} commands cannot be used in @code{\lyricmode}. The @code{\tweak} command will apply to only the first of several generated ties in a chord. + @node set versus override @subsection @code{\set} vs. @code{\override} @@ -2369,7 +2359,6 @@ convert from a font size change to the equivalent change in @code{staff-space}. For an explanation and an example of its use, see @rlearning{Length and thickness of objects}. - @seealso Learning Manual: @rlearning{Length and thickness of objects}. @@ -2705,7 +2694,6 @@ When using @code{\endSpanners} it is not necessary to close \startTextSpan with \stopTextSpan, nor is it necessary to close hairpins with @code{\!}. - @seealso Internals Reference: @rinternals{TextSpanner}, @@ -3047,10 +3035,9 @@ For explicit clef changes, the @code{explicitClefVisibility} property controls both the clef symbol and any octavation symbol associated with it. - @seealso Learning Manual: -@rlearning{Visibility and color of objects} +@rlearning{Visibility and color of objects}. @node Line styles @@ -3180,7 +3167,6 @@ appearance of the printed score. * Unpure-pure containers:: @end menu - @seealso Learning Manual: @rlearning{Tweaking output}, @@ -3190,15 +3176,15 @@ Notation Reference: @ref{Explaining the Internals Reference}, @ref{Modifying properties}. +Extending LilyPond: +@rextend{Interfaces for programmers}. + Installed Files: @file{scm/define-grobs.scm}. Snippets: @rlsr{Tweaks and overrides}. -Extending: -@rextend{Interfaces for programmers}. - Internals Reference: @rinternals{All layout objects}. @@ -3243,7 +3229,10 @@ are special properties to be found in the @code{break-aligned-interface} for positioning rehearsal marks on such objects. @seealso -@ref{Using the break-alignable-interface}, +Internals Reference: +@ref{Using the break-alignable-interface}. + +Exending LilyPond: @rextend{Callback functions}. @menu @@ -3593,7 +3582,6 @@ Any of the glyphs in the feta Font can be supplied to the @c TODO Add inserting Postscript or ref to later - @seealso Notation Reference: @ref{Graphic notation inside markup}, @@ -3698,6 +3686,7 @@ Internals Reference: @cindex unpure containers, Scheme @cindex horizontal spacing, overriding + @node Unpure-pure containers @subsection Unpure-pure containers @@ -3872,13 +3861,11 @@ For a list of available type predicates, see @ref{Predefined type predicates}. User-defined type predicates are also allowed. - @seealso - Notation Reference: @ref{Predefined type predicates}. -Extending: +Extending Lilypond: @rextend{Music functions}. Installed Files: diff --git a/Documentation/notation/chords.itely b/Documentation/notation/chords.itely index 2d2975bc9e..2a360698cb 100644 --- a/Documentation/notation/chords.itely +++ b/Documentation/notation/chords.itely @@ -75,7 +75,6 @@ Chord mode and note mode can be mixed in sequential music: \chordmode { f2 g } @end lilypond - @seealso Music Glossary: @rglos{chord}. @@ -87,9 +86,7 @@ Notation Reference: Snippets: @rlsr{Chords}. - @knownissues - Predefined shorthands for articulations and ornaments cannot be used on notes in chord mode, see @ref{Articulations and ornamentations}. @@ -112,6 +109,7 @@ To avoid this behavior, explicitly create the @code{Staff} context: } @end lilypond + @node Common chords @unnumberedsubsubsec Common chords @@ -229,7 +227,6 @@ to create a major triad. @end multitable - @seealso Notation Reference: @ref{Common chord modifiers}, @@ -238,7 +235,6 @@ Notation Reference: Snippets: @rlsr{Chords}. - @knownissues Only one quality modifier should be used per chord, typically on the highest step present in the chord. Chords with more than quality @@ -383,7 +379,6 @@ Chord modifiers that can be used to produce a variety of standard chords are shown in @ref{Common chord modifiers}. - @seealso Notation Reference: @ref{Common chord modifiers}. @@ -391,9 +386,7 @@ Notation Reference: Snippets: @rlsr{Chords}. - @knownissues - Each step can only be present in a chord once. The following simply produces the augmented chord, since @code{5+} is interpreted last. @@ -412,6 +405,7 @@ the chord. } @end lilypond + @node Displaying chords @subsection Displaying chords @@ -521,7 +515,6 @@ Rests passed to a @code{ChordNames} context will cause the @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {simple-lead-sheet.ly} - @seealso Music Glossary: @rglos{chord}. @@ -539,9 +532,7 @@ Internals Reference: @rinternals{Volta_engraver}, @rinternals{Bar_engraver}. - @knownissues - Chords containing inversions or altered bass notes are not named properly if entered using simultaneous music. @@ -756,7 +747,6 @@ used when the root is altered. @lilypondfile[verbatim,quote,texidoc,doctitle] {changing-chord-separator.ly} - @seealso Notation Reference: @ref{Chord name chart}, @@ -773,12 +763,7 @@ Installed Files: Snippets: @rlsr{Chords}. -@c Internals Reference: -@c @r internals{}. - - @knownissues - Chord names are determined from both the pitches that are present in the chord and the information on the chord structure that may have been entered in @code{\chordmode}. If the simultaneous pitches @@ -861,7 +846,6 @@ example, the vertical spacing of the figures may be set with @code{baseline-skip}. @end ignore - @seealso Music Glossary: @rglos{figured bass}. @@ -1045,23 +1029,7 @@ End of continuation line @lilypondfile[verbatim,quote,texidoc,doctitle] {changing-the-positions-of-figured-bass-alterations.ly} - @seealso -@c Music Glossary: -@c @rglos{}. -@c -@c Learning Manual: -@c @rlearning{}. -@c -@c Notation Reference: -@c @ref{}. -@c -@c Application Usage: -@c @rprogram{}. -@c -@c Installed Files: -@c @file{}. -@c Snippets: @rlsr{Chords}. @@ -1074,9 +1042,6 @@ Internals Reference: @rinternals{FiguredBass}. -@c @knownissues - - @node Displaying figured bass @unnumberedsubsubsec Displaying figured bass @@ -1146,7 +1111,6 @@ or below the staff. >> @end lilypond - @predefined @cindex figured bass alignment @code{\bassFigureStaffAlignmentDown}, @@ -1154,26 +1118,7 @@ or below the staff. @code{\bassFigureStaffAlignmentNeutral}. @endpredefined - -@c @snippets - - @seealso -@c Music Glossary: -@c @rglos{}. -@c -@c Learning Manual: -@c @rlearning{}. -@c -@c Notation Reference: -@c @ref{}. -@c -@c Application Usage: -@c @rprogram{}. -@c -@c Installed Files: -@c @file{}. -@c Snippets: @rlsr{Chords}. @@ -1185,9 +1130,7 @@ Internals Reference: @rinternals{BassFigureContinuation}, @rinternals{FiguredBass}. - @knownissues - To ensure that continuation lines work properly, it is safest to use the same rhythm in the figure line as in the bass line. @@ -1246,4 +1189,3 @@ begins the extender line and turn them off at the end of the extender line. } >> @end lilypond - diff --git a/Documentation/notation/editorial.itely b/Documentation/notation/editorial.itely index cef5262ed6..0f7c96a587 100644 --- a/Documentation/notation/editorial.itely +++ b/Documentation/notation/editorial.itely @@ -130,7 +130,6 @@ that use fonts. These are the ones supporting the @code{\huge}. @endpredefined - @seealso Snippets: @rlsr{Editorial annotations}. @@ -198,7 +197,6 @@ staff, see @ref{Direction and placement}. @lilypondfile[verbatim,quote,texidoc,doctitle] {avoiding-collisions-with-chord-fingerings.ly} - @seealso Notation Reference: @ref{Direction and placement}. @@ -264,7 +262,6 @@ e8(\p f g a)-- @code{\unHideNotes}. @endpredefined - @seealso Learning Manual: @rlearning{Visibility and color of objects}. @@ -366,7 +363,6 @@ gis8 a gis4 a @end lilypond - @seealso Notation Reference: @ref{List of colors}, @ref{The @@ -375,7 +371,6 @@ tweak command}. Snippets: @rlsr{Editorial annotations}. - @cindex x11 color @cindex colored notes in chords @cindex notes, colored in chords @@ -392,7 +387,6 @@ a web browser might not display a difference between @code{LimeGreen} and @code{ForestGreen}. For web use normal colors are recommended (i.e., @code{blue}, @code{green}, @code{red}). - Notes in a chord cannot be colored with @code{\override}; use @code{\tweak} instead, see @ref{The tweak command}. @@ -426,7 +420,6 @@ c2-\parenthesize -. d c2 \parenthesize r @end lilypond - @seealso Snippets: @rlsr{Editorial annotations}. @@ -436,9 +429,7 @@ Internals Reference: @rinternals{ParenthesesItem}, @rinternals{parentheses-interface}. - @knownissues - Parenthesizing a chord prints parentheses around each individual note, instead of a single large parenthesis around the entire chord. @@ -482,7 +473,6 @@ Stems may be manually placed to point up or down; see @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {default-direction-of-stems-on-the-center-line-of-the-staff.ly} - @seealso Notation Reference: @ref{Direction and placement}. @@ -564,13 +554,11 @@ altered: } @end lilypond - @predefined @code{\balloonLengthOn}, @code{\balloonLengthOff}. @endpredefined - @seealso Snippets: @rlsr{Editorial annotations}. @@ -637,7 +625,6 @@ lines. @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {grid-lines--changing-their-appearance.ly} - @seealso Snippets: @rlsr{Editorial annotations}. @@ -702,7 +689,6 @@ Analysis brackets may be nested. } @end lilypond - @seealso Snippets: @rlsr{Editorial annotations}. @@ -712,4 +698,3 @@ Internals Reference: @rinternals{HorizontalBracket}, @rinternals{horizontal-bracket-interface}, @rinternals{Staff}. - diff --git a/Documentation/notation/expressive.itely b/Documentation/notation/expressive.itely index 0627238123..0d86f3e639 100644 --- a/Documentation/notation/expressive.itely +++ b/Documentation/notation/expressive.itely @@ -481,7 +481,6 @@ items such as text scripts, text spanners, and piano pedal marks. @lilypondfile[verbatim,quote,texidoc,doctitle] {changing-text-and-spanner-styles-for-text-dynamics.ly} - @seealso Music Glossary: @rglos{al niente}, @@ -608,7 +607,6 @@ moltoF = #(make-dynamic-script Font settings in markup mode are described in @ref{Selecting font and font size}. - @seealso Notation Reference: @ref{Formatting text}, @@ -616,12 +614,11 @@ Notation Reference: @ref{What goes into the MIDI output?}, @ref{Controlling MIDI dynamics}. -Snippets: -@rlsr{Expressive marks}. - -Extend: +Extending LilyPond: @rextend{Markup construction in Scheme}. +Snippets: +@rlsr{Expressive marks}. @node Expressive marks as curves @@ -770,7 +767,6 @@ g4( e c2) @lilypondfile[verbatim,quote,texidoc,doctitle] {making-slurs-with-complex-dash-structure.ly} - @seealso Music Glossary: @rglos{slur}. @@ -911,7 +907,6 @@ complex dash patterns, see the snippets under @ref{Slurs}. @code{\phrasingSlurSolid}. @endpredefined - @seealso Learning Manual: @rlearning{On the un-nestedness of brackets and ties}. @@ -963,7 +958,6 @@ divisiones, are supported. For details, see @ref{Divisiones}. @lilypondfile[verbatim,quote,texidoc,doctitle] {inserting-a-caesura.ly} - @seealso Music Glossary: @rglos{caesura}. @@ -1012,7 +1006,6 @@ command is @emph{required} when writing falls and doits. @lilypondfile[verbatim,quote,texidoc,doctitle] {adjusting-the-shape-of-falls-and-doits.ly} - @seealso Music Glossary: @rglos{fall}, @@ -1060,7 +1053,6 @@ Different styles of glissandi can be created. For details, see @lilypondfile[verbatim,quote,texidoc,doctitle] {contemporary-glissando.ly} - @seealso Music Glossary: @rglos{glissando}. @@ -1074,9 +1066,7 @@ Snippets: Internals Reference: @rinternals{Glissando}. - @knownissues - Printing text over the line (such as @notation{gliss.}) is not supported. @@ -1177,7 +1167,6 @@ information, see @ref{Ties}. @lilypondfile[verbatim,quote,texidoc,doctitle] {creating-arpeggios-across-notes-in-different-voices.ly} - @seealso Music Glossary: @rglos{arpeggio}. @@ -1194,9 +1183,7 @@ Internals Reference: @rinternals{Slur}, @rinternals{PianoStaff}. - @knownissues - @cindex cross-staff parenthesis-style arpeggio @cindex arpeggio, parenthesis-style, cross-staff @cindex arpeggio, cross-staff parenthesis-style @@ -1307,7 +1294,6 @@ eis4\startTrillSpan fis! eis4\stopTrillSpan @end lilypond - @predefined @code{\startTrillSpan}, @code{\stopTrillSpan}. @@ -1326,4 +1312,3 @@ Snippets: Internals Reference: @rinternals{TrillSpanner}. - diff --git a/Documentation/notation/fretted-strings.itely b/Documentation/notation/fretted-strings.itely index f01e968b13..94bd671fc8 100644 --- a/Documentation/notation/fretted-strings.itely +++ b/Documentation/notation/fretted-strings.itely @@ -76,7 +76,6 @@ in @ref{Collision resolution}. @end itemize - @seealso Notation Reference: @ref{Fingering instructions}, @@ -128,7 +127,6 @@ in the code: @lilypondfile[verbatim,quote,texidoc,doctitle] {allowing-fingerings-to-be-printed-inside-the-staff.ly} - @seealso Notation Reference: @ref{Fingering instructions}. @@ -487,6 +485,7 @@ melodia = \partcombine { e4 g g g } { e4 e e e } Guitar special effects are limited to harmonics and slides. + @node Custom tablatures @unnumberedsubsubsec Custom tablatures @@ -667,7 +666,7 @@ Notation Reference: @ref{Scheme functions}. Installed Files: -@file{ly/string-tuning-init.ly} +@file{ly/string-tuning-init.ly}, @file{scm/tablature.scm}. Snippets: @@ -681,6 +680,7 @@ Automatic tablature calculations do not work properly in most cases for instruments where string pitches do not vary monotonically with string number, such as ukuleles. + @node Fret diagram markups @unnumberedsubsubsec Fret diagram markups @@ -1091,7 +1091,6 @@ Internals Reference: @node Predefined fret diagrams @unnumberedsubsubsec Predefined fret diagrams - @cindex fret diagrams @cindex fret diagrams, ukulele @cindex fret diagrams, mandolin @@ -1385,7 +1384,6 @@ the interface properties belong to @code{FretBoards.FretBoard}. @lilypondfile[verbatim,quote,texidoc,doctitle] {fretboards-alternate-tables.ly} - @seealso Notation Reference: @ref{Custom tablatures}, @@ -1553,7 +1551,6 @@ diagram, the interface properties belong to @code{\predefinedFretboardsOn}. @endpredefined - @seealso Notation Reference: @ref{Custom tablatures}. @@ -1612,7 +1609,6 @@ short, for example @code{RH}, @lilypondfile[verbatim,quote,texidoc,doctitle] {fingerings,-string-indications,-and-right-hand-fingerings.ly} - @seealso Snippets: @rlsr{Fretted strings}. @@ -1658,7 +1654,6 @@ b16 e g e b g\stopTextSpan e16 b g d @end lilypond - @seealso Notation Reference: @ref{Text spanners}. @@ -1880,8 +1875,8 @@ These may be converted to four-string tunings using the @end example @seealso +Installed Files: +@file{ly/string-tunings-init.ly}. + Snippets: @rlsr{Fretted strings}. - -Installed Files: -@file{ly/string-tunings-init.ly} diff --git a/Documentation/notation/input.itely b/Documentation/notation/input.itely index 3c2c98b265..8c6c1639d3 100644 --- a/Documentation/notation/input.itely +++ b/Documentation/notation/input.itely @@ -504,7 +504,6 @@ after the entire command. @end itemize - @seealso Learning Manual: @rlearning{How LilyPond input files work}. @@ -711,6 +710,7 @@ Notation Reference: Installed Files: @file{ly/titling-init.ly}. + @node Default layout of headers and footers @unnumberedsubsubsec Default layout of headers and footers @@ -1014,6 +1014,7 @@ Notation Reference: @ref{Title blocks explained}, @ref{Default layout of book and score title blocks}. + @node Creating footnotes @subsection Creating footnotes @@ -1428,10 +1429,9 @@ Dots can be added to fill the line between an item and its page number: } @end lilypond - @seealso -Init files: @file{../ly/toc-init.ly}. - +Installed Files: +@file{ly/toc-init.ly}. @predefined @funindex \table-of-contents @@ -1814,19 +1814,18 @@ Notation Reference: @ref{Automatic part combining}, @ref{Including LilyPond files}. - @ignore @c This warning is more general than this placement implies. @c Rests are not merged whether or not they come from tagged sections. @c Should be deleted? -td @knownissues - Multiple rests are not merged if you create a score with more than one tagged section at the same place. @end ignore + @node Using global settings @unnumberedsubsubsec Using global settings @@ -1854,6 +1853,7 @@ Learning Manual: Notation Reference: @ref{Including LilyPond files}. + @node Special characters @subsection Special characters @@ -2042,7 +2042,6 @@ Installed Files: @file{ly/text-replacements.ly}. - @node Controlling output @section Controlling output @@ -2179,7 +2178,8 @@ existing @code{fonts} directory to @code{fonts_orig} and the reverse the process. @seealso -Learning Manual: @rlearning{Other sources of information}. +Learning Manual: +@rlearning{Other sources of information}. @knownissues Gonville cannot be used to typeset @q{Ancient Music} notation and it is diff --git a/Documentation/notation/keyboards.itely b/Documentation/notation/keyboards.itely index bcd955b28e..e323958e52 100644 --- a/Documentation/notation/keyboards.itely +++ b/Documentation/notation/keyboards.itely @@ -137,6 +137,7 @@ Internals Reference: Snippets: @rlsr{Keyboards}. + @node Changing staff manually @unnumberedsubsubsec Changing staff manually @@ -324,7 +325,6 @@ key signature in the lower staff: >> @end lilypond - @seealso Notation Reference: @ref{Changing staff manually}. @@ -337,7 +337,6 @@ Internals Reference: @knownissues - @cindex chords, splitting across staves with \autochange The staff switches may not end up in optimal places. For high @@ -346,6 +345,7 @@ quality output, staff switches should be specified manually. Chords will not be split across the staves; they will be assigned to a staff based on the first note named in the chord construct. + @node Staff-change lines @unnumberedsubsubsec Staff-change lines @@ -391,7 +391,6 @@ notes can be printed automatically: @code{\hideStaffSwitch}. @endpredefined - @seealso Snippets: @rlsr{Keyboards}. @@ -454,7 +453,6 @@ Chords that cross staves may be produced: @lilypondfile[verbatim,quote,texidoc,doctitle] {indicating-cross-staff-chords-with-arpeggio-bracket.ly} - @seealso Snippets: @rlsr{Keyboards}. @@ -600,7 +598,6 @@ come into use to simplify the performance instructions. @lilypondfile[verbatim,quote,texidoc,doctitle] {accordion-discant-symbols.ly} - @seealso Snippets: @rlsr{Keyboards}. @@ -644,6 +641,7 @@ Notation Reference: @ref{Arpeggio}, @ref{Harmonics}. + @node Harp pedals @unnumberedsubsubsec Harp pedals diff --git a/Documentation/notation/notation-appendices.itely b/Documentation/notation/notation-appendices.itely index 830366ddd4..1c00f6fb5b 100644 --- a/Documentation/notation/notation-appendices.itely +++ b/Documentation/notation/notation-appendices.itely @@ -1149,7 +1149,6 @@ character, or a combination of two characters formating a ligature. A set of glyphs with a single style and shape comprise a font, and a set of fonts covering several styles and sizes comprise a typeface. - @seealso Notation Reference: @ref{Fonts}, @@ -1200,6 +1199,7 @@ In apparent contradiction to the name, they can be changed using Notation Reference: @ref{mutable}. + @node interface @unnumberedsubsec interface @@ -1259,6 +1259,7 @@ computations are stored in mutable properties. Notation Reference: @ref{immutable}. + @node output-def @unnumberedsubsec output-def diff --git a/Documentation/notation/percussion.itely b/Documentation/notation/percussion.itely index cc4dd03a2c..3f361f0ef3 100644 --- a/Documentation/notation/percussion.itely +++ b/Documentation/notation/percussion.itely @@ -48,7 +48,6 @@ discussed in @ref{Showing melody rhythms}, and @end itemize - @seealso Notation Reference: @ref{Showing melody rhythms}, @@ -111,14 +110,13 @@ be set explicitly. Other clefs may be used as well. There are a few issues concerning MIDI support for percussion instruments; for details please see @ref{Percussion in MIDI}. - @seealso Notation Reference: @ref{Percussion in MIDI}, @ref{Percussion notes}. -File: -@file{ly/drumpitch-init.ly} +Installed Files: +@file{ly/drumpitch-init.ly}. Snippets: @rlsr{Percussion}. @@ -159,9 +157,7 @@ may be overridden to achieve a pleasing baseline. } @end lilypond - @seealso - Notation Reference: @ref{Tremolo repeats}. @@ -176,7 +172,6 @@ Certain pitched percussion instruments (e.g. xylophone, vibraphone, and timpani) are written using normal staves. This is covered in other sections of the manual. - @seealso @c TODO: possibly link to an alternate section of NR 3.5, if @c "percussion in MIDI" gets a separate subsubsection for @@ -579,7 +574,6 @@ drumsB = { } @end lilypond - @seealso Snippets: @rlsr{Percussion}. @@ -624,7 +618,6 @@ However, the default @code{\drummode} does not include the Also note that you must add chords (@code{< >} brackets) around each @code{\parenthesize} statement. - @seealso Snippets: @rlsr{Percussion}. diff --git a/Documentation/notation/pitches.itely b/Documentation/notation/pitches.itely index 491e76f03c..4bc237094a 100644 --- a/Documentation/notation/pitches.itely +++ b/Documentation/notation/pitches.itely @@ -87,7 +87,6 @@ octave. } @end lilypond - @seealso Music Glossary: @rglos{Pitch names}. @@ -274,7 +273,6 @@ Snippets: Internals Reference: @rinternals{RelativeOctaveMusic}. - @cindex relative octave entry and transposition @cindex transposition and relative octave entry @@ -285,7 +283,6 @@ Internals Reference: @funindex \relative @funindex relative - @c DEPRECATED If no @code{@var{startpitch}} is specified for @code{\relative}, then@tie{}@code{c'} is assumed. However, this is a deprecated @@ -293,7 +290,6 @@ option and may disappear in future versions, so its use is discouraged. - @node Accidentals @unnumberedsubsubsec Accidentals @@ -424,18 +420,15 @@ Internals Reference: @rinternals{AccidentalCautionary}, @rinternals{accidental-interface}. - @cindex accidental, quarter-tone @cindex quarter-tone accidental @knownissues - There are no generally accepted standards for denoting quarter-tone accidentals, so LilyPond's symbol does not conform to any standard. - @node Note names in other languages @unnumberedsubsubsec Note names in other languages @@ -573,7 +566,6 @@ Western classical music, also referred to as pitches and tuning systems are also supported: see @ref{Common notation for non-Western music}. - @seealso Music Glossary: @rglos{Pitch names}, @@ -666,7 +658,6 @@ checks fail, but the second one does not fail. } @end lilypond - @seealso Snippets: @rlsr{Pitches}. @@ -790,7 +781,6 @@ see @ref{Instrument transpositions}. @lilypondfile[verbatim,quote,texidoc,doctitle] {transposing-pitches-with-minimum-accidentals-smart-transpose.ly} - @seealso Notation Reference: @ref{Instrument transpositions}, @@ -805,7 +795,6 @@ Snippets: Internals Reference: @rinternals{TransposedMusic}. - @funindex \transpose @funindex transpose @funindex \chordmode @@ -814,7 +803,6 @@ Internals Reference: @funindex relative @knownissues - The relative conversion will not affect @code{\transpose}, @code{\chordmode} or @code{\relative} sections in its argument. To use relative mode within transposed music, an additional @code{\relative} @@ -1266,7 +1254,6 @@ fis @lilypondfile[verbatim,quote,texidoc,doctitle] {non-traditional-key-signatures.ly} - @seealso Music Glossary: @rglos{church mode}, @@ -1323,7 +1310,6 @@ a2 b @lilypondfile[verbatim,quote,texidoc,doctitle] {ottava-text.ly} - @seealso Music Glossary: @rglos{octavation}. @@ -1419,7 +1405,6 @@ R1 c2 g @end lilypond - @seealso Music Glossary: @rglos{concert pitch}, @@ -2548,14 +2533,12 @@ Internals Reference: @rinternals{AccidentalPlacement}, @rinternals{accidental-suggestion-interface}. - @cindex accidentals and simultaneous notes @cindex simultaneous notes and accidentals @cindex accidentals in chords @cindex chords, accidentals in @knownissues - Simultaneous notes are not considered in the automatic determination of accidentals; only previous notes and the key signature are considered. Forcing accidentals with@tie{}@code{!} @@ -2605,6 +2588,7 @@ forget = #(define-music-function (parser location music) (ly:music?) #{ } @end lilypond + @node Ambitus @unnumberedsubsubsec Ambitus @@ -2649,7 +2633,6 @@ printed if they are not part of the key signature. @lilypondfile[verbatim,quote,texidoc,doctitle] {changing-the-ambitus-gap.ly} - @seealso Music Glossary: @rglos{ambitus}. @@ -2667,9 +2650,7 @@ Internals Reference: @rinternals{AmbitusNoteHead}, @rinternals{ambitus-interface}. - @knownissues - There is no collision handling in the case of multiple per-voice ambitus. @@ -2827,7 +2808,6 @@ font, see @ref{Setting the staff size}. @lilypondfile[verbatim,quote,texidoc,doctitle] {numbers-as-easy-note-heads.ly} - @seealso Notation Reference: @ref{Setting the staff size}. @@ -2949,7 +2929,6 @@ a2 b c d \break To see all note head styles, see @ref{Note head styles}. - @seealso Snippets: @rlsr{Pitches}. @@ -2995,13 +2974,11 @@ rhythm. Such note heads can be created: } @end lilypond - @predefined @code{\improvisationOn}, @code{\improvisationOff}. @endpredefined - @seealso Snippets: @rlsr{Pitches}. diff --git a/Documentation/notation/repeats.itely b/Documentation/notation/repeats.itely index 2a0d5fdbd8..1aeebd69d5 100644 --- a/Documentation/notation/repeats.itely +++ b/Documentation/notation/repeats.itely @@ -428,7 +428,6 @@ voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } } @lilypondfile[verbatim,quote,texidoc,doctitle] {printing-a-repeat-sign-at-the-beginning-of-a-piece.ly} - @seealso Notation Reference: @ref{Bar lines}, @@ -558,6 +557,7 @@ Internals Reference: @rinternals{RepeatedMusic}, @rinternals{UnfoldedRepeatedMusic}. + @node Short repeats @subsection Short repeats @@ -723,11 +723,9 @@ c: c: @lilypondfile[verbatim,quote,texidoc,doctitle] {cross-staff-tremolos.ly} - @seealso Snippets: @rlsr{Repeats}. @cindex tremolo, cross-staff @cindex cross-staff tremolo - diff --git a/Documentation/notation/rhythms.itely b/Documentation/notation/rhythms.itely index b5c60a1980..680e96c4fd 100644 --- a/Documentation/notation/rhythms.itely +++ b/Documentation/notation/rhythms.itely @@ -148,7 +148,6 @@ the staff; see @ref{Direction and placement}. @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {changing-the-number-of-augmentation-dots-per-note.ly} - @seealso Music Glossary: @rglos{breve}, @@ -174,9 +173,7 @@ Internals Reference: @rinternals{Dots}, @rinternals{DotColumn}. - @knownissues - @c Deliberately duplicated in Durations and Rests. -gp There is no fundamental limit to rest durations (both in terms of longest and shortest), but the number of glyphs is limited: @@ -271,7 +268,6 @@ see @ref{Scaling durations}. @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {permitting-line-breaks-within-beamed-tuplets.ly} - @seealso Music Glossary: @rglos{triplet}, @@ -295,7 +291,6 @@ Internals Reference: @rinternals{TupletNumber}, @rinternals{TimeScaledMusic}. - @cindex grace notes within tuplet brackets @knownissues @@ -375,7 +370,6 @@ and expanded: One application of this command is in polymetric notation, see @ref{Polymetric notation}. - @seealso Notation Reference: @ref{Tuplets}, @@ -664,7 +658,6 @@ a4\rest d4\rest @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {rest-styles.ly} - @seealso Music Glossary: @rglos{breve}, @@ -680,9 +673,7 @@ Snippets: Internals Reference: @rinternals{Rest}. - @knownissues - @c Deliberately duplicated in Durations and Rests. -gp There is no fundamental limit to rest durations (both in terms of longest and shortest), but the number of glyphs is limited: there @@ -764,7 +755,6 @@ any kind. \skip 1 \skip1 \skip 1 @end lilypond - @seealso Learning Manual: @rlearning{Visibility and color of objects}. @@ -941,7 +931,6 @@ setting, resulting bar-check warnings may not be displayed. @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {multi-measure-rest-markup.ly} - @seealso Music Glossary: @rglos{multi-measure rest}. @@ -960,7 +949,6 @@ Internals Reference: @rinternals{MultiMeasureRestNumber}, @rinternals{MultiMeasureRestText}. - @cindex fingerings and multi-measure rests @cindex multi-measure rests and fingerings @@ -979,6 +967,7 @@ into a single multi-measure rest. Multi-measure rests do not take part in rest collisions. + @node Displaying rhythms @subsection Displaying rhythms @@ -1214,7 +1203,6 @@ for different staves by moving the @code{Timing_translator} and the @lilypondfile[verbatim,quote,texidoc,doctitle] {time-signature-printing-only-the-numerator-as-a-number-instead-of-the-fraction.ly} - @seealso Music Glossary: @rglos{time signature} @@ -1230,6 +1218,7 @@ Internals Reference: @rinternals{TimeSignature}, @rinternals{Timing_translator}. + @node Metronome marks @unnumberedsubsubsec Metronome marks @@ -1305,7 +1294,6 @@ d4 g e c For more details, see @ref{Formatting text}. - @seealso Music Glossary: @rglos{metronome}, @@ -1409,6 +1397,7 @@ e8 | a4 c8 b[ c b] | r8 e,8 | a4 c8 b[ c b] | @end lilypond + @node Unmetered music @unnumberedsubsubsec Unmetered music @@ -1480,7 +1469,6 @@ shown in @ref{Polymetric notation}. @code{\cadenzaOff}. @endpredefined - @seealso Music Glossary: @rglos{cadenza}. @@ -1493,7 +1481,6 @@ Notation Reference: Snippets: @rlsr{Rhythms}. - @cindex cadenza line breaks @cindex cadenza page breaks @cindex unmetered music, line breaks @@ -1505,7 +1492,6 @@ Snippets: @cindex page breaks in unmetered music @knownissues - LilyPond will insert line breaks and page breaks only at a bar line. Unless the unmetered music ends before the end of the staff line, you will need to insert invisible bar lines with @@ -1700,7 +1686,6 @@ Internals Reference: @rinternals{Default_bar_line_engraver}, @rinternals{Staff}. - @knownissues When using different time signatures in parallel, notes at the same moment will be placed at the same horizontal location. However, the bar @@ -1708,6 +1693,7 @@ lines in the different staves will cause the note spacing to be less regular in each of the individual staves than would be normal without the different time signatures. + @node Automatic note splitting @unnumberedsubsubsec Automatic note splitting @@ -1744,7 +1730,6 @@ inserts ties for notes. One of its uses is to debug complex scores: if the measures are not entirely filled, then the ties show exactly how much each measure is off. - @seealso Music Glossary: @rglos{tie} @@ -1763,9 +1748,7 @@ Internals Reference: @rinternals{Completion_rest_engraver}, @rinternals{Forbid_line_break_engraver}. - @knownissues - Not all durations (especially those containing tuplets) can be represented exactly with normal notes and dots, but the @code{Completion_heads_engraver} will not insert tuplets. @@ -1849,7 +1832,6 @@ be done with the @code{Pitch_squash_engraver} and @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {guitar-strum-rhythms.ly} - @seealso Snippets: @rlsr{Rhythms}. @@ -2237,7 +2219,6 @@ The default beaming rules can be found in @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {beam-endings-in-score-context.ly} - @seealso Installed Files: @file{scm/beam-settings.scm}. @@ -2251,7 +2232,6 @@ Internals Reference: @rinternals{BeamForbidEvent}, @rinternals{beam-interface}. - @knownissues If a score ends while an automatic beam has not been ended and is still accepting notes, this last beam will not be typeset at all. @@ -2306,6 +2286,7 @@ beaming settings for a time signature are described in >> @end lilypond + @node Manual beams @unnumberedsubsubsec Manual beams @@ -2390,7 +2371,6 @@ g16 a] @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {flat-flags-and-beam-nibs.ly} - @seealso Notation Reference: @ref{Direction and placement}, @@ -2458,7 +2438,6 @@ the last four 32nd notes are at a constant tempo. The spacing in the printed output represents the note durations only approximately, but the MIDI output is exact. - @predefined @code{\featherDurations}. @endpredefined @@ -2467,9 +2446,7 @@ note durations only approximately, but the MIDI output is exact. Snippets: @rlsr{Rhythms}. - @knownissues - The @code{\featherDurations} command only works with very short music snippets, and when numbers in the fraction are small. @@ -2477,7 +2454,6 @@ music snippets, and when numbers in the fraction are small. @node Bars @subsection Bars - @menu * Bar lines:: * Bar numbers:: @@ -2717,7 +2693,6 @@ The default bar type used for automatically inserted bar lines is @code{"|"}. This may be changed at any time with @samp{\set Timing.defaultBarType = @var{bartype}}. - @seealso Notation Reference: @ref{Line breaking}, @@ -2904,7 +2879,6 @@ example, will print a warning if the @code{currentBarNumber} is not 123 when it is processed. - @seealso Snippets: @rlsr{Rhythms}. @@ -3048,6 +3022,10 @@ For common tweaks to the positioning of rehearsal marks, see @ref{Formatting text}. For more precise control, see @code{break-alignable-interface} in @ref{Aligning objects}. +The file @file{scm/translation-functions.scm} contains +the definitions of @code{format-mark-numbers} and +@code{format-mark-letters}. They can be used as inspiration for +other formatting functions. @seealso Notation Reference: @@ -3056,10 +3034,7 @@ Notation Reference: @ref{Aligning objects}. Installed Files: -@file{scm/translation-functions.scm} contains -the definitions of @code{format-mark-numbers} and -@code{format-mark-letters}. They can be used as inspiration for -other formatting functions. +@file{scm/translation-functions.scm}. Snippets: @rlsr{Rhythms}. @@ -3220,7 +3195,6 @@ direction is overridden and then reverted. @lilypondfile[verbatim,quote,texidoc,doctitle] {positioning-grace-notes-with-floating-space.ly} - @seealso Music Glossary: @rglos{grace notes}, @@ -3228,6 +3202,7 @@ Music Glossary: @rglos{appoggiatura}. Notation Reference: +@ref{Scaling durations}, @ref{Manual beams}. Installed Files: @@ -3244,7 +3219,6 @@ Internals Reference: @knownissues - @cindex acciaccatura, multi-note @cindex multi-note acciaccatura @cindex grace-note synchronization @@ -3371,7 +3345,6 @@ MyCadenza = \relative c' { >> @end lilypond - @seealso Music Glossary: @rglos{cadenza}. @@ -3456,7 +3429,6 @@ duration of n/m of a whole note. For example, @code{ly:make-moment 7 16} is the duration of seven sixteenths notes. - @seealso Notation Reference: @ref{Bar numbers}, @@ -3468,4 +3440,3 @@ Snippets: Internals Reference: @rinternals{Timing_translator}, @rinternals{Score}. - diff --git a/Documentation/notation/simultaneous.itely b/Documentation/notation/simultaneous.itely index 00740cdfce..90669730a7 100644 --- a/Documentation/notation/simultaneous.itely +++ b/Documentation/notation/simultaneous.itely @@ -130,6 +130,7 @@ enharmonic transcription of one or more pitches, @end itemize + @node Chord repetition @unnumberedsubsubsec Chord repetition @@ -301,7 +302,6 @@ Ordinary notes and clusters can be put together in the same staff, even simultaneously. In such a case no attempt is made to automatically avoid collisions between ordinary notes and clusters. - @seealso Music Glossary: @rglos{cluster}. @@ -314,9 +314,7 @@ Internals Reference: @rinternals{ClusterSpannerBeacon}, @rinternals{Cluster_spanner_engraver}. - @knownissues - Clusters look good only if they span at least two chords; otherwise they appear too narrow. @@ -327,6 +325,7 @@ separating rest between them. Clusters do not produce MIDI output. + @node Multiple voices @subsection Multiple voices @@ -538,9 +537,6 @@ music do not have the same rhythm. @code{\oneVoice}. @endpredefined -Snippets: -@rlsr{Simultaneous notes}. - @seealso Learning Manual: @rlearning{Voices contain music}, @@ -551,6 +547,9 @@ Notation Reference: @ref{Invisible rests}, @ref{Stems}. +Snippets: +@rlsr{Simultaneous notes}. + @node Voice styles @unnumberedsubsubsec Voice styles @@ -591,7 +590,6 @@ standard presentation. @code{\voiceNeutralStyle}. @endpredefined - @seealso Learning Manual: @rlearning{I'm hearing Voices}, @@ -835,6 +833,7 @@ The requirements for successfully merging different note heads that are at the same time differently dotted are not clear. @end ignore + @node Automatic part combining @unnumberedsubsubsec Automatic part combining @@ -1001,7 +1000,6 @@ instrumentTwo = \relative c' { @lilypondfile[verbatim,quote,texidoc,doctitle] {changing-partcombine-texts.ly} - @seealso Music Glossary: @rglos{a due}, @@ -1018,7 +1016,6 @@ Internals Reference: @rinternals{Voice}. @knownissues - All @code{\partcombine...} functions can only accept two voices and are not designed to work with lyrics; such that when one of the voices is explicitly named in order to attach lyrics to it, the partcombiner will @@ -1163,7 +1160,6 @@ global = { } @end lilypond - @seealso Learning Manual: @rlearning{Organizing pieces with variables}. diff --git a/Documentation/notation/spacing.itely b/Documentation/notation/spacing.itely index 6b7f49e6bb..849b24b6c7 100644 --- a/Documentation/notation/spacing.itely +++ b/Documentation/notation/spacing.itely @@ -365,7 +365,6 @@ Snippets: @rlsr{Spacing}. @knownissues - The titles (from the @code{\header} block) are treated as a system, so @code{ragged-bottom} and @code{ragged-last-bottom} will add space between the titles and the first system of the score. @@ -680,7 +679,6 @@ Installed Files: @file{ly/paper-defaults-init.ly}. @knownissues - Explicitly defined paper-sizes will override any user-defined left or right margin settings. @@ -991,7 +989,6 @@ sensible default, for example: @end table - @seealso Installed Files: @file{ly/titling-init.ly}. @@ -999,9 +996,7 @@ Installed Files: Snippets: @rlsr{Spacing}. - @knownissues - The default page header puts the page number and the @code{instrument} field from the @code{\header} block on a line. @@ -1078,7 +1073,6 @@ Here is an example @code{\layout} block: @} @end example - @seealso Notation Reference: @ref{Changing context default settings}. @@ -1180,7 +1174,6 @@ These fonts are available in any sizes. The context property @rinternals{StaffSymbol}) can be used to tune the size for individual staves. The sizes of individual staves are relative to the global size. - @seealso Notation Reference: @ref{Selecting notation font size}. @@ -1188,9 +1181,7 @@ Notation Reference: Snippets: @rlsr{Spacing}. - @knownissues - @code{layout-set-staff-size} does not change the distance between the staff lines. @@ -1329,7 +1320,6 @@ complicated. More details are available in @code{\noBreak}. @endpredefined - @seealso Notation Reference: @ref{\paper variables for line breaking}. @@ -1414,7 +1404,6 @@ book parts. @code{\noPageBreak}. @endpredefined - @seealso Notation Reference: @ref{\paper variables for page breaking}. @@ -1433,7 +1422,6 @@ determining page breaks. It attempts to find a page breaking that minimizes cramping and stretching, both horizontally and vertically. Unlike @code{ly:page-turn-breaking}, it has no concept of page turns. - @seealso Snippets: @rlsr{Spacing}. @@ -1504,7 +1492,6 @@ The page turning commands, @code{\pageTurn}, @code{\noPageTurn} and @code{\allowPageTurn}, may also be used at top-level, between scores and top-level markups. - @predefined @funindex \pageTurn @code{\pageTurn}, @@ -1514,14 +1501,11 @@ top-level markups. @code{\allowPageTurn}. @endpredefined - @seealso Snippets: @rlsr{Spacing}. - @knownissues - There should only be one @code{Page_turn_engraver} in a score. If there is more than one, they will interfere with each other. @@ -1543,7 +1527,6 @@ too slow or memory demanding, or a lot of texts. It is enabled using: @} @end example - @seealso Snippets: @rlsr{Spacing}. @@ -1595,7 +1578,6 @@ music = \relative c'' { c8 c c c } } @end lilypond - @seealso Snippets: @rlsr{Spacing}. @@ -1682,7 +1664,6 @@ music = \relative c'' { c4 c c c } } @end lilypond - @seealso Notation Reference: @ref{Vertical spacing}. @@ -2043,15 +2024,15 @@ Notation Reference: @ref{Flexible vertical spacing \paper variables}, @ref{Modifying alists}. +Installed Files: +@file{ly/engraver-init.ly}, +@file{scm/define-grobs.scm}. + Internals Reference: @rinternals{Contexts}, @rinternals{VerticalAxisGroup}, @rinternals{StaffGrouper}. -Installed Files: -@file{ly/engraver-init.ly}, -@file{scm/define-grobs.scm}. - @node Spacing of ungrouped staves @unnumberedsubsubsec Spacing of ungrouped staves @@ -2253,7 +2234,6 @@ able to stretch much more than usual: >> @end lilypond - @seealso Installed Files: @file{ly/engraver-init.ly}, @@ -2497,7 +2477,6 @@ to print staves or systems on top of one another. Reasonable values passed to these different settings will avoid this. @end itemize - @seealso Snippets: @rlsr{Spacing}. @@ -2582,7 +2561,6 @@ c4 c''2 @end lilypond - @seealso Snippets: @rlsr{Spacing}. @@ -2691,8 +2669,10 @@ once with exaggerated corrections: Proportional notation is supported; see @ref{Proportional notation}. - @seealso +Essay on automated music engraving: +@ressay{Optical spacing}. + Snippets: @rlsr{Spacing}. @@ -2702,15 +2682,11 @@ Internals Reference: @rinternals{StaffSpacing}, @rinternals{NonMusicalPaperColumn}. -Essay on automated music engraving: -@ressay{Optical spacing}. - - @knownissues - There is no convenient mechanism to manually override spacing. The following work-around may be used to insert extra space into a score, adjusting the padding value as necessary. + @example \override Score.NonMusicalPaperColumn #'padding = #10 @end example @@ -2741,7 +2717,6 @@ The @code{\newSpacingSection} command creates a new @code{SpacingSpanner} object, and hence new @code{\override}s may be used in that location. - @seealso Snippets: @rlsr{Spacing}. @@ -2833,7 +2808,6 @@ regard for clefs, bar lines, and grace notes, \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] } @end lilypond - @seealso Snippets: @rlsr{Spacing}. @@ -2887,7 +2861,6 @@ paragraph, the last line simply takes its natural horizontal length. @} @end example - @seealso Snippets: @rlsr{Spacing}. @@ -3274,7 +3247,6 @@ mark both rhythmic start- and stop-points, and allow spanning elements to break across systems and pages. See the respective parts of the manual for these related settings. - @seealso Notation Reference: @ref{New spacing area}. @@ -3349,7 +3321,6 @@ of @code{a6} paper in landscape orientation. The pairs (@var{a},@var{b}) are intervals, where @var{a} is the lower edge and @var{b} the upper edge of the interval. - @seealso Notation Reference: @ref{Setting the staff size}. @@ -3459,7 +3430,6 @@ block so that it applies to the whole score. @end itemize - @seealso Notation Reference: @ref{Page layout}, diff --git a/Documentation/notation/staff.itely b/Documentation/notation/staff.itely index 7093338b96..a8111bd7c4 100644 --- a/Documentation/notation/staff.itely +++ b/Documentation/notation/staff.itely @@ -116,7 +116,6 @@ notate modern Gregorian chant. It does not show bar lines. New single staff contexts may be defined. For details, see @ref{Defining new contexts}. - @seealso Music Glossary: @rglos{staff}, @@ -249,7 +248,6 @@ New staff group contexts may be defined. For details, see @lilypondfile[verbatim,quote,texidoc,doctitle] {mensurstriche-layout-bar-lines-between-the-staves.ly} - @seealso Music Glossary: @rglos{brace}, @@ -318,7 +316,6 @@ New nested staff group contexts can be defined. For details, see @lilypondfile[verbatim,quote,texidoc,doctitle] {nesting-staves.ly} - @seealso Notation Reference: @ref{Grouping staves}, @@ -336,6 +333,7 @@ Internals Reference: @rinternals{SystemStartBracket}, @rinternals{SystemStartSquare}. + @node Separating systems @unnumberedsubsubsec Separating systems @@ -697,7 +695,6 @@ break. For more information about @lilypondfile[verbatim,quote,texidoc,doctitle] {vertically-aligning-ossias-and-lyrics.ly} - @seealso Music Glossary: @rglos{ossia}, @@ -807,7 +804,6 @@ hide empty staves in ancient music contexts. Similarly, @lilypondfile[verbatim,quote,texidoc,doctitle] {removing-the-first-empty-line.ly} - @seealso Music Glossary: @rglos{Frenched staff}. @@ -834,9 +830,7 @@ Internals Reference: @rinternals{VerticalAxisGroup}, @rinternals{Staff_symbol_engraver}. - @knownissues - Removing @code{Staff_symbol_engraver} also hides bar lines. If bar line visibility is forced, formatting errors may occur. In this case, use the following overrides instead of removing the @@ -851,6 +845,7 @@ For the Known issues and warnings associated with @code{\Staff \RemoveEmptyStaves} see @ref{Changing context default settings}. + @node Writing parts @subsection Writing parts @@ -1027,7 +1022,6 @@ expression to declare the instrument switch: } @end lilypond - @seealso Notation Reference: @ref{\paper variables for shifts and indents}, @@ -1185,6 +1179,9 @@ Notation Reference: @ref{Instrument transpositions}, @ref{Using tags}. +Installed Files: +@file{scm/define-event-classes.scm}. + Snippets: @rlsr{Staff notation}. @@ -1193,10 +1190,6 @@ Internals Reference: @rinternals{QuoteMusic}, @rinternals{Voice}. -Installed Files: -@file{scm/define-event-classes.scm}. - - @knownissues Only the contents of the first @code{Voice} occurring in an @code{\addQuote} command will be considered for quotation, so if the music @@ -1491,7 +1484,6 @@ Alternatively, Clef changes and instrument labels can be collected into an instrument definition for repeated use, using @code{\addInstrumentDefinition} described in @ref{Instrument names}. - @seealso Notation Reference: @ref{Quoting other voices}, @@ -1508,9 +1500,7 @@ Internals Reference: @rinternals{CueVoice}, @rinternals{Voice}. - @knownissues - Collisions can occur with rests, when using @code{\cueDuring}, between @code{Voice} and @code{CueVoice} contexts. When using @code{\cueDuringWithClef} or @code{\transposedCueDuring} the extra diff --git a/Documentation/notation/text.itely b/Documentation/notation/text.itely index a770eb1d9c..3ba9e554a6 100644 --- a/Documentation/notation/text.itely +++ b/Documentation/notation/text.itely @@ -98,7 +98,6 @@ articulations, see @rlearning{Placement of objects}. @code{\textLengthOff}. @endpredefined - @seealso Learning Manual: @rlearning{Placement of objects}. @@ -114,13 +113,11 @@ Snippets: Internals Reference: @rinternals{TextScript}. - @cindex text outside margin @cindex margin, text running over @cindex text, keeping inside margin @cindex lyrics, keeping inside margin - @knownissues Checking to make sure that text scripts and lyrics are within the margins requires additonal calculations. In cases where slightly faster @@ -283,7 +280,6 @@ c c @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {printing-marks-on-every-staff.ly} - @seealso Notation Reference: @ref{Rehearsal marks}, @@ -362,7 +358,6 @@ requires, are described in @ref{Multi-page markup}. @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {stand-alone-two-column-markup.ly} - @seealso Notation Reference: @ref{Formatting text}, @@ -482,7 +477,6 @@ allegro = \markup { \bold \large Allegro } An exhaustive list of @code{\markup}-specific commands can be found in @ref{Text markup commands}. - @seealso Notation Reference: @ref{Text markup commands}. @@ -493,7 +487,6 @@ Snippets: Installed Files: @file{scm/markup.scm}. - @knownissues Syntax errors for markup mode can be confusing. @@ -671,7 +664,6 @@ Defining custom font sets is also possible, as explained in @code{\larger}. @endpredefined - @seealso Notation Reference: @ref{Font}, @@ -679,15 +671,15 @@ Notation Reference: @ref{Manual repeat marks}, @ref{Fonts}. +Installed Files: +@file{scm/define-markup-commands.scm}. + Snippets: @rlsr{Text}. Internals Reference: @rinternals{TextScript}. -Installed Files: -@file{scm/define-markup-commands.scm}. - @knownissues Using the font sizing commands @code{\teeny}, @code{\tiny}, @code{\small}, @code{\normalsize}, @code{\large}, and @@ -933,7 +925,6 @@ as shown in the following example. An exhaustive list of text alignment commands can be found in @ref{Align}. - @seealso Learning Manual: @rlearning{Moving objects}. @@ -942,15 +933,15 @@ Notation Reference: @ref{Align}, @ref{Text marks}. +Installed Files: +@file{scm/define-markup-commands.scm}. + Snippets: @rlsr{Text}. Internals Reference: @rinternals{TextScript}. -Installed Files: -@file{scm/define-markup-commands.scm}. - @node Graphic notation inside markup @unnumberedsubsubsec Graphic notation inside markup @@ -1117,23 +1108,22 @@ c An exhaustive list of graphics-specific commands can be found in @ref{Graphic}. - @seealso Notation Reference: @ref{Graphic}, @ref{Editorial annotations}, @ref{Align}. +Installed Files: +@file{scm/define-markup-commands.scm}, +@file{scm/stencil.scm}. + Snippets: @rlsr{Text}. Internals Reference: @rinternals{TextScript}. -Installed Files: -@file{scm/define-markup-commands.scm}, -@file{scm/stencil.scm}. - @node Music notation inside markup @unnumberedsubsubsec Music notation inside markup @@ -1250,24 +1240,23 @@ c d e f An exhaustive list of music notation related commands can be found in @ref{Music}. - @seealso Notation Reference: @ref{Music}, @ref{The Feta font}, @ref{Fonts explained}. +Installed Files: +@file{scm/define-markup-commands.scm}, +@file{scm/fret-diagrams.scm}, +@file{scm/harp-pedals.scm}. + Snippets: @rlsr{Text}. Internals Reference: @rinternals{TextScript}. -Installed Files: -@file{scm/define-markup-commands.scm}, -@file{scm/fret-diagrams.scm}, -@file{scm/harp-pedals.scm}. - @node Multi-page markup @unnumberedsubsubsec Multi-page markup @@ -1315,23 +1304,21 @@ a list of markup lists. An exhaustive list of markup list commands can be found in @ref{Text markup list commands}. - @seealso Notation Reference: -@ref{Text markup list commands}, - -Snippets: -@rlsr{Text}. +@ref{Text markup list commands}. -Extending: +Extending LilyPond: @rextend{New markup list command definition}. -Internals Reference: -@rinternals{TextScript}. - Installed Files: @file{scm/define-markup-commands.scm}. +Snippets: +@rlsr{Text}. + +Internals Reference: +@rinternals{TextScript}. @funindex \markuplist @funindex markuplist @@ -1450,7 +1437,6 @@ Although it is easy to switch between preconfigured fonts, it is also possible to use other fonts, as explained in the following sections: @ref{Single entry fonts} and @ref{Entire document fonts}. - @seealso Notation Reference: @ref{The Feta font}, @@ -1491,7 +1477,6 @@ operating system: lilypond -dshow-available-fonts x @end example - @seealso Notation Reference: @ref{Fonts explained}, @@ -1539,7 +1524,6 @@ explanation of fonts, see @ref{Fonts explained}. @c we don't do Helvetica / Courier, since GS incorrectly loads @c Apple TTF fonts - @seealso Notation Reference: @ref{Fonts explained}, diff --git a/Documentation/notation/unfretted-strings.itely b/Documentation/notation/unfretted-strings.itely index 76bf1ceb79..e421191772 100644 --- a/Documentation/notation/unfretted-strings.itely +++ b/Documentation/notation/unfretted-strings.itely @@ -65,7 +65,6 @@ added, see @ref{Arpeggio}. @end itemize - @seealso Learning Manual: @rlearning{String quartet}. @@ -120,7 +119,6 @@ a2^\markup { \small "sul A" } @code{\open}. @endpredefined - @seealso Notation Reference: @ref{Articulations and ornamentations}, @@ -189,7 +187,6 @@ dots are required. chord construct even if there is only a single note. Normally @code{@bs{}harmonicsOn} would be used in this situation.} - @seealso Music Glossary: @rglos{harmonics}. diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely index 1c3c59e086..c159c4cf18 100644 --- a/Documentation/notation/vocal.itely +++ b/Documentation/notation/vocal.itely @@ -91,6 +91,7 @@ Notation Reference: Snippets: @rlsr{Vocal music}. + @node Entering lyrics @unnumberedsubsubsec Entering lyrics @@ -224,7 +225,8 @@ Internals Reference: @rinternals{LyricText}. Snippets: -@rlsr{Text} +@rlsr{Text}. + @node Aligning lyrics to a melody @unnumberedsubsubsec Aligning lyrics to a melody @@ -339,7 +341,7 @@ Learning Manual: Notation Reference: @ref{Contexts explained}, -@ref{Automatic syllable durations}. +@ref{Automatic syllable durations}, @ref{Stanzas}, @ref{Manual syllable durations}, @ref{Dialogue over music}, @@ -348,6 +350,7 @@ Notation Reference: Internals Reference: @rinternals{Lyrics}. + @node Automatic syllable durations @unnumberedsubsubsec Automatic syllable durations @@ -513,6 +516,7 @@ Notation Reference: @ref{Keeping contexts alive}, @ref{Placing lyrics vertically}. + @node Manual syllable durations @unnumberedsubsubsec Manual syllable durations @@ -621,7 +625,6 @@ the tilde symbol (@code{~}) to get a lyric tie. } @end lilypond - @seealso Internals Reference: @rinternals{LyricCombineMusic}. @@ -827,7 +830,6 @@ Internals Reference: @rinternals{Tunable context properties}. @knownissues - Extender lines under melismata are not created automatically; they must be inserted manually with a double underscore. @@ -868,7 +870,6 @@ distance between two syllables) and the @code{minimum-length} (threshold below which hyphens are removed) properties of @code{LyricHyphen}. - @seealso Internals Reference: @rinternals{LyricExtender}, @@ -962,7 +963,6 @@ contraltoWords = \lyricmode { Con -- tral -- to words } } @end lilypond - @seealso Notation Reference: @ref{Placing lyrics vertically}. @@ -1102,6 +1102,7 @@ Notation Reference: @ref{Context layout order}, @ref{Creating contexts}. + @node Placing syllables horizontally @unnumberedsubsubsec Placing syllables horizontally @@ -2087,6 +2088,7 @@ Notation Reference: Snippets: @rlsr{Vocal music}. + @node Lead sheets @unnumberedsubsubsec Lead sheets @@ -2188,6 +2190,7 @@ Internals Reference: @rinternals{Lyrics}, @rinternals{PianoStaff}. + @node Score layouts for choral @unnumberedsubsubsec Score layouts for choral @@ -2499,6 +2502,7 @@ Notation Reference: Extending LilyPond: @rextend{Markup construction in Scheme}. + @node Musical cues @unnumberedsubsubsec Musical cues diff --git a/Documentation/notation/wind.itely b/Documentation/notation/wind.itely index a935aa121d..72bb5255f6 100644 --- a/Documentation/notation/wind.itely +++ b/Documentation/notation/wind.itely @@ -83,7 +83,6 @@ See @ref{Articulations and ornamentations}. @lilypondfile[verbatim,quote,texidoc,doctitle] {changing--flageolet-mark-size.ly} - @seealso Notation Reference: @ref{Breath marks}, @@ -120,7 +119,6 @@ Woodwind diagrams can be produced and are described in {recorder-fingering-chart.ly} @seealso - Notation Reference: @ref{Woodwind diagrams}. @@ -188,8 +186,8 @@ This can be indicated by @code{cflat} or @code{fflat}. Similarly, the piobaireachd high g can be written @code{gflat} when it occurs in light music. - @seealso +Snippets: @rlsr{Winds}. @@ -239,10 +237,11 @@ notation. } @end lilypond - @seealso +Snippets: @rlsr{Winds}. + @node Woodwinds @subsection Woodwinds @@ -420,12 +419,12 @@ require Scheme ability and may not be accessible to all users. {woodwind-diagrams-key-lists.ly} @seealso - Installed Files: @file{scm/define-woodwind-diagrams.scm}, @file{scm/display-woodwind-diagrams.scm}. -Snippets: @rlsr{Winds}. +Snippets: +@rlsr{Winds}. Internals Reference: @rinternals{TextScript},