diff options
| author | J William Piggott | 2017-06-24 21:22:49 +0200 |
|---|---|---|
| committer | J William Piggott | 2017-06-24 21:22:49 +0200 |
| commit | 7948117da5654311dba59b256d9a017d56877592 (patch) | |
| tree | e86162164253894d4c6821af721f5e1ccc1edb1b /Documentation/howto-usage-function.txt | |
| parent | Docs: update howto-usage-function.txt (diff) | |
| download | kernel-qcow2-util-linux-7948117da5654311dba59b256d9a017d56877592.tar.gz kernel-qcow2-util-linux-7948117da5654311dba59b256d9a017d56877592.tar.xz kernel-qcow2-util-linux-7948117da5654311dba59b256d9a017d56877592.zip | |
Docs: move option naming to howto-contribute.txt
Creating and naming options is not done when writing usage().
A contributor may not even read howto-usage-function.txt, but
they should read howto-contribute.txt. So move option naming
and change information there.
Signed-off-by: J William Piggott <elseifthen@gmx.com>
Diffstat (limited to 'Documentation/howto-usage-function.txt')
| -rw-r--r-- | Documentation/howto-usage-function.txt | 28 |
1 files changed, 0 insertions, 28 deletions
diff --git a/Documentation/howto-usage-function.txt b/Documentation/howto-usage-function.txt index 1c5c4b893..a666d44fa 100644 --- a/Documentation/howto-usage-function.txt +++ b/Documentation/howto-usage-function.txt @@ -4,20 +4,6 @@ Example file Refer to the ./boilerplate.c example file while reading this howto. -Well-known options ------------------- - -The following options are well-known, and should not be used for any -other purpose: - - -h, --help display usage and exit - -V, --version display version and exit - -The rule of thumb with other options is that once they exist, you may -not change them, nor change how they work, nor remove them. - -See Legacy options below. - How a usage text is supposed to look ------------------------------------ @@ -146,17 +132,3 @@ define. The command author, package maintainer or patch submitter will usually know when it should be done that way. -Legacy options --------------- - -Some commands use peculiar options and arguments. These will continue -to be supported, but anything like them will not be accepted as new -additions. A short list of examples: - -- Characters other than '-' to start an option. See '+' in 'more'. -- Using a number as an option. See '-<number>' in 'more'. -- Long options that start with a single '-'. See 'setterm'. -- '-?' is not expected to be a synonym of '--help', but is an unknown - option resulting in a suggestion to try --help due to a getopt failure. - - |