Mirrors/fish-shell
2
0
Fork 0
mirror of https://github.com/fish-shell/fish-shell synced 2024-12-28 05:43:11 +00:00
Code Issues Projects Releases Packages Wiki Activity

docs: More on conditionals directly

Browse source 
It's weird to force people to go to the separate pages, at least give
some simple examples here and link to the tutorial.

[ci skip]
This commit is contained in:
Fabian Homborg 2020-07-24 17:17:39 +02:00
parent cbd3adaa63
commit 50a40175f1
2 changed files with 16 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
doc_src/index.rst
View file

@ -472,13 +472,26 @@ After entering ``gco`` and pressing :kbd:`Space` or :kbd:`Enter`, the full text
Conditional execution of code and flow control
----------------------------------------------
There are four fish builtins that let you execute commands only if a specific criterion is met. These builtins are :ref:`if <cmd-if>`, :ref:`switch <cmd-switch>`, :ref:`and <cmd-and>` and :ref:`or <cmd-or>`.
Fish has some builtins that let you execute commands only if a specific criterion is met: :ref:`if <cmd-if>`, :ref:`switch <cmd-switch>`, :ref:`and <cmd-and>` and :ref:`or <cmd-or>`, and also the familiar :ref:`&&/|| <tut-combiners>` syntax.
The :ref:`switch <cmd-switch>` command is used to execute one of possibly many blocks of commands depending on the value of a string. See the documentation for :ref:`switch <cmd-switch>` for more information.
The other conditionals use the `exit status <#variables-status>`_ of a command to decide if a command or a block of commands should be executed. See their documentation for more information.
The other conditionals use the `exit status <#variables-status>`_ of a command to decide if a command or a block of commands should be executed.
Some examples::
# Just see if the file contains the string "fish" anywhere.
if grep -q fish myanimals
echo You have fish!
else
echo You don't have fish!
end
# $XDG_CONFIG_HOME is a standard place to store configuration. If it's not set applications should use ~/.config.
set -q XDG_CONFIG_HOME; and set -l configdir $XDG_CONFIG_HOME
or set -l configdir ~/.config
For more, see the documentation for the builtins or the :ref:`Conditionals <tut-conditionals>` section of the tutorial.
.. _expand:

1
doc_src/tutorial.rst
View file

@ -440,6 +440,7 @@ As mentioned in :ref:`the section on the semicolon <tut_semicolon>`, this can al
and echo "Backup successful"
or echo "Backup failed"
.. _tut-conditionals:
Conditionals (If, Else, Switch)
-------------------------------