1 files changed, 31 insertions, 21 deletions
diff --git a/Doc/zshall.1 b/Doc/zshall.1
index 4891d1abf..15ff09107 100644
--- a/Doc/zshall.1
+++ b/Doc/zshall.1
@@ -1,4 +1,4 @@
-.TH "ZSHALL" "1" "February 12, 2022" "zsh 5\&.8\&.1"
+.TH "ZSHALL" "1" "April 9, 2022" "zsh 5\&.8\&.1\&.2-test"
 .SH "NAME"
 zshall \- the Z shell meta\-man page
 .\" Yodl file: Zsh/intro.yo
@@ -47,19 +47,19 @@ login shell and as a shell script command processor\&.  Of the standard shells,
 zsh most closely resembles \fBksh\fP but includes many enhancements\&.  It
 does not provide compatibility with POSIX or other shells in its
 default operating mode:  see
-the section Compatibility below\&.
+the section `Compatibility' below\&.
 .PP
 Zsh has command line editing, builtin spelling correction, programmable
 command completion, shell functions (with autoloading), a history
 mechanism, and a host of other features\&.
 .\" Yodl file: Zsh/metafaq.yo
 .SH "AUTHOR"
-Zsh was originally written by Paul Falstad \fB<pf@zsh\&.org>\fP\&.
-Zsh is now maintained by the members of the zsh\-workers mailing
-list \fB<zsh\-workers@zsh\&.org>\fP\&.  The development is currently
-coordinated by Peter Stephenson \fB<pws@zsh\&.org>\fP\&.  The coordinator
-can be contacted at \fB<coordinator@zsh\&.org>\fP, but matters relating to
-the code should generally go to the mailing list\&.
+Zsh was originally written by Paul Falstad\&.  Zsh is now maintained by
+the members of the zsh\-workers mailing list \fB<zsh\-workers@zsh\&.org>\fP\&.
+The development is currently coordinated by Peter Stephenson
+\fB<pws@zsh\&.org>\fP\&.  The coordinator can be contacted at
+\fB<coordinator@zsh\&.org>\fP, but matters relating to the code should
+generally go to the mailing list\&.
 .SH "AVAILABILITY"
 Zsh is available from the following HTTP and anonymous FTP site\&.
 .PP
@@ -67,15 +67,14 @@ Zsh is available from the following HTTP and anonymous FTP site\&.
 \fBftp://ftp\&.zsh\&.org/pub/\fP
 \fBhttps://www\&.zsh\&.org/pub/\fP
 .fi
-)
 .PP
 The up\-to\-date source code is available via Git from Sourceforge\&.  See
 \fBhttps://sourceforge\&.net/projects/zsh/\fP for details\&.  A summary of
 instructions for the archive can be found at
-\fBhttp://zsh\&.sourceforge\&.net/\fP\&.
+\fBhttps://zsh\&.sourceforge\&.io/\fP\&.
 .PP
 .SH "MAILING LISTS"
-Zsh has 3 mailing lists:
+Zsh has several mailing lists:
 .PP
 .PD 0
 .TP
@@ -89,6 +88,14 @@ User discussions\&.
 .TP
 \fB<zsh\-workers@zsh\&.org>\fP
 Hacking, development, bug reports and patches\&.
+.TP
+\fB<zsh\-security@zsh\&.org>\fP
+Private mailing list (the general public cannot subscribe to it) for discussing
+bug reports with security implications, i\&.e\&., potential vulnerabilities\&.
+.RS
+.PP
+If you find a security problem in zsh itself, please mail this address\&.
+.RE
 .PP
 To subscribe or unsubscribe, send mail
 to the associated administrative address for the mailing list\&.
@@ -115,30 +122,28 @@ All submissions to \fBzsh\-announce\fP are automatically forwarded to
 forwarded to \fBzsh\-workers\fP\&.
 .PP
 If you have problems subscribing/unsubscribing to any of the mailing
-lists, send mail to \fB<listmaster@zsh\&.org>\fP\&.  The mailing lists are
-maintained by Karsten Thygesen \fB<karthy@kom\&.auc\&.dk>\fP\&.
+lists, send mail to \fB<listmaster@zsh\&.org>\fP\&.
 .PP
 The mailing lists are archived; the archives can be accessed via the
 administrative addresses listed above\&.  There is also a hypertext
-archive, maintained by Geoff Wing \fB<gcw@zsh\&.org>\fP, available at
+archive available at
 \fBhttps://www\&.zsh\&.org/mla/\fP\&.
 .SH "THE ZSH FAQ"
 Zsh has a list of Frequently Asked Questions (FAQ), maintained by
 Peter Stephenson \fB<pws@zsh\&.org>\fP\&.  It is regularly posted to the
 newsgroup \fBcomp\&.unix\&.shell\fP and the \fBzsh\-announce\fP mailing list\&.
 The latest version can be found at any of the Zsh FTP sites, or at
-\fBhttp://www\&.zsh\&.org/FAQ/\fP\&.  The contact address for FAQ\-related matters
+\fBhttps://www\&.zsh\&.org/FAQ/\fP\&.  The contact address for FAQ\-related matters
 is \fB<faqmaster@zsh\&.org>\fP\&.
 .SH "THE ZSH WEB PAGE"
-Zsh has a web page which is located at \fBhttps://www\&.zsh\&.org/\fP\&.  This is
-maintained by Karsten Thygesen \fB<karthy@zsh\&.org>\fP, of SunSITE Denmark\&.
+Zsh has a web page which is located at \fBhttps://www\&.zsh\&.org/\fP\&.
 The contact address for web\-related matters is \fB<webmaster@zsh\&.org>\fP\&.
 .SH "THE ZSH USERGUIDE"
 A userguide is currently in preparation\&.  It is intended to complement the
 manual, with explanations and hints on issues where the manual can be
 cabbalistic, hierographic, or downright mystifying (for example, the word
 `hierographic' does not exist)\&.  It can be viewed in its current state at
