From: Graham Percival <graham@percival-music.ca>
Date: Sun, 14 Nov 2004 00:26:04 +0000 (+0000)
Subject: Minor clarifications and adding examples.
X-Git-Tag: release/2.5.14~575
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=34e5aeaf43d2e9beceedf465e1ec06c7333e4f34;p=lilypond.git

Minor clarifications and adding examples.
---

diff --git a/ChangeLog b/ChangeLog
index 6069655a68..2a0e26913e 100644
--- 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 93d0da1eb8..1e5c7d2300 100644
--- 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 8c8bc58245..5f7eb6a63b 100644
--- 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