From a83f5801740b259afd4fe2c9ae429809949d88f5 Mon Sep 17 00:00:00 2001 From: Charles Gould Date: Wed, 15 Jul 2020 02:36:46 -0400 Subject: [PATCH] docs: shebang line cleanup --- doc_src/index.rst | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/doc_src/index.rst b/doc_src/index.rst index 6ec883a12..a262191df 100644 --- a/doc_src/index.rst +++ b/doc_src/index.rst @@ -93,18 +93,16 @@ For uninstalling fish: see :ref:`FAQ: Uninstalling fish `. Shebang Line ------------ -Since scripts for shell commands can be written in many different languages, they need to carry information about what interpreter is needed to execute them: For this they are expected to have a first line, the shebang line, which names an executable for this purpose: +Since scripts for shell commands can be written in many different languages, they need to carry information about what interpreter is needed to execute them. For this they are expected to have a first line, the shebang line, which names an executable for this purpose. -Example: - -A scripts written in ``bash`` it would need a first line like this:: +A script written in ``bash`` would need a first line like this:: #!/bin/bash This line tells the shell to execute the file with the bash interpreter, that is located at the path ``/bin/bash``. -For a script, written in another language, just replace the interpreter ``/bin/bash`` with the language interpreter of that other language (for example ``/bin/python`` for a ``python`` script) +For a script written in another language, just replace the interpreter ``/bin/bash`` with the language interpreter of that other language (for example: ``/bin/python`` for a python script, or ``/usr/local/bin/fish`` for a fish script). This line is only needed when scripts are executed without specifying the interpreter. For functions inside fish or when executing a script with ``fish /path/to/script`` they aren't required (but don't hurt either!).