doc.h

\htmlonly </div> \endhtmlonly
        color: #005fd7;
        font-weight: normal;
}

pre i {
        /* Used for arguments */
        color: #00afff;
        font-style: normal;
}

pre em {
        /* Used for path/help word */
        color: #0a0;
        font-style: normal;
}

.quote {
        color: #A50;
}

.error {
        /* Used for errors */
        color: #F55;
        font-weight: bold;
}

.tutorial_nav {
        position: relative;
        z-index: 2;
        margin-left: 10px;
        margin-top: 15px;
}

.tutorial_nav ul {
        padding: 0 15px;
        margin: 0;
}

.tutorial_nav li {
        margin: 0;
        line-height: normal;
        height: auto;
        color: #EEE;
        font-size: 12pt;
        font-family: "Trebuchet MS", Verdana, Arial, sans-serif;
        list-style-image: none;
        list-style-position: outside;
        list-style-type: none;
        padding: 3px 15px;
        margin: 0 -15px;
}

.tutorial_nav a {
        color: inherit;
        text-decoration: none;
        font-family:
        font-size: 12pt;
}

.tutorial_nav .chevron {
        font-family: Times, "Times New Roman";
        color: #DDF;
        font-size: 16pt;
        line-height: 10pt;
        font-weight: bold;
}

.no_shadow > li > a,
.no_shadow {
        text-shadow: none;
}

.nav > li > a:hover {
  text-decoration: none;
  background-color: inherit;
  color: #99BBFF;
}

/* Override some default left bar stuff */
ul.nav li {
        margin-bottom: 0;
}


.title_top {
        width: 100%;
        text-align: left;
        color: white;
        font-size: 18pt;
        height: 72px;
        z-index: 1;
        text-indent: 260px;
}

.tutorial_content {
        -moz-box-shadow: -5px 0px 5px -2px black;
        -webkit-box-shadow: -5px 0px 5px -2px black;
        box-shadow: -5px 0px 5px -2px black;

        margin-left: 280px;
        padding: 1px 25px 10px 10px;
        position: relative;
        z-index: 5;
        background-color: white;
}

h3 {
        font-size: 25px;
        margin-top: 12px;
}

