Initial revision

1 files changed, 135 insertions, 0 deletions

diff --git a/README b/README
new file mode 100644
index 000000000..6a591b263
--- /dev/null
+++ b/README
@@ -0,0 +1,135 @@
+-----------------
+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.5.
+
+Installing Zsh
+--------------
+
+The instructions for compiling zsh are in the file INSTALL.  You should
+also check the file MACHINES in the subdirectory Etc to see if there
+are any special instructions for your particular architecture.
+
+Features
+--------
+
+Zsh is a shell with lots of features.  For a list of these, see the
+file Etc/FEATURES.  For more details, see the documentation.
+
+Documentation
+-------------
+
+There are a number of documents about zsh in this distribution:
+
+Doc/Zsh/*.yo	The master source for the zsh documentation is written in
+		yodl.  Yodl is a document language written by Karel Kubat.
+		It is not required by zsh but but it is a nice program so
+		you might want to get it anyway, especially if you are a
+		zsh developer.  It can be downloaded from
+		ftp://ftp.icce.rug.nl/pub/unix/yodl*
+
+Doc/zsh*.1	Man pages in nroff format.  These will be installed
+		by "make install.man" or "make install".  By default,
+		these will be installed in /usr/local/man/man1, although
+		you can change this with the --mandir option to configure
+		or editing the user configuration section of the top level
+		Makefile.
+
+Doc/zsh.texi	Everything the man pages have, but in texinfo format.  These
+		will be installed by "make install.info" or "make install".
+		By default, these will be installed in /usr/local/info,
+		although you can change this with the --infodir option to
+		configure or editing the user configuration section of the
+		top level Makefile.
+
+Also include in the distribution are:
+
+Doc/intro.ms	An introduction to zsh in troff format using the ms
+		macros.  This document explains many of the features
+		that make zsh more equal than other shells.
+		Unfortunately this is based on zsh-2.5 so some examples
+		may not work without changes but it is still a good
+		introduction.
+
+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.
+
+The distribution also contains a Perl script in Utils/helpfiles which
+can be used to extract the descriptions of builtin commands from the
+zshbuiltins manual page.  See the comments at the beginning of the
+script about its usage.  The files created by this script can be used
+by example function run-help located in the subdirectory Functions to
+show information about zsh builtins and run `man' on external commands.
+For this the shell variable HELPDIR should point to a directory containing
+the fileles generated by the helpfiles script.  run-help should be
+unaliased before loading the run-help function.  After that this function
+will be executed by the run-help ZLE function which is by default bound
+to ESC-h in emacs mode.
+
+Examples
+--------
+
+Examples of zsh startup files are located in the subdirectory
+StartupFiles.  Examples of zsh functions and scripts are located in
+the subdirectory Functions.  Examples of completion control commands
+(compctl) are located in the file Misc/compctl-examples.
+
+Zsh FTP Sites, Web Pages, and Mailing Lists
+-------------------------------------------
+
+The current list of zsh FTP sites, web pages, and mailing lists can be
+found in the META-FAQ.  A copy is included in this distribution and is
+available separately at any of the zsh FTP sites.
+
+Common Problems and Frequently Asked Questions
+----------------------------------------------
+
+Zsh has a list of Frequently Asked Questions (FAQ) maintained by Peter
+Stephenson <pws@zsh.org>.  It covers many common problems encountered
+when building, installing, and using zsh.  A copy is included in this
+distribution in Etc/FAQ and is available separately at any of the zsh
+ftp sites.
+
+Zsh Maintenance and Bug Reports
+-------------------------------
+
+Zsh is currently maintained by the members of the zsh-workers mailing list
+and coordinated by Andrew Main (Zefram) <zefram@zsh.org>.  Please send
+any feedback and bugs reports to <zsh-workers@math.gatech.edu>.
+
+There is a script "reporter" in the subdirectory Util which will print
+out your current shell environment/setup.  If you report a bug, please
+use this script and include the output from sourcing this file.  This way,
+the problem you are reporting can be recreated.
+
+You can help even more if you can reproduce the bug starting zsh with
+the -f option.  This skips the execution of local startup files except
+/etc/zshenv.  If a bug occurs only when some options set try to locate
+the option which triggers the bug.
+
+The known bugs in zsh are listed in the file Etc/BUGS.  Check this as
+well as the Frequently Asked Questions (FAQ) list before sending a bug
+report.  Note that zsh has some features which are not compatible with
+sh but these are not bugs.  Most of these incompatibilities go away
+when zsh is invoked as sh or ksh (e.g. using a symbolic link).
+
+If you send a bug report to the list and are not a subscriber, please
+mention this in your message if you want a response.
+
+If you would like to contribute to the development and maintenance of zsh,
+then you should join the zsh-workers mailing list (check the META-FAQ
+for info on this).  You should also read the "zsh-development-guide"
+located in the subdirectory Util.
+
+Contributors
+------------
+
+The people who have contributed to this software project are listed
+in Etc/CONTRIBUTORS.