problems in zshcompctl.1, zshcontrib.1, zshmodules.1

[esr@thyrsus.com]

This is automatically generated email about problems in a man page for which
you appear to be responsible.  If you are not the right person or list, tell
me and I will attempt to correct my database.

See http://catb.org/~esr/doclifter/problems.html for details on how and
why these patches were generated.  Feel free to email me with any questions.
Note: These patches do not change the mod date of any manual page.  You
may wish to do that by hand.

Problems with zshcompctl.1:

1. List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
This confuses doclifter, and may also mess up stricter troff
interpreters like Xman, Rosetta, and TkMan.

--- zshcompctl.1-orig	2004-11-20 17:09:24.124991416 -0500
+++ zshcompctl.1	2004-11-20 17:10:38.177733688 -0500
@@ -589,17 +589,13 @@
 .PP
 .SH "EXTENDED COMPLETION"
 .PD 0
-.TP
 .nf
 \fBcompctl\fP [ \fB\-CDT\fP ] \fIoptions\fP \fB\-x\fP \fIpattern\fP \fIoptions\fP \fB\-\fP \&.\&.\&. \fB\-\-\fP
   [ \fIcommand\fP \&.\&.\&. ]
-.fi
-.TP
-.nf
+
 \fBcompctl\fP [ \fB\-CDT\fP ] \fIoptions\fP [ \fB\-x\fP \fIpattern\fP \fIoptions\fP \fB\-\fP \&.\&.\&. \fB\-\-\fP ]
   [ \fB+\fP \fIoptions\fP [ \fB\-x\fP \&.\&.\&. \fB\-\-\fP ] \&.\&.\&. [\fB+\fP] ] [ \fIcommand\fP \&.\&.\&. ]
 .fi
-.PD
 .PP
 The form with `\fB\-x\fP' specifies extended completion for the
 commands given; as shown, it may be combined with alternative
-----------------------------
Problems with zshcontrib.1:

1. List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
This confuses doclifter, and may also mess up stricter troff
interpreters like Xman, Rosetta, and TkMan.

--- zshcontrib.1-orig	2006-12-26 12:04:28.000000000 -0500
+++ zshcontrib.1	2006-12-26 12:05:55.000000000 -0500
@@ -1293,10 +1293,7 @@
 should be checked if attempting to execute a file by extension
 \fB\&.\fP\fIext\fP does not have the expected effect\&.
 .PP
-.PD 0
 .TP
-.PD
-
 The command `\fBalias \-s\fP \fIext\fP' should show
 `\fBps=zsh\-mime\-handler\fP'\&.  If it shows something else, another suffix
 alias was already installed and was not overwritten\&.  If it shows
@@ -1305,7 +1302,6 @@
 \fB\&.ext\fP files\&.  In that case, appropriate handling should be added to
 \fB~/\&.mime\&.types\fP and \fBmailcap\fP\&.
 .TP
-
 If the extension is handled by \fBzsh\-mime\-handler\fP but the file is
 not opened correctly, either the handler defined for the type is
 incorrect, or the flags associated with it are in appropriate\&.  Running
-----------------------------
Problems with zshmodules.1:

1. Unbalanced .RS or .RE macro

2. Unclosed .RS, appears to be a broken attempt to express list structure.

--- zshmodules.1-orig	2004-11-19 14:26:57.372897376 -0500
+++ zshmodules.1	2004-11-19 14:27:19.109592896 -0500
@@ -1179,7 +1179,6 @@
 \fBzsocket\fP [ \fB\-altv\fP ] [ \fB\-d\fP \fIfd\fP ] [ \fIargs\fP ]
 \fBzsocket\fP is implemented as a builtin to allow full use of shell
 command line editing, file I/O, and job control mechanisms\&.
-.RS
 .PP
 .SS "Outbound Connections"
 .PP
-----------------------------

--
                             Eric S. Raymond