h1, h2, h3 { color: #1E335E; }
h1.interior_title {
        color: #333;
        padding-bottom: 10px;
        border-bottom: 1px solid #AAA;
}

h1 { font-size: 150%; }
h2 { font-size: 135%; }
h3 { font-size: 110%; }



</style>


<div class="fish_left_bar fish_left_medium">
        <div class="tutorial_nav">
          <ul class="nav no_shadow">
                <li><a href="#tut_why_fish"><span class="chevron">&rsaquo;</span> Why fish?</a></li>
                <li><a href="#tut_learning_Fish"><span class="chevron">&rsaquo;</span> Learning fish</a></li>
                <li><a href="#tut_running_commands"><span class="chevron">&rsaquo;</span> Running Commands</a></li>
                <li><a href="#tut_getting_help"><span class="chevron">&rsaquo;</span> Getting Help</a></li>
                <li><a href="#tut_syntax_highlighting"><span class="chevron">&rsaquo;</span> Syntax Highlighting</a></li>
                <li><a href="#tut_wildcards"><span class="chevron">&rsaquo;</span> Wildcards</a></li>
                <li><a href="#tut_pipes_and_redirections"><span class="chevron">&rsaquo;</span> Pipes and Redirections</a></li>
                <li><a href="#tut_autosuggestions"><span class="chevron">&rsaquo;</span> Autosuggestions</a></li>
                <li><a href="#tut_tab_completions"><span class="chevron">&rsaquo;</span> Tab Completions</a></li>
                <li><a href="#tut_variables"><span class="chevron">&rsaquo;</span> Variables</a></li>
                <li><a href="#tut_exit_status"><span class="chevron">&rsaquo;</span> Exit Status</a></li>
                <li><a href="#tut_exports"><span class="chevron">&rsaquo;</span> Shell Variables</a></li>
                <li><a href="#tut_lists"><span class="chevron">&rsaquo;</span> Lists</a></li>
                <li><a href="#tut_command_substitutions"><span class="chevron">&rsaquo;</span> Command Substitutions</a></li>
                <li><a href="#tut_combiners"><span class="chevron">&rsaquo;</span> Combiners (And, Or, Not)</a></li>
                <li><a href="#tut_conditionals"><span class="chevron">&rsaquo;</span> Conditionals (If, Else, Switch)</a></li>
                <li><a href="#tut_functions"><span class="chevron">&rsaquo;</span> Functions</a></li>
                <li><a href="#tut_loops"><span class="chevron">&rsaquo;</span> Loops</a></li>
                <li><a href="#tut_prompt"><span class="chevron">&rsaquo;</span> Prompt</a></li>
                <li><a href="#tut_startup"><span class="chevron">&rsaquo;</span> Startup</a></li>
          </ul>
        </div>
</div>

<div class="fish_right_bar fish_right_medium">

<h1 class="interior_title">fish tutorial</h1>

<h2 id="tut_why_fish">Why fish?</h2>

<p>fish is a fully-equipped command line shell (like bash or zsh) that is smart and user-friendly. fish supports powerful features like syntax highlighting, autosuggestions, and tab completions that just work, with nothing to learn or configure.

<p>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!

<h2 id="tut_learning_Fish">Learning fish</h2>

<p>This tutorial assumes a basic understanding of command line shells and Unix commands, and that you have a working copy of fish.

<p>If you have a strong understanding of other shells, and want to know what fish does differently, search for the magic phrase <i>unlike other shells</i>, which is used to call out important differences.

<p>When you start fish, you should see this:

<pre>
Welcome to fish, the friendly interactive shell
Type <em>help</em> for instructions on how to use fish
you@hostname <em>~</em>>
</pre>

<p>fish comes with a default prompt that shows your username, hostname, and working directory. You'll see <a href="#tut_prompt">how to change your prompt</a> further down. From now on, we'll pretend your prompt is just a '>' to save space.

<h2 id="tut_running_commands">Running Commands</h2>

<p>fish runs commands like other shells: you type a command, followed by its arguments. Spaces are separators:

<pre>
> <b>echo</b> <i>hello world</i>
hello world
</pre>

You can include a literal space in an argument with a backslash, or by using single or double quotes:

<pre>
> <b>mkdir</b> <i>My\ Files</i>
> <b>cp</b> <i>~/Some\ File</i> <i class=quote>'My Files'</i>
> <b>ls</b> <i class=quote>"My Files"</i>
Some File
</pre>

Commands can be chained with semicolons.

<h2 id="tut_getting_help">Getting Help</h2>

fish has excellent help and man pages. Run <tt>help</tt> to open help in a web browser, and <tt>man</tt> to open it in a man page. You can also ask for help with a specific command, for example, <tt>help set</tt> to open in a web browser, or <tt>man set</tt> to see it in the terminal.

<pre>
> <b>man</b> <i>set</i>
set - handle shell variables
  Synopsis...
</pre>

<h2 id="tut_syntax_highlighting">Syntax Highlighting</h2>
You'll quickly notice that fish performs syntax highlighting as you type. Invalid commands are colored red by default:

<pre>
> <b class="error">/bin/mkd</b>
</pre>

A command may be invalid because it does not exist, or refers to a file that you cannot execute. When the command becomes valid, it is shown in a different color:

<pre>
> <b>/bin/mkdir</b>
</pre>

fish will underline valid file paths as you type them:

<pre>
> <b>cat</b> <i><span style="text-decoration: underline">~/somef<u>i</u></span></i>
</pre>

<p>This tells you that there exists a file that starts with '<tt>somefi</tt>', which is useful feedback as you type.

<p>These colors, and many more, can be changed by running <tt>fish_config</tt>, or by modifying variables directly.

<h2 id="tut_wildcards">Wildcards</h2>

fish supports the familiar wildcard *. To list all JPEG files:

<pre>
> <b>ls</b> <i>*.jpg</i>
lena.jpg
meena.jpg
santa maria.jpg
</pre>

<p>You can include multiple wildcards:

<pre>
> <b>ls</b> <i>l*.p*</i>
lena.png
lesson.pdf
</pre>

<p>Especially powerful is the <i>recursive wildcard</i> ** which searches directories recursively:

<pre>
> <b>ls</b> <i>/var