Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Henryk Konsek <hak8@...>
Subject: Zsh article
Date: Sat, 18 Feb 2006 03:35:59 +0100
Hi.
	As far as I know there is not section in Gentoo documentation concerning Zsh 
configuration. I've written sample article covering basic Zsh installation 
and configuration issues. I would be grateful for any feedback concerning my 
doc.

Greetings.
HK
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link title="new" rel="stylesheet" href="css/main.css" type="text/css">
<link REL="shortcut icon" HREF="favicon.ico" TYPE="image/x-icon">
<title>Gentoo Linux 
  Documentation
-- 
  Quick quide to Zsh installation and configuration</title>
</head>
<body style="margin-left:0px;margin-top:0px;" bgcolor="#ffffff"><table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr><td valign="top" height="125" bgcolor="#45347b"><table cellspacing="0" cellpadding="0" border="0" width="193">
<tr><td class="logobg" valign="top" align="center" height="88"><a href="/"><img border="0" src="images/gtop-s.jpg" alt="Gentoo Logo"></a></td></tr>
<tr><td class="logobg" valign="top" align="center" height="36"><a href="/"><img border="0" src="images/gbot-s.gif" alt="Gentoo Logo Side"></a></td></tr>
</table></td></tr>
<tr><td valign="top" align="right" colspan="1" bgcolor="#ffffff"><table border="0" cellspacing="0" cellpadding="0" width="100%"><tr>
<td width="99%" class="content" valign="top" align="left">
<br><p class="dochead">Quick quide to Zsh installation and configuration</p>
<form name="contents" action="http://www.gentoo.org">
<b>Contents</b>:
    <select name="url" size="1" OnChange="location.href=form.url.options[form.url.selectedIndex].value" style="font-family:Arial,Helvetica, sans-serif; font-size:10"><option value="#doc_chap1">1. Installation</option>
<option value="#doc_chap2">2. Configuration</option>
<option value="#doc_chap3">3. Saving settings</option></select>
</form>
<p class="chaphead"><span class="chapnum"><a name="doc_chap1">1. </a></span>Installation</p>
<p class="secthead"><a name="doc_chap1_sect1">Packages download </a></p>
<p>
To install zsh under Gentoo we need to emerge app-shells/zsh (zsh itself) and app-shells/zsh-completion
(zsh completion scripts) packages.
</p>

<a name="doc_chap1_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 1.1: Emerging Zsh</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>

	# emerge zsh zsh-completion
</pre></td></tr>
</table>

<p class="chaphead"><span class="chapnum"><a name="doc_chap2">2. </a></span>Configuration</p>
<p class="secthead"><a name="doc_chap2_sect1">Introduction </a></p>
<p>
After installation Zsh seems to be very simple and rather limited in the area of functionality. To change 
this state several configuration fixes should be performed.
</p>
<p class="secthead"><a name="doc_chap2_sect2">Advanced Tab-completion </a></p>

<p>
To enable famous Zsh tab-completion system we have to type the following commands:
</p>

<a name="doc_chap2_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 2.1: Completion enabling</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>

% autoload -U compinit
% compinit
</pre></td></tr>
</table>

<p class="secthead"><a name="doc_chap2_sect3">Command correction </a></p>
<p>
This is also a good idea to enable correction of the commands written under shell.
</p>

<a name="doc_chap2_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 2.2: Correction enabling</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>

% setopt correctall
</pre></td></tr>
</table>

<p class="secthead"><a name="doc_chap2_sect4">Prompts </a></p>
<p>
Our prompt may seem quite boring however we can fix it easily in several steps. 
At first we need to initalize advanced prompt support:
</p>

<a name="doc_chap2_pre3"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 2.3: Advanced prompts enabling</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>

% autoload -U promptinit
% promptinit
</pre></td></tr>
</table>

<p>
Available prompts samples may be printed via prompt -p command. Now we can activate our 
favourite one (oliver for example):
</p>

<a name="doc_chap2_pre4"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 2.4: Prompt choice</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>

% prompt oliver
</pre></td></tr>
</table>

<p class="chaphead"><span class="chapnum"><a name="doc_chap3">3. </a></span>Saving settings</p>
<p class="secthead"><a name="doc_chap3_sect1">How to save zsh settings in zshrc script </a></p>
<p>
This is good idea to enable these option as a zsh defaults for our system. Possible
way to achieve this is to write our settings in the /etc/zsh/zshrc script using our
favourite text editor (nano or vim for example):
</p>

<a name="doc_chap3_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 3.1: vim /etc/zsh/zshrc</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>

#!/bin/zsh

# completion
autoload -U compinit
compinit

# correction
setopt correctall

# prompt
autoload -U promptinit
promptinit
prompt oliver

</pre></td></tr>
</table>

