]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
Docs: move option naming to howto-contribute.txt
authorJ William Piggott <elseifthen@gmx.com>
Sat, 24 Jun 2017 19:22:49 +0000 (15:22 -0400)
committerJ William Piggott <elseifthen@gmx.com>
Sat, 24 Jun 2017 19:22:49 +0000 (15:22 -0400)
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>
Documentation/howto-contribute.txt
Documentation/howto-usage-function.txt

index 245f9ab93df03a378e49f07dc8e37e1bc9a5690c..e63d390c4e3368729c10bc450be1848037a0df7f 100644 (file)
@@ -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
index 1c5c4b893bbc093d014405f73eec28bc3524961c..a666d44faef68e7113293b11b8c1df3f6b7eed70 100644 (file)
@@ -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.
-
-