summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README52
1 files changed, 24 insertions, 28 deletions
diff --git a/README b/README
index a7d179c80..b6b023789 100644
--- a/README
+++ b/README
@@ -5,9 +5,7 @@ THE Z SHELL (ZSH)
Version
-------
-This is zsh version 3.1 (beta)
-
-Note that this is a beta version. The latest stable version is zsh-3.0.7.
+This is zsh version 4.0. This is a stable release.
Installing Zsh
--------------
@@ -19,35 +17,31 @@ are any special instructions for your particular architecture.
Features
--------
-Zsh is a shell with lots of features. For a list of these, see the
+Zsh is a shell with lots of features. For a list of some of these, see the
file Etc/FEATURES, and for the latest changes see Etc/NEWS. For more
details, see the documentation.
Possible incompatibilities
---------------------------
-If you have been using recent versions of zsh 3.1, the following changes in
-the shell may affect you:
-- The traditional bindings of \M-n (history-search-backward) and
- \M-p (history-search-forward) in older versions of zsh have returned,
- as has the traditional behaviour of those functions and the functions
- up-line-or-search and down-line-or-search. In 3.1.5, the functions
- behaved differently and \M-n and \M-p were bound by default to
- history-beginning-search-backward and history-beginning-search-forward.
-- Prompt truncation behaviour via %<...< and %>...> (or %[<...] etc.) has
- changed slightly: the string to be truncated runs to the end of the
- prompt or to the next truncation sequence; %<< will turn off truncation.
- Previously it only covered individual prompt escapes. So for example the
- prompt `%10<...<%~%% ' will now include the `%% ' in the string to be
- truncated, and you should change the prompt to `%10<...<%~%<<%% ' to turn
- off truncation immediately after the `%~'.
-- If for some reason you have `setopt norcs' or `unsetopt rcs' anywhere in
- your startup files (e.g. to stop .zlogout being run), this will now
- take effect immediately, preventing later startup files from being
- run. It is safe to put `setopt norcs' in .zlogin as this is always
- the last run.
-
-See the FAQ for a discussion of changes over the longer term.
+Some particular differences you may notice between version 3.0 and 4.0:
+
+ o The options ALWAYS_LAST_PROMPT (return to the line you were
+ editing after displaying completion lists) and LIST_AMBIGUOUS
+ (don't do AUTO_LIST if there was an unambiguous prefix that could be
+ inserted, i.e. only list if it is ambiguous what to insert next) are
+ now set by default. This is in response to complaints that too many
+ zsh features are never noticed by many users. To turn them off,
+ just put `unsetopt alwayslastprompt listambiguous' in your
+ .zshrc file.
+ o The editor commands history-search-{forward,backward} are implemented
+ slightly differently, as are {up,down}-line-or-search. You may
+ well not notice this, however.
+ o Cursor keys are now usually bound in both vi command and insert
+ mode. In the latter case, this may result in a slight delay after
+ hitting ESCAPE to exit insert mode. Purists who object to this can
+ unbind the appropriate key sequences (see zshzle(1)). Most beginning
+ users of zsh apparently find the current behaviour preferable.
Documentation
-------------
@@ -84,9 +78,11 @@ Doc/intro.ms An introduction to zsh in troff format using the ms
may not work without changes but it is still a good
introduction.
+For more information, see the website, as described in the META-FAQ.
+
If you do not have the necessary tools to process these documents,
PostScript, ASCII, Info and DVI versions are available in the separate
-file zsh-beta-doc.tar.gz at the archive sites listed in the META-FAQ.
+file zsh-doc.tar.gz at the archive sites listed in the META-FAQ.
The distribution also contains a Perl script in Utils/helpfiles which
can be used to extract the descriptions of builtin commands from the
@@ -128,7 +124,7 @@ Zsh Maintenance and Bug Reports
-------------------------------
Zsh is currently maintained by the members of the zsh-workers mailing list
-and coordinated by Peter Stephenson <pws@zsh.org>. Please send
+and coordinated by Peter Stephenson <coordinator@zsh.org>. Please send
any feedback and bugs reports to <zsh-workers@sunsite.dk>.
There is a script "reporter" in the subdirectory Util which will print