Mirrors/fish-shell
2
0
Fork 0
mirror of https://github.com/fish-shell/fish-shell synced 2024-12-27 21:33:09 +00:00
Code Issues Projects Releases Packages Wiki Activity

docs synopsis: make all placeholder arguments uppercase

Browse source 
man(1) uses lowercase placeholders but we usually don't.  Additionally,
the new synopsis autoformatting only recognizes placeholders if they
are uppercase. Use uppercase for all placeholders.
This commit is contained in:
Johannes Altmanninger 2022-01-17 05:29:49 +01:00 committed by David Adam
parent c0d1e41313
commit 2a98b7a593
19 changed files with 28 additions and 28 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
doc_src/cmds/break.rst
View file

@ -8,7 +8,7 @@ Synopsis
.. synopsis:: .. synopsis::
loop_construct LOOP_CONSTRUCT
[COMMANDS ...] [COMMANDS ...]
break break
[COMMANDS ...] [COMMANDS ...]

2
doc_src/cmds/complete.rst
View file

@ -8,7 +8,7 @@ Synopsis
.. synopsis:: .. synopsis::
complete ((-c | --command) | (-p | --path)) COMMAND [options] complete ((-c | --command) | (-p | --path)) COMMAND [OPTIONS]
complete ((-C | --do-complete)) STRING complete ((-C | --do-complete)) STRING
Description Description

2
doc_src/cmds/contains.rst
View file

@ -8,7 +8,7 @@ Synopsis
.. synopsis:: .. synopsis::
contains [options] KEY [VALUES ...] contains [OPTIONS] KEY [VALUES ...]
Description Description
----------- -----------

4
doc_src/cmds/count.rst
View file

@ -8,8 +8,8 @@ Synopsis
.. synopsis:: .. synopsis::
count string1 string2 ... count STRING1 STRING2 ...
command | count COMMAND | count
count [...] < FILE count [...] < FILE
Description Description

2
doc_src/cmds/echo.rst
View file

@ -8,7 +8,7 @@ Synopsis
.. synopsis:: .. synopsis::
echo [options] [STRING] echo [OPTIONS] [STRING]
Description Description
----------- -----------

4
doc_src/cmds/exit.rst
View file

@ -9,12 +9,12 @@ Synopsis
.. synopsis:: .. synopsis::
exit [code] exit [CODE]
Description Description
----------- -----------
**exit** is a special builtin that causes the shell to exit. Either 255 or the *code* supplied is used, whichever is lesser. **exit** is a special builtin that causes the shell to exit. Either 255 or the *CODE* supplied is used, whichever is lesser.
Otherwise, the exit status will be that of the last command executed. Otherwise, the exit status will be that of the last command executed.
If exit is called while sourcing a file (using the :ref:`source <cmd-source>` builtin) the rest of the file will be skipped, but the shell itself will not exit. If exit is called while sourcing a file (using the :ref:`source <cmd-source>` builtin) the rest of the file will be skipped, but the shell itself will not exit.

2
doc_src/cmds/fish_add_path.rst
View file

@ -10,7 +10,7 @@ Synopsis
.. synopsis:: .. synopsis::
fish_add_path path ... fish_add_path path ...
fish_add_path [(-g | --global) | (-U | --universal) | (-P | --path)] [(-m | --move)] [(-a | --append) | (-p | --prepend)] [(-v | --verbose) | (-n | --dry-run)] paths ... fish_add_path [(-g | --global) | (-U | --universal) | (-P | --path)] [(-m | --move)] [(-a | --append) | (-p | --prepend)] [(-v | --verbose) | (-n | --dry-run)] PATHS ...
Description Description

2
doc_src/cmds/fish_opt.rst
View file

@ -9,7 +9,7 @@ Synopsis
.. synopsis:: .. synopsis::
fish_opt [--help] fish_opt [--help]
fish_opt [(-slor | --multiple-vals=) optname] fish_opt [(-slor | --multiple-vals=) OPTNAME]
Description Description
----------- -----------

2
doc_src/cmds/history.rst
View file

