From: Jean-Charles Malahieude Date: Sat, 15 Jun 2013 09:46:26 +0000 (+0200) Subject: Doc: Use @dots{} instead of ... in Usage X-Git-Tag: release/2.17.21-1~15^2~2 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=45d0e015edc53abebada17a0fdb1d665f7edf900;p=lilypond.git Doc: Use @dots{} instead of ... in Usage --- diff --git a/Documentation/included/compile.itexi b/Documentation/included/compile.itexi index eb24c59180..94513ea936 100644 --- a/Documentation/included/compile.itexi +++ b/Documentation/included/compile.itexi @@ -562,7 +562,7 @@ sudo make install @end example @noindent -or... +or@dots{} @example su -c 'make install' @@ -605,7 +605,7 @@ make [-j@var{X} CPU_COUNT=@var{X}] doc-stage-1 @emph{## to build only PDF docum Edit/compile cycle: @example -@emph{## edit source files, then...} +@emph{## edit source files, then@dots{}} make [-j@var{X}] @emph{## needed if editing outside} @emph{## Documentation/, but useful anyway} @@ -1054,7 +1054,7 @@ Debian GNU/Linux If you want to use lilypond's python libraries (either running certain build scripts manually, or using them in other programs), set @code{PYTHONPATH} to @file{python/out} in your build -directory, or @file{.../usr/lib/lilypond/current/python} in the +directory, or @file{@dots{}/usr/lib/lilypond/current/python} in the installation directory structure. diff --git a/Documentation/usage/lilypond-book.itely b/Documentation/usage/lilypond-book.itely index 3bfa098934..65c5823d08 100644 --- a/Documentation/usage/lilypond-book.itely +++ b/Documentation/usage/lilypond-book.itely @@ -118,11 +118,11 @@ terminal run lilypond-book --output=out --pdf lilybook.lytex @emph{lilypond-book (GNU LilyPond) @version{} } @emph{Reading lilybook.lytex...} -@emph{..lots of stuff deleted..} +@emph{@dots{}lots of stuff deleted@dots{}} @emph{Compiling lilybook.tex...} cd out pdflatex lilybook -@emph{..lots of stuff deleted..} +@emph{@dots{}lots of stuff deleted@dots{}} xpdf lilybook @emph{(replace @command{xpdf} by your favorite PDF viewer)} @end example @@ -207,19 +207,19 @@ include music in @LaTeX{} files: @itemize @item -the @code{\lilypond@{...@}} command, where you can directly enter short -lilypond code +the @code{\lilypond@{@dots{}@}} command, where you can directly enter +short lilypond code @item -the @code{\begin@{lilypond@}...\end@{lilypond@}} environment, where you -can directly enter longer lilypond code +the @code{\begin@{lilypond@}@dots{}\end@{lilypond@}} environment, where +you can directly enter longer lilypond code @item -the @code{\lilypondfile@{...@}} command to insert a lilypond file +the @code{\lilypondfile@{@dots{}@}} command to insert a lilypond file @item -the @code{\musicxmlfile@{...@}} command to insert a MusicXML file, which -will be processed by @code{musicxml2ly} and @code{lilypond}. +the @code{\musicxmlfile@{@dots{}@}} command to insert a MusicXML file, +which will be processed by @code{musicxml2ly} and @code{lilypond}. @end itemize @@ -396,9 +396,9 @@ and then saying only how many systems you want before each fragment, @example \onlyFirstNSystems@{3@} -\begin@{lilypond@}...\end@{lilypond@} +\begin@{lilypond@}@dots{}\end@{lilypond@} \onlyFirstNSystems@{1@} -\begin@{lilypond@}...\end@{lilypond@} +\begin@{lilypond@}@dots{}\end@{lilypond@} @end example @@ -421,19 +421,19 @@ include music into Texinfo files: @itemize @item -the @code{@@lilypond@{...@}} command, where you can directly enter short -lilypond code +the @code{@@lilypond@{@dots{}@}} command, where you can directly enter +short lilypond code @item -the @code{@@lilypond...@@end lilypond} environment, where you can directly -enter longer lilypond code +the @code{@@lilypond@dots{}@@end lilypond} environment, where you can +directly enter longer lilypond code @item -the @code{@@lilypondfile@{...@}} command to insert a lilypond file +the @code{@@lilypondfile@{@dots{}@}} command to insert a lilypond file @item -the @code{@@musicxmlfile@{...@}} command to insert a MusicXML file, which -will be processed by @code{musicxml2ly} and @code{lilypond}. +the @code{@@musicxmlfile@{@dots{}@}} command to insert a MusicXML file, +which will be processed by @code{musicxml2ly} and @code{lilypond}. @end itemize @@ -486,7 +486,7 @@ produces @lilypond[fragment,staffsize=11]{} -Contrary to @LaTeX{}, @code{@@lilypond@{...@}} does not generate an +Contrary to @LaTeX{}, @code{@@lilypond@{@dots{}@}} does not generate an in-line image. It always gets a paragraph of its own. @@ -499,19 +499,21 @@ include music in HTML files: @itemize @item -the @code{} command, where you can directly enter short -lilypond code +the @code{} command, where you can directly enter +short lilypond code @item -the @code{...} environment, where you can directly -enter longer lilypond code +the @code{@dots{}} environment, where you can +directly enter longer lilypond code @item -the @code{...} command to insert a lilypond file +the @code{@dots{}} command to insert a +lilypond file @item -the @code{...} command to insert a MusicXML -file, which will be processed by @code{musicxml2ly} and @code{lilypond}. +the @code{@dots{}} command to insert a +MusicXML file, which will be processed by @code{musicxml2ly} and +@code{lilypond}. @end itemize @@ -544,7 +546,7 @@ tags for the music fragments: \key c \minor c4 es g2 @end lilypond -For inline pictures, use @code{}, where the options +For inline pictures, use @code{}, where the options are separated by a colon from the music, for example @example @@ -554,7 +556,7 @@ Some music in a line of text. To include separate files, say @example -@var{filename} +@var{filename} @end example @code{} uses the same syntax as @code{}, but @@ -998,7 +1000,7 @@ before running @command{latex} or @command{makeinfo}. @example lilypond-book --output=out yourfile.lytex cd out -... +@dots{} @end example @itemx --skip-lily-check diff --git a/Documentation/usage/running.itely b/Documentation/usage/running.itely index 303edd155b..46d1f86b63 100644 --- a/Documentation/usage/running.itely +++ b/Documentation/usage/running.itely @@ -648,7 +648,7 @@ more work to set up. See @ref{Basic command line options for LilyPond}. @item @code{separate-log-files} @tab @code{#f} @tab For input files @code{FILE1.ly}, @code{FILE2.ly}, etc. output log -data to files @code{FILE1.log}, @code{FILE2.log}, ... +data to files @code{FILE1.log}, @code{FILE2.log}@dots{} @item @code{show-available-fonts} @tab @code{#f} diff --git a/Documentation/usage/suggestions.itely b/Documentation/usage/suggestions.itely index 24a7bb2e76..2c6fcaca8f 100644 --- a/Documentation/usage/suggestions.itely +++ b/Documentation/usage/suggestions.itely @@ -130,7 +130,7 @@ best. variable, it is recommended that the notes are wrapped in @example -\transpose c natural-pitch @{...@} +\transpose c natural-pitch @{@dots{}@} @end example @noindent @@ -167,7 +167,7 @@ in a new version of LilyPond. violin = \relative c'' @{ g4 c'8. e16 @} -... +@dots{} \score @{ \new GrandStaff @{ \new Staff @{ @@ -177,12 +177,11 @@ g4 c'8. e16 @} @end example -@item @strong{Separate tweaks from music definitions}. This -point was made previously, but for large -projects it is absolutely vital. We might need to change -the definition of @code{fthenp}, but then we only need -to do this once, and we can still avoid touching anything -inside @code{violin}. +@item @strong{Separate tweaks from music definitions}. This point was +made previously, but for large projects it is absolutely vital. We +might need to change the definition of @code{fthenp}, but then we only +need to do this once, and we can still avoid touching anything inside +@code{violin}. @example fthenp = _\markup@{ @@ -205,7 +204,7 @@ investigation to determine the source of the problem. The most powerful tools for this purpose are the single line comment (indicated by @code{%}) and the block -comment (indicated by @code{%@{ ... %@}}). If you don't +comment (indicated by @code{%@{@dots{}%@}}). If you don't know where a problem is, start commenting out huge portions of your input file. After you comment out a section, try compiling the file again. If it works, then the problem diff --git a/Documentation/usage/updating.itely b/Documentation/usage/updating.itely index 18eae26ab6..e7a1e80d6e 100644 --- a/Documentation/usage/updating.itely +++ b/Documentation/usage/updating.itely @@ -165,13 +165,13 @@ convert-ly --to=2.14.1 myfile.ly To upgrade LilyPond fragments in texinfo files, use @example -convert-ly --from=... --to=... --no-version *.itely +convert-ly --from=@dots{} --to=@dots{} --no-version *.itely @end example To see the changes in the LilyPond syntax between two versions, use @example -convert-ly --from=... --to=... -s +convert-ly --from=@dots{} --to=@dots{} -s @end example