-\fBhttp://zsh\&.sourceforge\&.net/Guide/\fP\&.  At the time of writing, chapters
+\fBhttps://zsh\&.sourceforge\&.io/Guide/\fP\&.  At the time of writing, chapters
 dealing with startup files and their contents and the new completion system
 were essentially complete\&.
 .\" Yodl file: Zsh/invoke.yo
@@ -273,8 +278,7 @@ parameters are not special and not initialized by the shell:
 \fBPROMPT3\fP,
 \fBPROMPT4\fP,
 \fBpsvar\fP,
-\fBstatus\fP,
-\fBwatch\fP\&.
+\fBstatus\fP\&.
 .PP
 The usual zsh startup/shutdown scripts are not executed\&.  Login shells
 source \fB/etc/profile\fP followed by \fB$HOME/\&.profile\fP\&.  If the
@@ -316,6 +320,12 @@ Also, the
 and
 \fBSINGLE_LINE_ZLE\fP
 options are set if zsh is invoked as \fBksh\fP\&.
+.PP
+Please note that, whilst reasonable efforts are taken to address
+incompatibilities when they arise, zsh does not guarantee complete
+emulation of other shells, nor POSIX compliance\&. For more information on
+the differences between zsh and other shells, please refer to chapter 2
+of the shell FAQ, \fBhttps://www\&.zsh\&.org/FAQ/\fP\&.
 .\" Yodl file: Zsh/restricted.yo
 .SH "RESTRICTED SHELL"
 When the basename of the command used to invoke zsh starts with the letter
@@ -476,7 +486,7 @@ file will be used instead\&.
 .so man1/zshtcpsys.1
 .so man1/zshzftpsys.1
 .so man1/zshcontrib.1
-.TH "ZSHALL" "1" "February 12, 2022" "zsh 5\&.8\&.1"
+.TH "ZSHALL" "1" "April 9, 2022" "zsh 5\&.8\&.1\&.2\-test"
 .\" Yodl file: Zsh/filelist.yo
 .SH "FILES"
 .PD 0