From b347b44d9ea3cf754b439d4fa55ecb9e94180055 Mon Sep 17 00:00:00 2001 From: Sabine Maennel Date: Mon, 4 Jun 2018 10:10:01 +0200 Subject: [PATCH] added 2 sections to the tutorial Added 2 sections to the tutorial: - getting started - switching to fish This fixes issue #475 --- doc_src/tutorial.hdr | 52 +++++++++++++++++++++++++++++++++++++++----- 1 file changed, 46 insertions(+), 6 deletions(-) diff --git a/doc_src/tutorial.hdr b/doc_src/tutorial.hdr index 832d4d95e..b4ef8dfce 100644 --- a/doc_src/tutorial.hdr +++ b/doc_src/tutorial.hdr @@ -6,6 +6,7 @@
\endhtmlonly - Why fish? +- Getting started - Learning fish - Running Commands - Getting Help @@ -29,6 +30,7 @@ - Startup - Autoloading Functions - Universal Variables +- Switching to fish - Ready for more? \htmlonly[block] @@ -46,21 +48,32 @@ If you want to make your command line more productive, more useful, and more fun, without learning a bunch of arcane syntax and configuration options, then `fish` might be just what you're looking for! -\section tut_learning_Fish Learning fish +\section tut_getting_started Getting started -This tutorial assumes a basic understanding of command line shells and Unix commands, and that you have a working copy of `fish`. +Once installed, just type in `fish` into your current shell to try it out! -If you have a strong understanding of other shells, and want to know what `fish` does differently, search for the magic phrase unlike other shells, which is used to call out important differences. - -When you start `fish`, you should see this: +You will be greeted by the standard fish prompt, +which means you are all set up and can start using fish: \fish{cli-dark} +> fish Welcome to fish, the friendly interactive shell Type help for instructions on how to use fish you@hostname ~>____ \endfish -`fish` comes with a default prompt that shows your username, hostname, and working directory. You'll see how to change your prompt further down. From now on, we'll pretend your prompt is just a '`>`' to save space. +This prompt that you see above is the `fish` default prompt: it shows your username, hostname, and working directory. +- to change this prompt see how to change your prompt +- to switch to fish permanently see switch your default shell to fish + +From now on, we'll pretend your prompt is just a '`>`' to save space. + + +\section tut_learning_Fish Learning fish + +This tutorial assumes a basic understanding of command line shells and Unix commands, and that you have a working copy of `fish`. + +If you have a strong understanding of other shells, and want to know what `fish` does differently, search for the magic phrase unlike other shells, which is used to call out important differences. \section tut_running_commands Running Commands @@ -677,6 +690,33 @@ Now in another shell: vim \endfish + +\section tut_switching_to_fish Switching to fish? + +If you wish to use fish (or any other shell) as your default shell, +you need to enter your new shell's executable `/usr/local/bin/fish` in two places: +- add `/usr/local/bin/fish` to `/etc/shells` +- change your default shell with `chsh -s` to `/usr/local/bin/fish` + +You can use the following commands for this: + +Add the fish shell `/usr/local/bin/fish` +to `/etc/shells` with: + +\fish{cli-dark} +>echo /usr/local/bin/fish | sudo tee -a /etc/shells +\endfish + +Change your default shell to fish with: + +\fish{cli-dark} +>chsh -s /usr/local/bin/fish +\endfish + +(To change it back to another shell, just substitute `/usr/local/bin/fish` +with `/bin/bash`, `/bin/tcsh` or `/bin/zsh` as appropriate in the steps above.) + + \section tut_more Ready for more? If you want to learn more about fish, there is lots of detailed documentation, an official mailing list, the IRC channel \#fish on `irc.oftc.net`, and the github page.