From 8a23eef94ec7ab83e10646ab3502f2d82b888a03 Mon Sep 17 00:00:00 2001 From: James Lowe Date: Wed, 24 Oct 2012 12:57:50 +0100 Subject: [PATCH] Doc: AU add -d option for convert-ly Also rearranged options in alphabetical order. Added short form for -t Updated description for -l Issue 2917 --- Documentation/usage/updating.itely | 28 ++++++++++++++++++---------- 1 file changed, 18 insertions(+), 10 deletions(-) diff --git a/Documentation/usage/updating.itely b/Documentation/usage/updating.itely index 2075925c78..18eae26ab6 100644 --- a/Documentation/usage/updating.itely +++ b/Documentation/usage/updating.itely @@ -121,10 +121,13 @@ The program is invoked as follows: convert-ly [@var{option}]@dots{} @var{filename}@dots{} @end example - The following options can be given: @table @code +@item -d,--diff-version-update +update the @code{\version} to the latest or, if this is greater, do +nothing. + @item -e,--edit Apply the conversions direct to the input file, modifying it in-place. @@ -134,6 +137,14 @@ Set the version to convert from. If this is not set, @command{convert-ly} will guess this, on the basis of @code{\version} strings in the file. E.g. @option{--from=2.10.25} +@item -h, --help +Print usage help. + +@item -l @var{loglevel}, --loglevel=@var{loglevel} +Set the output verbosity to @var{loglevel}. Possible values, in upper +case, are @code{PROGRESS} (the default), @code{NONE}, @code{WARNING}, +@code{ERROR} and @code{DEBUG}. + @item -n,--no-version Normally, @command{convert-ly} adds a @code{\version} indicator to the output. Specifying this option suppresses this. @@ -141,16 +152,13 @@ to the output. Specifying this option suppresses this. @item -s, --show-rules Show all known conversions and exit. -@item --to=@var{to-patchlevel} -Set the goal version of the conversion. It defaults to the latest -available version. E.g. @option{--to=2.12.2} +@item -t, --to=@var{to-patchlevel} +Explicitly set which @code{\version} to convert to, otherwise the +default is the most current value. -@item -h, --help -Print usage help. - -@item -l @var{loglevel}, --loglevel=@var{loglevel} -Set the output verbosity to @var{loglevel}. Possible values are @code{NONE}, -@code{ERROR}, @code{WARNING}, @code{PROGRESS} (default) and @code{DEBUG}. +@example +convert-ly --to=2.14.1 myfile.ly +@end example @end table -- 2.39.2