<p>
The last thing we need to do is to set zshrc script as executable:
</p>

<a name="doc_chap3_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 3.2: Making zshrc executable</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>

% chmod a+x /etc/zsh/zshrc
</pre></td></tr>
</table>
<br><tt>
  The contents of this document are licensed under the <a href="http://creativecommons.org/licenses/by-sa/1.0">Creative Commons - Attribution / Share Alike</a> license.
</tt><br>
</td>
<td width="1%" bgcolor="#dddaec" valign="top"><table border="0" cellspacing="5" cellpadding="0">
<tr><td><img src="images/line.gif" alt="line"></td></tr>
<tr><td align="center" class="alttext">
                  Updated 2006-02-18</td></tr>
<tr><td><img src="images/line.gif" alt="line"></td></tr>
<tr><td class="alttext">
	<b><a class="altlink" href="mailto:hak8@...">Henryk Konsek</a></b>
<br><i>Author</i><br><br>
</td></tr>
<tr><td><img src="images/line.gif" alt="line"></td></tr>
<tr><td class="alttext">
<b>Summary:</b> 
This guide shows how to install and configure Zsh quickly. After lecture of this document you
will be able use such Zsh features as advanced tab-completion, commands correction or prompt
management.
</td></tr>
<tr><td><img src="images/line.gif" alt="line"></td></tr>
<tr><td align="center">
<p class="alttext"><b>Donate</b> to support our development efforts.
                  </p>
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_xclick"><input type="hidden" name="business" value="drobbins@g.o"><input type="hidden" name="item_name" value="Gentoo Linux Support"><input type="hidden" name="item_number" value="1000"><input type="hidden" name="image_url" value="images/paypal.png"><input type="hidden" name="no_shipping" value="1"><input type="hidden" name="return" value="http://www.gentoo.org"><input type="hidden" name="cancel_return" value="http://www.gentoo.org"><input type="image" src="" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form>
</td></tr>
<tr><td><img src="images/line.gif" alt="line"></td></tr>
<tr><td align="center"><a href="http://store.gentoo.org"><img src="images/store.png" alt="The Gentoo Linux Store" border="0"></a></td></tr>
<tr><td><img src="images/line.gif" alt="line"></td></tr>
<tr><td align="center">
<a href="http://www.phparch.com/bannerclick.php?AID=68&amp;BID=1&amp;BT=127929" target="_top"><img src="images/phpa-gentoo.gif" width="125" height="144" alt="php|architect" border="0"></a><p class="alttext">
		  php|architect is the monthly magazine for PHP professionals, available
		  worldwide in print and electronic format. A percentage of all the sales
		  will be donated back into the Gentoo project.
                  </p>
</td></tr>
<tr><td><img src="images/line.gif" alt="line"></td></tr>
<tr><td align="center">
<a href="http://www.tek.net" target="_top"><img src="images/tek-gentoo.gif" width="125" height="125" alt="Tek Alchemy" border="0"></a><p class="alttext">
                    Tek Alchemy offers dedicated servers and other hosting solutions running Gentoo Linux.
                  </p>
</td></tr>
<tr><td><img src="images/line.gif" alt="line"></td></tr>
<tr><td align="center">
<a href="http://www.qksrv.net/click-477620-5032687" target="_top"><img src="http://www.qksrv.net/image-477620-5032687" width="125" height="125" alt="DDR Memory at Crucial.com" border="0"></a><p class="alttext">
                    Purchase RAM from <b>Crucial.com</b> and a percentage of your sale will go towards further Gentoo Linux development.
                  </p>
</td></tr>
<tr><td><img src="images/line.gif" alt="line"></td></tr>
<tr><td align="center">
<a href="http://www.netraverse.com/gentoo.htm" target="_top"><img src="images/netraverse-gentoo.gif" width="125" height="102" alt="Win4Lin at NeTraverse" border="0"></a><p class="alttext">
                    Win4Lin from <b>NeTraverse</b> lets you run Windows applications under Gentoo Linux at native speeds.
                  </p>
</td></tr>
<tr><td><img src="images/line.gif" alt="line"></td></tr>
</table></td>
</tr></table></td></tr>
<tr><td colspan="2" align="right" class="infohead" width="100%" bgcolor="#7a5ada">
      Copyright 2001-2003 Gentoo Technologies, Inc.  Questions, Comments, Corrections?  Email <a class="highlight" href="mailto:www@g.o">www@g.o</a>.
    </td></tr>
</table></body>
</html>
Attachment:
zsh.xml (Text Data)
Replies:
Re: Zsh article
-- Łukasz Damentko
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
$Id$ keyword is mandatory?
Next by thread:
Re: Zsh article
Previous by date:
Re: $Id$ keyword is mandatory?
Next by date:
Re: Zsh article


Updated Jun 17, 2009

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.