qiurui
/
glibc
mirror of git://sourceware.org/git/glibc.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Argument Syntax: Use "option", @option, and @command. 

Suggested-by: David O'Brien <daobrien@redhat.com>
This commit is contained in:
Carlos O'Donell 2020-10-27 20:28:20 -04:00
parent de1a9197af
commit d598134bfb
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
manual/startup.texi
View File

@ -125,13 +125,13 @@ Option names are single alphanumeric characters (as for @code{isalnum};
@pxref{Classification of Characters}). @pxref{Classification of Characters}).
@item @item
Certain options require an argument. For example, the @samp{-o} command Certain options require an argument. For example, the @option{-o} option
of the @code{ld} command requires an argument---an output file name. of the @command{ld} command requires an argument---an output file name.
@item @item
An option and its argument may or may not appear as separate tokens. (In An option and its argument may or may not appear as separate tokens. (In
other words, the whitespace separating them is optional.) Thus, other words, the whitespace separating them is optional.) Thus,
@w{@samp{-o foo}} and @samp{-ofoo} are equivalent. @w{@option{-o foo}} and @option{-ofoo} are equivalent.
@item @item
Options typically precede other non-option arguments. Options typically precede other non-option arguments.
@ -146,7 +146,7 @@ it, define the @code{_POSIX_OPTION_ORDER} environment variable.
@xref{Standard Environment}. @xref{Standard Environment}.
@item @item
The argument @samp{--} terminates all options; any following arguments The argument @option{--} terminates all options; any following arguments
are treated as non-option arguments, even if they begin with a hyphen. are treated as non-option arguments, even if they begin with a hyphen.
@item @item
@ -161,13 +161,13 @@ interpretation is left up to the particular application program.
@cindex long-named options @cindex long-named options
GNU adds @dfn{long options} to these conventions. Long options consist GNU adds @dfn{long options} to these conventions. Long options consist
of @samp{--} followed by a name made of alphanumeric characters and of @option{--} followed by a name made of alphanumeric characters and
dashes. Option names are typically one to three words long, with dashes. Option names are typically one to three words long, with
hyphens to separate words. Users can abbreviate the option names as hyphens to separate words. Users can abbreviate the option names as
long as the abbreviations are unique. long as the abbreviations are unique.
To specify an argument for a long option, write To specify an argument for a long option, write
@samp{--@var{name}=@var{value}}. This syntax enables a long option to @option{--@var{name}=@var{value}}. This syntax enables a long option to
accept an argument that is itself optional. accept an argument that is itself optional.
Eventually, @gnusystems{} will provide completion for long option names Eventually, @gnusystems{} will provide completion for long option names