Attachment 80133 Details for Bug 123322 – zsh.xml

zsh.xml

zsh.xml (text/plain), 3.15 KB, created by Chris White (RETIRED) on 2006-02-18 16:12:53 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Chris White (RETIRED)

Created: 2006-02-18 16:12:53 UTC

Size: 3.15 KB

patch

obsolete

><?xml version="1.0" encoding="UTF-8"?>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
>
><guide link="/doc/en/zsh.xml" lang="en">
>
><title>zsh Configuration and Installation Guide</title>
>
><author title="Author">
>  <mail link="hak8@wp.pl">Henryk Konsek</mail>
></author>
><author title="Editor">
>  <mail link="chriswhite@gentoo.org">Chris White</mail>
></author>
>
><abstract>
>This guide shows how to install and configure zsh quickly. After
>completing this document you will be able use such zsh features
>as advanced tab-completion, command correction and prompt management.
></abstract>
>
>
>
><license/>
>
><version>1.0</version>
><date>2006-02-18</date>
>
><chapter>
><title>Installation</title>
><section>
><title>Aquiring zsh</title>
>
><body>
><p>
>To install <c>zsh</c> under Gentoo we need to emerge <c>app-shells/zsh</c>
>(<c>zsh</c> itself) and <c>app-shells/zsh-completion</c> (<c>zsh</c>
>completion scripts) packages.
></p>
>
><pre caption="Emerging zsh">
># <i>emerge zsh zsh-completion</i>
></pre>
>
></body>
></section>
></chapter>
><chapter>
><title>Configuration</title>
><section>
><title>Introduction</title>
><body>
><p>
>After the installation, <c>zsh</c> seems to be very simple and rather limited
>in the area of functionality. To change this, several configuration fixes need
>to be performed.
></p>
></body>
></section>
><section>
><title>Advanced Tab-completion</title>
><body>
>
><p>
>To enable the famous <c>zsh</c> tab-completion system, the following commands
>must be entered:
></p>
>
><pre caption="Completion enabling">
>% <i>autoload -U compinit</i>
>% <i>compinit</i>
></pre>
>
></body>
></section>
><section>
><title>Command correction</title>
><body>
><p>
>It is also a good idea to enable the correction of the commands written under shell.
></p>
>
><pre caption="Correction enabling">
>% <i>setopt correctall</i>
></pre>
>
></body>
></section>
><section>
><title>Prompts</title>
><body>
><p>
>The prompt may seem quite boring however, but we can fix it easily in several
>steps. First, we need to initialize advanced prompt support:
></p>
>
><pre caption="Advanced prompts enabling">
>% <i>autoload -U promptinit</i>
>% <i>promptinit</i>
></pre>
>
><p>
>Available prompts samples may be printed via the <c>prompt -p</c> command. Now
>we can activate our favorite one (oliver for example):
></p>
>
><pre caption="Prompt choice">
>% <i>prompt oliver</i>
></pre>
>
></body>
></section>
></chapter>
><chapter>
><title>Saving settings</title>
><section>
><title>Saving zsh settings</title>
><body>
><p>
>It is a good idea to enable this option as a <c>zsh</c> defaults for the system.
>One possible way to achieve this is to write our settings in the
><path>/etc/zsh/zshrc</path> script using our favorite text editor (nano or vim
>for example):
></p>
>
><pre caption="/etc/zsh/zshrc">
>#!/bin/zsh
>
># completion
>autoload -U compinit
>compinit
>
># correction
>setopt correctall
>
># prompt
>autoload -U promptinit
>promptinit
>prompt oliver
></pre>
>
><p>
>The last thing we need to do is set the <path>/etc/zsh/zshrc</path> script as
>executable:
></p>
>
><pre caption="Making zshrc executable">
>% <i>chmod a+x /etc/zsh/zshrc</i>
></pre>
></body>
></section>
></chapter>
></guide>

Actions: View

Attachments on bug 123322: 80129 | 80133 | 80134 | 80144 | 80319 | 80320 | 80326 | 80327 | 93612 | 95857 | 95873