Minor clarifications and adding examples.

diff --git a/ChangeLog b/ChangeLog
index 6069655a68fd3326dae49b88dbebeca851a841a0..2a0e26913e5c515d6fece6ad5231ccc821aa21b2 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2004-11-13  Graham Percival  <gperlist@shaw.ca>
+
+       * Documentation/user/lilypond-book.itely: add small warning about
+       noindent default in lilypond-book.
+
+       * Documentation/user/converters.itely: add examples for convert-ly.
+
 2004-11-12  Karl Hammar  <karl@aspodata.se>
 
        * GNUmakefile.in (local-WWW-post): `find ...` overflows the

diff --git a/Documentation/user/converters.itely b/Documentation/user/converters.itely
index 93d0da1eb8aa1c0f42494d56b2427feb50f0d6aa..1e5c7d23006dd1c9b0dd87b3bafbe682ad9c739f 100644 (file)
--- a/Documentation/user/converters.itely
+++ b/Documentation/user/converters.itely
@@ -31,12 +31,20 @@ the program @command{convert-ly} can be used to deal with most of the
 syntax changes between LilyPond versions.
 
 It uses @code{\version} statements in the input files to detect the old
-version number.  For example, to upgrade all LilyPond files in the
-current directory and its subdirectories, enter the following on the
-command line.
+version number.  In most cases, to upgrade your input file it is sufficient
+to run
 
 @example
-convert-ly -e `find . -name '*.ly' -print`
+covert-ly -e MYFILE.ly
+@end example
+
+If there are no changes to MYFILE.ly and if a file called MYFILE.ly.NEW
+is created, then MYFILE.ly is already updated.
+
+To upgrade LilyPond fragments in texinfo files, use
+
+@example
+convert-ly --from=... --to=... --no-version *.itely
 @end example
 
 In general, the program is invoked as follows:

diff --git a/Documentation/user/lilypond-book.itely b/Documentation/user/lilypond-book.itely
index 8c8bc582455dfb684b6b749be1c9e5d5254dcaf4..5f7eb6a63b65a79bcfb8c7a220632e8e6fe53592 100644 (file)
--- a/Documentation/user/lilypond-book.itely
+++ b/Documentation/user/lilypond-book.itely
@@ -408,8 +408,7 @@ without @code{\layout}, @code{\score} or other red tape.
 @item indent=@var{size}\@var{unit}
 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.
+not the text layout.  The default is to use no indentation.
 
 For example
 @example