diff --git a/doc_src/cmds/alias.rst b/doc_src/cmds/alias.rst index f4e3914e8..5fbb990df 100644 --- a/doc_src/cmds/alias.rst +++ b/doc_src/cmds/alias.rst @@ -16,6 +16,11 @@ Synopsis Description ----------- +.. only:: builder_man + + NOTE: This page documents the fish builtin ``alias``. + To see the documentation on any non-fish versions, use ``command man alias``. + ``alias`` is a simple wrapper for the ``function`` builtin, which creates a function wrapping a command. It has similar syntax to POSIX shell ``alias``. For other uses, it is recommended to define a :doc:`function `. If you want to ease your interactive use, to save typing, consider using an :doc:`abbreviation ` instead. diff --git a/doc_src/cmds/cd.rst b/doc_src/cmds/cd.rst index 4e3237cdb..d2de7c7ba 100644 --- a/doc_src/cmds/cd.rst +++ b/doc_src/cmds/cd.rst @@ -12,6 +12,12 @@ Synopsis Description ----------- + +.. only:: builder_man + + NOTE: This page documents the fish builtin ``cd``. + To see the documentation on any non-fish versions, use ``command man cd``. + ``cd`` changes the current working directory. If *DIRECTORY* is given, it will become the new directory. If no parameter is given, the :envvar:`HOME` environment variable will be used. diff --git a/doc_src/cmds/command.rst b/doc_src/cmds/command.rst index 105c7dcf2..1653a6b8b 100644 --- a/doc_src/cmds/command.rst +++ b/doc_src/cmds/command.rst @@ -13,6 +13,11 @@ Synopsis Description ----------- +.. only:: builder_man + + NOTE: This page documents the fish builtin ``command``. + To see the documentation on any non-fish versions, use ``command man command``. + **command** forces the shell to execute the program *COMMANDNAME* and ignore any functions or builtins with the same name. In ``command foo``, ``command`` is a keyword. diff --git a/doc_src/cmds/echo.rst b/doc_src/cmds/echo.rst index 8157a6a52..e5a74d0ea 100644 --- a/doc_src/cmds/echo.rst +++ b/doc_src/cmds/echo.rst @@ -13,6 +13,11 @@ Synopsis Description ----------- +.. only:: builder_man + + NOTE: This page documents the fish builtin ``echo``. + To see the documentation on any non-fish versions, use ``command man echo``. + ``echo`` displays *STRING* of text. The following options are available: diff --git a/doc_src/cmds/exec.rst b/doc_src/cmds/exec.rst index e8fffdfcb..f16a45cfd 100644 --- a/doc_src/cmds/exec.rst +++ b/doc_src/cmds/exec.rst @@ -13,6 +13,11 @@ Synopsis Description ----------- +.. only:: builder_man + + NOTE: This page documents the fish builtin ``exec``. + To see the documentation on any non-fish versions, use ``command man exec``. + ``exec`` replaces the currently running shell with a new command. On successful completion, ``exec`` never returns. ``exec`` cannot be used inside a pipeline. The **--help** or **-h** option displays help about using this command. diff --git a/doc_src/cmds/jobs.rst b/doc_src/cmds/jobs.rst index 924632360..358a17a23 100644 --- a/doc_src/cmds/jobs.rst +++ b/doc_src/cmds/jobs.rst @@ -14,6 +14,11 @@ Synopsis Description ----------- +.. only:: builder_man + + NOTE: This page documents the fish builtin ``jobs``. + To see the documentation on any non-fish versions, use ``command man jobs``. + ``jobs`` prints a list of the currently running :ref:`jobs ` and their status. ``jobs`` accepts the following options: diff --git a/doc_src/cmds/printf.rst b/doc_src/cmds/printf.rst index 66bfff2be..8da7408b6 100644 --- a/doc_src/cmds/printf.rst +++ b/doc_src/cmds/printf.rst @@ -16,8 +16,7 @@ Description .. only:: builder_man NOTE: This page documents the fish builtin ``printf``. - To see the documentation on the ``printf`` command you might have, - use ``command man printf``. + To see the documentation on any non-fish versions, use ``command man printf``. ``printf`` uses the format string *FORMAT* to print the *ARGUMENT* arguments. This means that it takes format specifiers in the format string and replaces each with an argument. diff --git a/doc_src/cmds/pwd.rst b/doc_src/cmds/pwd.rst index d094374ef..565426a54 100644 --- a/doc_src/cmds/pwd.rst +++ b/doc_src/cmds/pwd.rst @@ -18,8 +18,7 @@ Description .. only:: builder_man NOTE: This page documents the fish builtin ``pwd``. - To see the documentation on the ``pwd`` command you might have, - use ``command man pwd``. + To see the documentation on any non-fish versions, use ``command man pwd``. ``pwd`` outputs (prints) the current working directory. diff --git a/doc_src/cmds/read.rst b/doc_src/cmds/read.rst index bb9a5fcad..31b859956 100644 --- a/doc_src/cmds/read.rst +++ b/doc_src/cmds/read.rst @@ -13,6 +13,11 @@ Synopsis Description ----------- +.. only:: builder_man + + NOTE: This page documents the fish builtin ``read``. + To see the documentation on any non-fish versions, use ``command man read``. + ``read`` reads from standard input and stores the result in shell variables. In an alternative mode, it can also print to its own standard output, for example for use in command substitutions. By default, ``read`` reads a single line and splits it into variables on spaces or tabs. Alternatively, a null character or a maximum number of characters can be used to terminate the input, and other delimiters can be given. diff --git a/doc_src/cmds/realpath.rst b/doc_src/cmds/realpath.rst index 3a41b4a0e..543389e15 100644 --- a/doc_src/cmds/realpath.rst +++ b/doc_src/cmds/realpath.rst @@ -17,8 +17,7 @@ Description .. only:: builder_man NOTE: This page documents the fish builtin ``realpath``. - To see the documentation on the ``realpath`` command you might have, - use ``command man realpath``. + To see the documentation on any non-fish versions, use ``command man realpath``. :program:`realpath` follows all symbolic links encountered for the provided :envvar:`PATH`, printing the absolute path resolved. :doc:`fish ` provides a :command:`realpath`-alike builtin intended to enrich systems where no such command is installed by default. diff --git a/doc_src/cmds/test.rst b/doc_src/cmds/test.rst index 506f86323..1194d1b5d 100644 --- a/doc_src/cmds/test.rst +++ b/doc_src/cmds/test.rst @@ -17,8 +17,7 @@ Description .. only:: builder_man NOTE: This page documents the fish builtin ``test``. - To see the documentation on the ``test`` command you might have, - use ``command man test``. + To see the documentation on any non-fish versions, use ``command man test``. ``test`` checks the given conditions and sets the exit status to 0 if they are true, 1 if they are false. diff --git a/doc_src/cmds/time.rst b/doc_src/cmds/time.rst index 63e5225c4..bd6db6241 100644 --- a/doc_src/cmds/time.rst +++ b/doc_src/cmds/time.rst @@ -16,8 +16,7 @@ Description .. only:: builder_man NOTE: This page documents the fish keyword ``time``. - To see the documentation on the ``time`` command you might have, - use ``command man time``. + To see the documentation on any non-fish versions, use ``command man time``. ``time`` causes fish to measure how long a command takes and print the results afterwards. The command can be a simple fish command or a block. The results can not currently be redirected. diff --git a/doc_src/cmds/trap.rst b/doc_src/cmds/trap.rst index 27630802c..5289c731f 100644 --- a/doc_src/cmds/trap.rst +++ b/doc_src/cmds/trap.rst @@ -13,6 +13,11 @@ Synopsis Description ----------- +.. only:: builder_man + + NOTE: This page documents the fish builtin ``trap``. + To see the documentation on any non-fish versions, use ``command man trap``. + ``trap`` is a wrapper around the fish event delivery framework. It exists for backwards compatibility with POSIX shells. For other uses, it is recommended to define an :ref:`event handler `. The following parameters are available: diff --git a/doc_src/cmds/type.rst b/doc_src/cmds/type.rst index 1e1b8e0e0..0f8c5ba9a 100644 --- a/doc_src/cmds/type.rst +++ b/doc_src/cmds/type.rst @@ -13,6 +13,11 @@ Synopsis Description ----------- +.. only:: builder_man + + NOTE: This page documents the fish builtin ``type``. + To see the documentation on any non-fish versions, use ``command man type``. + With no options, :command:`type` indicates how each *NAME* would be interpreted if used as a command name. The following options are available: diff --git a/doc_src/cmds/umask.rst b/doc_src/cmds/umask.rst index 3ebf608b3..1e0897dde 100644 --- a/doc_src/cmds/umask.rst +++ b/doc_src/cmds/umask.rst @@ -14,6 +14,11 @@ Synopsis Description ----------- +.. only:: builder_man + + NOTE: This page documents the fish builtin ``umask``. + To see the documentation on any non-fish versions, use ``command man umask``. + ``umask`` displays and manipulates the "umask", or file creation mode mask, which is used to restrict the default access to files. The umask may be expressed either as an octal number, which represents the rights that will be removed by default, or symbolically, which represents the only rights that will be granted by default. diff --git a/doc_src/cmds/wait.rst b/doc_src/cmds/wait.rst index 25cba5b10..7acce74a8 100644 --- a/doc_src/cmds/wait.rst +++ b/doc_src/cmds/wait.rst @@ -13,6 +13,11 @@ Synopsis Description ----------- +.. only:: builder_man + + NOTE: This page documents the fish builtin ``wait``. + To see the documentation on any non-fish versions, use ``command man wait``. + ``wait`` waits for child jobs to complete. If a *PID* is specified, the command waits for the job that the process with that process ID belongs to.