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 | |
| 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>
| -rw-r--r-- | Documentation/howto-contribute.txt | 25 | ||||
| -rw-r--r-- | Documentation/howto-usage-function.txt | 28 |
2 files changed, 25 insertions, 28 deletions
diff --git a/Documentation/howto-contribute.txt b/Documentation/howto-contribute.txt index 245f9ab93..e63d390c4 100644 --- a/Documentation/howto-contribute.txt +++ b/Documentation/howto-contribute.txt @@ -3,6 +3,7 @@ CONTENTS Patching Process Email Format Coding Style + Options Various Notes Standards Compliance @@ -155,6 +156,30 @@ Coding Style multiple lines. In case the shorthand does not look good on one line use the normal "if () else" syntax. +Options + + * The rule of thumb for options is that once they exist, you may not + change them, nor change how they work, nor remove them. + + * 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 + + * 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 a synonym for '--help', but is an unknown option + resulting in a suggestion to try --help due to a getopt failure. + Various Notes * util-linux does not use kernel headers for file system super 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. - - |