@ -9,7 +9,7 @@ Synopsis
.. synopsis:: .. synopsis::
history [search] [--show-time] [--case-sensitive] history [search] [--show-time] [--case-sensitive]
[--exact | --prefix | --contains] [--max n] [--null] [--reverse] [--exact | --prefix | --contains] [--max N] [--null] [--reverse]
[SEARCH_STRING ...] [SEARCH_STRING ...]
history delete [--case-sensitive] history delete [--case-sensitive]
[--exact | --prefix | --contains] SEARCH_STRING ... [--exact | --prefix | --contains] SEARCH_STRING ...

2
doc_src/cmds/not.rst
View file

@ -8,7 +8,7 @@ Synopsis
.. synopsis:: .. synopsis::
not COMMAND [options ...] not COMMAND [OPTIONS ...]
Description Description

2
doc_src/cmds/read.rst
View file

@ -8,7 +8,7 @@ Synopsis
.. synopsis:: .. synopsis::
read [options] [VARIABLE ...] read [OPTIONS] [VARIABLE ...]
Description Description
----------- -----------

2
doc_src/cmds/realpath.rst
View file

@ -9,7 +9,7 @@ Synopsis
.. synopsis:: .. synopsis::
realpath [options] PATH realpath [OPTIONS] PATH
Description Description
----------- -----------

4
doc_src/cmds/return.rst
View file

@ -9,13 +9,13 @@ Synopsis
.. synopsis:: .. synopsis::
return [n] return [N]
Description Description
----------- -----------
:program:`return` halts a currently running function. :program:`return` halts a currently running function.
The exit status is set to ``n`` if it is given. The exit status is set to ``N`` if it is given.
If :program:`return` is invoked outside of a function or dot script it is equivalent to exit. If :program:`return` is invoked outside of a function or dot script it is equivalent to exit.
It is often added inside of a conditional block such as an :ref:`if <cmd-if>` statement or a :ref:`switch <cmd-switch>` statement to conditionally stop the executing function and return to the caller; it can also be used to specify the exit status of a function. It is often added inside of a conditional block such as an :ref:`if <cmd-if>` statement or a :ref:`switch <cmd-switch>` statement to conditionally stop the executing function and return to the caller; it can also be used to specify the exit status of a function.

12
doc_src/cmds/set.rst
View file

@ -8,12 +8,12 @@ Synopsis
.. synopsis:: .. synopsis::
set [scope options] set [SCOPE_OPTIONS]
set [options] VARIABLE VALUES ... set [OPTIONS] VARIABLE VALUES ...
set [options] VARIABLE[INDICES] VALUES ... set [OPTIONS] VARIABLE[INDICES] VALUES ...
set (-q | --query) [scope options] VARIABLE ... set (-q | --query) [SCOPE_OPTIONS] VARIABLE ...
set (-e | --erase) [scope options] VARIABLE ... set (-e | --erase) [SCOPE_OPTIONS] VARIABLE ...
set (-e | --erase) [scope options] VARIABLE[INDICES] ... set (-e | --erase) [SCOPE_OPTIONS] VARIABLE[INDICES] ...
set (-S | --show) VARIABLE ... set (-S | --show) VARIABLE ...
Description Description

4
doc_src/cmds/source.rst
View file

@ -8,8 +8,8 @@ Synopsis
.. synopsis:: .. synopsis::
source FILE [arguments ...] source FILE [ARGUMENTS ...]
somecommand | source SOMECOMMAND | source
Description Description

2
doc_src/cmds/trap.rst
View file

@ -8,7 +8,7 @@ Synopsis
.. synopsis:: .. synopsis::
trap [options] [[ARG] REASON ... ] trap [OPTIONS] [[ARG] REASON ... ]
Description Description
----------- -----------

2
doc_src/cmds/type.rst
View file

@ -8,7 +8,7 @@ Synopsis
.. synopsis:: .. synopsis::
type [options] NAME [...] type [OPTIONS] NAME [...]
Description Description
----------- -----------

2
doc_src/cmds/ulimit.rst
View file

@ -8,7 +8,7 @@ Synopsis
.. synopsis:: .. synopsis::
ulimit [options] [limit] ulimit [OPTIONS] [LIMIT]
Description Description

2
doc_src/cmds/umask.rst
View file

@ -8,7 +8,7 @@ Synopsis
.. synopsis:: .. synopsis::
umask [options] [MASK] umask [OPTIONS] [MASK]
Description Description