But I'm sure there are plenty of other duplicate descriptions that
_should_ be factored. Any such patch would be very welcome.
I took a quick look, and the obvious things to factor are the
descriptions for the common switches. But I'm unsure if it is really
worth the effort, a lot of the programs have similar options, but they
all differ in some small detail. Like -i/--interactive example you
gave. Anyway, patch and ChangeLog applied. Note that it only
"macrofies" <10 options.
> @macro opt_interactive
btw, TeX macro names can't contain `_'.
Bah, crazy little language.
If someone could double check the ChangeLog then that would be great,
since I'm starting to get the nice side effects of being up all
night...
Index: doc/ChangeLog
2004-01-09 Alfred M. Szmidt <[EMAIL PROTECTED]>
* coreutils.texi: Include `options.texi'
(What information is listed): Use macro to describe
`--human-readable' (-h).
(cp invocation): Use macros to descibre
`--strip-trailing-slashes', --suffix' (-S),
`--target-directory', and `--version-control' (-V).
(install invocation): Use macros to descibre `--backup' (-b),
`--suffix' (-S), `--target-directory', and `--version-control'
(-V).
(mv invocation): Use macros to descibre `--backup' (-b),
`--strip-trailing-slashes', --suffix' (-S),
`--target-directory', and `--version-control' (-V).
(ln invocation): Use macros to descibre `--backup' (-b),
`--suffix' (-S), `--target-directory', and `--version-control'
(-V).
(df invocation): Use macros to describe `--human-readable'
(-h), and `--si' (-H).
(du invocation): Likewise.
* options.texi: New file.
Index: doc/coreutils.texi
--- doc/coreutils.texi
+++ doc/coreutils.texi
@@ -7,6 +7,7 @@
@include version.texi
@include constants.texi
[EMAIL PROTECTED] options.texi
@c Define new indices.
@defcodeindex op
@@ -5239,15 +5240,7 @@
(This is the default in some [EMAIL PROTECTED] versions of @command{ls}, so we
provide this option for compatibility.)
[EMAIL PROTECTED] -h
[EMAIL PROTECTED] --human-readable
[EMAIL PROTECTED] -h
[EMAIL PROTECTED] --human-readable
[EMAIL PROTECTED] human-readable output
-Append a size letter to each size, such as @samp{M} for mebibytes.
-Powers of 1024 are used, not 1000; @samp{M} stands for 1,048,576 bytes.
-This option is equivalent to @option{--block-size=human} (@pxref{Block size}).
-Use the @option{--si} option if you prefer powers of 1000.
[EMAIL PROTECTED]
@item -i
@itemx --inode
@@ -6234,11 +6227,7 @@
since such a file must not have any holes.
@end table
[EMAIL PROTECTED] @[EMAIL PROTECTED]
[EMAIL PROTECTED] --strip-trailing-slashes
[EMAIL PROTECTED] stripping trailing slashes
-Remove any trailing slashes from each @var{source} argument.
[EMAIL PROTECTED] slashes}.
[EMAIL PROTECTED]
@item -s
@itemx --symbolic-link
@@ -6250,19 +6239,9 @@
destination files are in the current directory. This option merely
results in an error message on systems that do not support symbolic links.
[EMAIL PROTECTED] -S @var{suffix}
[EMAIL PROTECTED] [EMAIL PROTECTED]
[EMAIL PROTECTED] -S
[EMAIL PROTECTED] --suffix
-Append @var{suffix} to each backup file made with @option{-b}.
[EMAIL PROTECTED] options}.
[EMAIL PROTECTED]
[EMAIL PROTECTED] @[EMAIL PROTECTED]@var{directory}}
[EMAIL PROTECTED] --target-directory
[EMAIL PROTECTED] target directory
[EMAIL PROTECTED] destination directory
-Specify the destination @var{directory}.
[EMAIL PROTECTED] directory}.
[EMAIL PROTECTED]
@item -v
@itemx --verbose
@@ -6270,14 +6249,7 @@
@opindex --verbose
Print the name of each file before copying it.
[EMAIL PROTECTED] -V @var{method}
[EMAIL PROTECTED] [EMAIL PROTECTED]
[EMAIL PROTECTED] -V
[EMAIL PROTECTED] --version-control
-Change the type of backups made with @option{-b}. The @var{method}
-argument can be @samp{none} (or @samp{off}), @samp{numbered} (or
[EMAIL PROTECTED]), @samp{existing} (or @samp{nil}), or @samp{never} (or
[EMAIL PROTECTED]). @xref{Backup options}.
[EMAIL PROTECTED]
@item -x
@itemx --one-file-system
@@ -6492,14 +6464,7 @@
@table @samp
[EMAIL PROTECTED] -b
[EMAIL PROTECTED] @[EMAIL PROTECTED]@var{method}]}
[EMAIL PROTECTED] -b
[EMAIL PROTECTED] --backup
[EMAIL PROTECTED] VERSION_CONTROL
[EMAIL PROTECTED] backups, making
[EMAIL PROTECTED] options}.
-Make a backup of each file that would otherwise be overwritten or removed.
[EMAIL PROTECTED]
@item -c
@opindex -c
@@ -6571,19 +6536,9 @@
@cindex stripping symbol table information
Strip the symbol tables from installed binary executables.
[EMAIL PROTECTED] -S @var{suffix}
[EMAIL PROTECTED] [EMAIL PROTECTED]
[EMAIL PROTECTED] -S
[EMAIL PROTECTED] --suffix
-Append @var{suffix} to each backup file made with @option{-b}.
[EMAIL PROTECTED] options}.
[EMAIL PROTECTED]
[EMAIL PROTECTED] @[EMAIL PROTECTED]@var{directory}}
[EMAIL PROTECTED] --target-directory
[EMAIL PROTECTED] target directory
[EMAIL PROTECTED] destination directory
-Specify the destination @var{directory}.
[EMAIL PROTECTED] directory}.
[EMAIL PROTECTED]
@item -v
@itemx --verbose
@@ -6591,14 +6546,7 @@
@opindex --verbose
Print the name of each file before copying it.
[EMAIL PROTECTED] -V @var{method}
[EMAIL PROTECTED] [EMAIL PROTECTED]
[EMAIL PROTECTED] -V
[EMAIL PROTECTED] --version-control
-Change the type of backups made with @option{-b}. The @var{method}
-argument can be @samp{none} (or @samp{off}), @samp{numbered} (or
[EMAIL PROTECTED]), @samp{existing} (or @samp{nil}), or @samp{never} (or
[EMAIL PROTECTED]). @xref{Backup options}.
[EMAIL PROTECTED]
@end table
@@ -6651,14 +6599,7 @@
@table @samp
[EMAIL PROTECTED] -b
[EMAIL PROTECTED] @[EMAIL PROTECTED]@var{method}]}
[EMAIL PROTECTED] -b
[EMAIL PROTECTED] --backup
[EMAIL PROTECTED] VERSION_CONTROL
[EMAIL PROTECTED] backups, making
[EMAIL PROTECTED] options}.
-Make a backup of each file that would otherwise be overwritten or removed.
[EMAIL PROTECTED]
@item -f
@itemx --force
@@ -6699,34 +6640,13 @@
@opindex --verbose
Print the name of each file before moving it.
[EMAIL PROTECTED] @[EMAIL PROTECTED]
[EMAIL PROTECTED] --strip-trailing-slashes
[EMAIL PROTECTED] stripping trailing slashes
-Remove any trailing slashes from each @var{source} argument.
[EMAIL PROTECTED] slashes}.
[EMAIL PROTECTED]
[EMAIL PROTECTED] -S @var{suffix}
[EMAIL PROTECTED] [EMAIL PROTECTED]
[EMAIL PROTECTED] -S
[EMAIL PROTECTED] --suffix
-Append @var{suffix} to each backup file made with @option{-b}.
[EMAIL PROTECTED] options}.
[EMAIL PROTECTED]
[EMAIL PROTECTED] @[EMAIL PROTECTED]@var{directory}}
[EMAIL PROTECTED] --target-directory
[EMAIL PROTECTED] target directory
[EMAIL PROTECTED] destination directory
-Specify the destination @var{directory}.
[EMAIL PROTECTED] directory}.
[EMAIL PROTECTED]
[EMAIL PROTECTED] -V @var{method}
[EMAIL PROTECTED] [EMAIL PROTECTED]
[EMAIL PROTECTED] -V
[EMAIL PROTECTED] --version-control
-Change the type of backups made with @option{-b}. The @var{method}
-argument can be @samp{none} (or @samp{off}), @samp{numbered} (or
[EMAIL PROTECTED]), @samp{existing} (or @samp{nil}), or @samp{never} (or
[EMAIL PROTECTED]). @xref{Backup options}.
[EMAIL PROTECTED]
@end table
@@ -7173,14 +7093,7 @@
@table @samp
[EMAIL PROTECTED] -b
[EMAIL PROTECTED] @[EMAIL PROTECTED]@var{method}]}
[EMAIL PROTECTED] -b
[EMAIL PROTECTED] --backup
[EMAIL PROTECTED] VERSION_CONTROL
[EMAIL PROTECTED] backups, making
[EMAIL PROTECTED] options}.
-Make a backup of each file that would otherwise be overwritten or removed.
[EMAIL PROTECTED]
@item -d
@itemx -F
@@ -7231,19 +7144,9 @@
Make symbolic links instead of hard links. This option merely produces
an error message on systems that do not support symbolic links.
[EMAIL PROTECTED] -S @var{suffix}
[EMAIL PROTECTED] [EMAIL PROTECTED]
[EMAIL PROTECTED] -S
[EMAIL PROTECTED] --suffix
-Append @var{suffix} to each backup file made with @option{-b}.
[EMAIL PROTECTED] options}.
[EMAIL PROTECTED]
[EMAIL PROTECTED] @[EMAIL PROTECTED]@var{directory}}
[EMAIL PROTECTED] --target-directory
[EMAIL PROTECTED] target directory
[EMAIL PROTECTED] destination directory
-Specify the destination @var{directory}.
[EMAIL PROTECTED] directory}.
[EMAIL PROTECTED]
@item -v
@itemx --verbose
@@ -7251,14 +7154,7 @@
@opindex --verbose
Print the name of each file before linking it.
[EMAIL PROTECTED] -V @var{method}
[EMAIL PROTECTED] [EMAIL PROTECTED]
[EMAIL PROTECTED] -V
[EMAIL PROTECTED] --version-control
-Change the type of backups made with @option{-b}. The @var{method}
-argument can be @samp{none} (or @samp{off}), @samp{numbered} (or
[EMAIL PROTECTED]), @samp{existing} (or @samp{nil}), or @samp{never} (or
[EMAIL PROTECTED]). @xref{Backup options}.
[EMAIL PROTECTED]
@end table
@@ -8163,24 +8059,9 @@
Scale sizes by @var{size} before printing them (@pxref{Block size}).
For example, @option{-BG} prints sizes in units of 1,073,741,824 bytes.
[EMAIL PROTECTED] -h
[EMAIL PROTECTED] --human-readable
[EMAIL PROTECTED] -h
[EMAIL PROTECTED] --human-readable
[EMAIL PROTECTED] human-readable output
-Append a size letter to each size, such as @samp{M} for mebibytes.
-Powers of 1024 are used, not 1000; @samp{M} stands for 1,048,576 bytes.
-Use the @option{-H} or @option{--si} option if you prefer powers of 1000.
[EMAIL PROTECTED]
[EMAIL PROTECTED] -H
[EMAIL PROTECTED] --si
[EMAIL PROTECTED] -H
[EMAIL PROTECTED] --si
[EMAIL PROTECTED] SI output
-Append an SI-style abbreviation to each size, such as @samp{MB} for
-megabytes. Powers of 1000 are used, not 1024; @samp{MB} stands for
-1,000,000 bytes. Use the @option{-h} or @option{--human-readable} option if
-you prefer powers of 1024.
[EMAIL PROTECTED]
@item -i
@itemx --inodes
@@ -8389,24 +8270,9 @@
out the disk usage of directories, such as @file{/usr/tmp}, which
are often symbolic links.
[EMAIL PROTECTED] -h
[EMAIL PROTECTED] --human-readable
[EMAIL PROTECTED] -h
[EMAIL PROTECTED] --human-readable
[EMAIL PROTECTED] human-readable output
-Append a size letter to each size, such as @samp{M} for mebibytes.
-Powers of 1024 are used, not 1000; @samp{M} stands for 1,048,576 bytes.
-Use the @option{-H} or @option{--si} option if you prefer powers of 1000.
[EMAIL PROTECTED]
[EMAIL PROTECTED] -H
[EMAIL PROTECTED] --si
[EMAIL PROTECTED] -H
[EMAIL PROTECTED] --si
[EMAIL PROTECTED] SI output
-Append an SI-style abbreviation to each size, such as @samp{MB} for
-megabytes. Powers of 1000 are used, not 1024; @samp{MB} stands for
-1,000,000 bytes. Use the @option{-h} or @option{--human-readable} option if
-you prefer powers of 1024.
[EMAIL PROTECTED]
@item -k
@opindex -k
Index: doc/options.texi
--- /dev/null
+++ doc/options.texi
@@ -0,0 +1,70 @@
[EMAIL PROTECTED] optBackup
[EMAIL PROTECTED] -b
[EMAIL PROTECTED] @[EMAIL PROTECTED]@var{method}]}
[EMAIL PROTECTED] -b
[EMAIL PROTECTED] --backup
[EMAIL PROTECTED] VERSION_CONTROL
[EMAIL PROTECTED] backups, making
[EMAIL PROTECTED] options}.
+Make a backup of each file that would otherwise be overwritten or removed.
[EMAIL PROTECTED] macro
+
[EMAIL PROTECTED] optAppendBackupSuffix
[EMAIL PROTECTED] -S @var{suffix}
[EMAIL PROTECTED] [EMAIL PROTECTED]
[EMAIL PROTECTED] -S
[EMAIL PROTECTED] --suffix
+Append @var{suffix} to each backup file made with @option{-b}.
[EMAIL PROTECTED] options}.
[EMAIL PROTECTED] macro
+
[EMAIL PROTECTED] optTargetDirectory
[EMAIL PROTECTED] @[EMAIL PROTECTED]@var{directory}}
[EMAIL PROTECTED] --target-directory
[EMAIL PROTECTED] target directory
[EMAIL PROTECTED] destination directory
+Specify the destination @var{directory}.
[EMAIL PROTECTED] directory}.
[EMAIL PROTECTED] macro
+
[EMAIL PROTECTED] optSi
[EMAIL PROTECTED] -H
[EMAIL PROTECTED] --si
[EMAIL PROTECTED] -H
[EMAIL PROTECTED] --si
[EMAIL PROTECTED] SI output
+Append an SI-style abbreviation to each size, such as @samp{MB} for
+megabytes. Powers of 1000 are used, not 1024; @samp{MB} stands for
+1,000,000 bytes. Use the @option{-h} or @option{--human-readable} option if
+you prefer powers of 1024.
[EMAIL PROTECTED] macro
+
[EMAIL PROTECTED] optHumanReadable
[EMAIL PROTECTED] -h
[EMAIL PROTECTED] --human-readable
[EMAIL PROTECTED] -h
[EMAIL PROTECTED] --human-readable
[EMAIL PROTECTED] human-readable output
+Append a size letter to each size, such as @samp{M} for mebibytes.
+Powers of 1024 are used, not 1000; @samp{M} stands for 1,048,576 bytes.
+Use the @option{-H} or @option{--si} option if you prefer powers of 1000.
[EMAIL PROTECTED] macro
+
[EMAIL PROTECTED] optStripTrailingSlashes
[EMAIL PROTECTED] @[EMAIL PROTECTED]
[EMAIL PROTECTED] --strip-trailing-slashes
[EMAIL PROTECTED] stripping trailing slashes
+Remove any trailing slashes from each @var{source} argument.
[EMAIL PROTECTED] slashes}.
[EMAIL PROTECTED] macro
+
[EMAIL PROTECTED] optVersionControl
[EMAIL PROTECTED] -V @var{method}
[EMAIL PROTECTED] [EMAIL PROTECTED]
[EMAIL PROTECTED] -V
[EMAIL PROTECTED] --version-control
+Change the type of backups made with @option{-b}. The @var{method}
+argument can be @samp{none} (or @samp{off}), @samp{numbered} (or
[EMAIL PROTECTED]), @samp{existing} (or @samp{nil}), or @samp{never} (or
[EMAIL PROTECTED]). @xref{Backup options}.
[EMAIL PROTECTED] macro
_______________________________________________
Bug-coreutils mailing list
[EMAIL PROTECTED]
http://mail.gnu.org/mailman/listinfo/bug-coreutils
