From 167a8062a48ad79bc15f5c581d61719dc4950d6d Mon Sep 17 00:00:00 2001 From: Heikki Junes Date: Sun, 27 Jul 2003 11:28:03 +0000 Subject: [PATCH] Proofreaded (HJJ). --- Documentation/user/converters.itely | 32 +++++++-------- Documentation/user/lilypond-book.itely | 56 +++++++++++++------------- 2 files changed, 44 insertions(+), 44 deletions(-) diff --git a/Documentation/user/converters.itely b/Documentation/user/converters.itely index ef0fdcf46c..d29553cf7c 100644 --- a/Documentation/user/converters.itely +++ b/Documentation/user/converters.itely @@ -58,7 +58,7 @@ The following options can be given: Set the goal version of the conversion. It defaults to the latest available version. @item -h, --help - Print usage help + Print usage help. @end table @@ -104,30 +104,30 @@ The following options are supported by midi2ly: @table @code @item -a, --absolute-pitches - Print absolute pitches + Print absolute pitches. @item -d, --duration-quant=@var{DUR} - Quantise note durations on @var{DUR} + Quantise note durations on @var{DUR}. @item -e, --explicit-durations - Print explicit durations + Print explicit durations. @item -h,--help - Show summary of usage + Show summary of usage. @item -k, --key=@var{acc}[:@var{minor}] Set default key. @var{acc} > 0 sets number of sharps; @var{acc} < 0 - sets number of flats. A minor key is indicated by ":1" + sets number of flats. A minor key is indicated by ":1". @item -o, --output=@var{file} - Write output to @var{file} + Write output to @var{file}. @item -s, --start-quant=@var{DUR} - Quantise note starts on DUR + Quantise note starts on DUR. @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN} - Allow tuplet durations @var{DUR}*@var{NUM}/@var{DEN} + Allow tuplet durations @var{DUR}*@var{NUM}/@var{DEN}. @item -V, --verbose - Be verbose + Be verbose. @item -v, --version - Print version number + Print version number. @item -w, --warranty - Show warranty and copyright + Show warranty and copyright. @item -x, --text-lyrics - Treat every text as a lyric + Treat every text as a lyric. @end table @@ -148,7 +148,7 @@ It is invoked as follows: etf2ly [@var{option}]@dots{} @var{etf-file} @end example -The following options are supported by etf2ly. +The following options are supported by etf2ly: @table @code @item -h,--help this help @@ -172,7 +172,7 @@ etf2ly. Sequences of grace notes are ended improperly sometimes. ABC is a fairly simple ASCII based format. It is described at the abc site: @quotation -@uref{http://www.gre.ac.uk/~c.walshaw/abc2mtex/abc.txt} +@uref{http://www.gre.ac.uk/~c.walshaw/abc2mtex/abc.txt}. @end quotation abc2ly translates from ABC to LilyPond. It is invoked as follows: @@ -201,7 +201,7 @@ source file. If you say: This will cause the text following the keyword ``voices'' to be inserted into the current voice of the LilyPond output file. -Similarly: +Similarly, @example %%LY slyrics more words diff --git a/Documentation/user/lilypond-book.itely b/Documentation/user/lilypond-book.itely index 3ad9d47482..dcf9d68f2a 100644 --- a/Documentation/user/lilypond-book.itely +++ b/Documentation/user/lilypond-book.itely @@ -74,7 +74,7 @@ show two simple examples here. First a complete block: @end example @noindent -produces this music: +produces @lilypond c' d' e' f' g'2 g' @@ -87,7 +87,7 @@ Then the short version: @end example @noindent -and its music: +produces @lilypond[11pt]{ <> } @@ -113,7 +113,7 @@ music, so you can make a HTML document with embedded music. @section Integrating LaTeX and music -For La@TeX{}, music is entered like this: +For La@TeX{}, music is entered using @example \begin[options, go, here]@{lilypond@} @@ -133,7 +133,7 @@ or @end example Running lilypond-book yields a file that can be processed with -La@TeX{}. We show some examples here. +La@TeX{}. We show some examples here: @example \begin[26pt]@{lilypond@} @@ -142,7 +142,7 @@ La@TeX{}. We show some examples here. @end example @noindent -produces this music: +produces @lilypond[26pt] c' d' e' f' g'2 g'2 @@ -155,7 +155,7 @@ Then the short version: @end example @noindent -and its music: +produces @lilypond[11pt]{<>} @@ -184,7 +184,7 @@ The music will be surrounded by @code{\preLilypondExample} and @node Integrating HTML and music @section Integrating HTML and music -Music is entered like this: +Music is entered using @example @@ -193,8 +193,8 @@ Music is entered like this: @end example @noindent -lilypond-book will produce a HTML with appropriate image tags for the -music fragments. +of which lilypond-book will produce a HTML with appropriate image tags for the +music fragments: @example @@ -212,11 +212,11 @@ Some music in a line of text. @end example A special feature not (yet) available in other output formats, is the -@code{} tag, for example +@code{} tag, for example, @example trip.ly @end example -This runs @file{trip.ly} through ly2dvi (See also @ref{Invoking +This runs @file{trip.ly} through ly2dvi (see also @ref{Invoking ly2dvi}), and substitutes a preview image in the output. The image links to a separate HTML file, so clicking it will take the viewer to a menu, with links to images, midi and printouts. @@ -242,14 +242,14 @@ the short version of the music blocks: @code{ @@lilypond@{ CONTENTS @} } and @code{ \lilypond@{ CONTENTS @} } @item smallverbatim -Like @code{verbatim}, but in a smaller font. +works like @code{verbatim}, but in a smaller font. @item intertext="@var{text}" -Used in conjunction with @code{verbatim} option: This puts +is used in conjunction with @code{verbatim} option: This puts @var{text} between the code and the music (without indentation). @item filename="@var{filename}" -Save the LilyPond code to @var{filename}. By default, a hash value +saves the LilyPond code to @var{filename}. By default, a hash value of the code is used. @item 11pt @@ -290,40 +290,40 @@ of the code is used. @end lilypond @item raggedright -Produce naturally spaced lines (i.e., @code{raggedright = ##t}); this +produces naturally spaced lines (i.e., @code{raggedright = ##t}); this works well for small music fragments. @item multiline -The opposite of @code{singleline}: Justify and break lines. +is the opposite of @code{singleline}: it justifies and breaks lines. @item linewidth=@var{size}@var{unit} -Set linewidth to @var{size}, where @var{unit} = cm, mm, in, or pt. +sets linewidth to @var{size}, where @var{unit} = cm, mm, in, or pt. This option affects LilyPond output, not the text layout. @item notime -Do not print time signature. +prevents printing time signature. @item fragment @itemx nofragment -Override @command{lilypond-book} auto detection of what type of code is +overrides @command{lilypond-book} auto detection of what type of code is in the LilyPond block, voice contents or complete code. @item indent=@var{size}@var{unit} -Set indentation of the first music system to @var{size}, +sets indentation of the first music system to @var{size}, where @var{unit} = cm, mm, in, or pt. This option affects LilyPond, not the text layout. For single-line fragments the default is to use no indentation. @item noindent -Set indentation of the first music system to zero. This option +sets indentation of the first music system to zero. This option affects LilyPond, not the text layout. @item notexidoc -Do not include @code{texidoc}. This is only for Texinfo output. +prevents including @code{texidoc}. This is only for Texinfo output. In Texinfo, the music fragment is normally preceded by the @code{texidoc} field from the @code{\header}. The LilyPond test -documents are composed from small @file{.ly} files in this way, +documents are composed from small @file{.ly} files in this way: @example \header @{ @@ -333,15 +333,15 @@ documents are composed from small @file{.ly} files in this way, @end example @item quote -Instruct @command{lilypond-book} to put La@TeX{} and Texinfo output +instructs @command{lilypond-book} to put La@TeX{} and Texinfo output into a quotation block. @item printfilename -Prints the file name before the music example. Useful in conjunction +prints the file name before the music example. Useful in conjunction with @code{\lilypondfile}. @item relative, relative @var{N} -Use relative octave mode. By default, notes are specified relative +uses relative octave mode. By default, notes are specified relative central C. The optional integer argument specifies the octave of the starting note, where the default @code{1} is central C. @end table @@ -352,7 +352,7 @@ starting note, where the default @code{1} is central C. Running @command{lilypond-book} generates lots of small files that LilyPond will process. To avoid all that garbage in the source -directory, it is advisable to change to a temporary directory first, +directory, it is advisable to change to a temporary directory first: @example cd out && lilypond-book ../yourfile.tex @end example @@ -448,6 +448,6 @@ easier. @command{lilypond-book} processes all music fragments in one big run. The state of the GUILE interpreter is not reset between fragments; -this means that changes made to global GUILE definitions, e.g., done +this means that changes made to global GUILE definitions, e.g. done with @code{set!} or @code{set-cdr!}, can leak from one fragment into the next fragment. -- 2.39.5