Zsh guide

Zsh guide

[Peter Stephenson]

Sorry about the last blank mail...

Before I get onto the main point: here's advance warning that I'm moving to
a new job (a proper job this time :-)) in Cambridge, UK, at the end of the
week, so there could be a gap of up to a few weeks in development versions
until I get my personal computing stuff organised.


I've now got a first draft of the chapter in my zsh user guide which deals
with completion --- specifically new-style completion, so it's only useful
if you have at least 3.1.6, and as it describes the latest version, much of
it isn't of use unless you have that (see the `development' subdirectory on
the zsh archive site and any mirrors which are within a week or two of
being up-to-date).

To examine the guide so far --- chapters 1 (short introduction), 2 (basics
and startup files) and 6 (completion) --- online or retrieve one of the
versions, go to
  http://www.pwstephenson.fsnet.co.uk/computing/
The LaTeX/PostScript version as formatted (for A4) is 105 pages.  Any other
versions which I may or may not have scattered across Europe are out of
date.

I'd particular appreciate comments on
- things which are wrong; there must be plenty of these, since it's quite
  complicated to begin with, and I've been making changes on the fly as
  the mechanism has evolved (well, all right, as Sven has evolved it)
- things badly phrased, over-complicated, unnecessarily detailed
- things missed out.

-- 
Peter Stephenson <pws@pwstephenson.fsnet.co.uk>

Re: Zsh guide

[Bruce Stephens]

Peter Stephenson <pws@pwstephenson.fsnet.co.uk> writes:

[...]

> To examine the guide so far --- chapters 1 (short introduction), 2 (basics
> and startup files) and 6 (completion) --- online or retrieve one of the
> versions, go to
>   http://www.pwstephenson.fsnet.co.uk/computing/
> The LaTeX/PostScript version as formatted (for A4) is 105 pages.  Any other
> versions which I may or may not have scattered across Europe are out of
> date.
> 
> I'd particular appreciate comments on
> - things which are wrong; there must be plenty of these, since it's quite
>   complicated to begin with, and I've been making changes on the fly as
>   the mechanism has evolved (well, all right, as Sven has evolved it)
> - things badly phrased, over-complicated, unnecessarily detailed
> - things missed out.

I'm reading the completion chapter at the moment, and it's excellent.
For all I know it might be completely wrong, but it's very clear and I
feel I'm beginning to understand this new completion stuff.  Once I
try it I may be in a position to notice mistakes, but in the meantime
I'd like to thank Peter for some of the best documentation I've read
in some time.

Zsh guide

[Peter Stephenson]

Re: Zsh guide

[Clint Adams]

> I'm trying to put together a guide to help users with zsh.  It'll be a long
> haul, but I've made an attempt at a first chapter (not counting an
> introduction) on the subject of initialization files and what to put in
> them.   You can find it at

Might I suggest that the texi documentation be renamed to something other
than "The Z Shell Guide" then?

Zsh guide

[Peter Stephenson]

I'm trying to put together a guide to help users with zsh.  It'll be a long
haul, but I've made an attempt at a first chapter (not counting an
introduction) on the subject of initialization files and what to put in
them.   You can find it at
  http://www.ifh.de/~pws/computing/zshguide_intro.html
(this is likely to change eventually, but what isn't?)

Comments are welcome, of course.  It's possible that eventually it will
have to broken down to something more gentle in places with the hard stuff
moved later on.

-- 
Peter Stephenson <pws@ibmth.df.unipi.it>       Tel: +39 050 844536
WWW:  http://www.ifh.de/~pws/
Dipartimento di Fisica, Via Buonarroti 2, 56127 Pisa, Italy