From 7948117da5654311dba59b256d9a017d56877592 Mon Sep 17 00:00:00 2001 From: J William Piggott Date: Sat, 24 Jun 2017 15:22:49 -0400 Subject: 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 --- Documentation/howto-usage-function.txt | 28 ---------------------------- 1 file changed, 28 deletions(-) (limited to 'Documentation/howto-usage-function.txt') 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 '-' 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. - - -- cgit v1.2.3-55-g7522