Bug#391002: too much .RE in zsh manpages
Hi Clint, Clint Adams schrieb am Mon 16. Oct, 18:54 (-0400): I can't rebuild the manpages. I can, but the output is broken after your patch. Which version of yodl do you use? % yodl --version yodl version 2.04a As I read there were heavy changes from 1.X to 2.0. Can't read `../../Doc/zsh.yo' Is that file not there? Yes it is there, but yodl search along the path given with -I and from there no such file exists. Schöne Grüße, Jörg. -- Prof: Ist etwas an der Tafel nicht zu lesen? Sie schauen so komisch. Studentin: Nein, es ist alles in Ordnung. Prof: Aber ihr Gesicht sieht überhaupt nicht in Ordnung aus. pgpvxLu57s5rC.pgp Description: PGP signature
Bug#391002: too much .RE in zsh manpages
I can't rebuild the manpages. I can, but the output is broken after your patch. Can't read `../../Doc/zsh.yo' Is that file not there? -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
Bug#391002: too much .RE in zsh manpages
Hi Clint,
Clint Adams schrieb am Wed 04. Oct, 05:19 (-0400):
you have more .RE than .RS in the zsh manpages.
% grep -c '\.RE' /tmp/zshcompsys.1
177
% grep -c '\.RS' /tmp/zshcompsys.1
171
The manpages are auto-generated. Is there a bug in the .yo files
or in yodl itself?
I can't rebuild the manpages.
% yodl --version
yodl version 2.04a
zsh: exit 1 yodl --version
% rm Doc/*.1
% make -C obj/Doc
make: Entering directory `/home/joerg/programmieren/pkg/zsh-4.3.2/obj/Doc'
yodl -o ../../Doc/zsh.1 -I../../Doc -w zman.yo version.yo ../../Doc/zsh.yo
Can't read `../../Doc/zsh.yo'
yodl -o ../../Doc/zshbuiltins.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshbuiltins.yo
Can't read `../../Doc/zshbuiltins.yo'
yodl -o ../../Doc/zshcompctl.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshcompctl.yo
Can't read `../../Doc/zshcompctl.yo'
yodl -o ../../Doc/zshcompwid.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshcompwid.yo
Can't read `../../Doc/zshcompwid.yo'
yodl -o ../../Doc/zshcompsys.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshcompsys.yo
Can't read `../../Doc/zshcompsys.yo'
yodl -o ../../Doc/zshcontrib.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshcontrib.yo
Can't read `../../Doc/zshcontrib.yo'
yodl -o ../../Doc/zshexpn.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshexpn.yo
Can't read `../../Doc/zshexpn.yo'
yodl -o ../../Doc/zshmisc.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshmisc.yo
Can't read `../../Doc/zshmisc.yo'
yodl -o ../../Doc/zshmodules.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshmodules.yo
Can't read `../../Doc/zshmodules.yo'
yodl -o ../../Doc/zshoptions.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshoptions.yo
Can't read `../../Doc/zshoptions.yo'
yodl -o ../../Doc/zshparam.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshparam.yo
Can't read `../../Doc/zshparam.yo'
yodl -o ../../Doc/zshroadmap.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshroadmap.yo
Can't read `../../Doc/zshroadmap.yo'
yodl -o ../../Doc/zshtcpsys.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshtcpsys.yo
Can't read `../../Doc/zshtcpsys.yo'
yodl -o ../../Doc/zshzftpsys.1 -I../../Doc -w zman.yo version.yo
../../Doc/zshzftpsys.yo
Can't read `../../Doc/zshzftpsys.yo'
yodl -o ../../Doc/zshzle.1 -I../../Doc -w zman.yo version.yo ../../Doc/zshzle.yo
Can't read `../../Doc/zshzle.yo'
yodl -o ../../Doc/zshall.1 -I../../Doc -DZSHALL -w zman.yo version.yo zsh.yo
zman.yo:1: STARTDEF() is deprecated. INCWSLEVEL() is used instead
Zsh Yodl-to-man converter
zman.yo:6: DEFINESYMBOL: Missing parameter list. `(' expected
make: Leaving directory `/home/joerg/programmieren/pkg/zsh-4.3.2/obj/Doc'
#v+
diff -u -x '*.1' -x '*.texi' -r zsh-4.3.2/Doc/version.yo
/home/joerg/programmieren/pkg/zsh-4.3.2/Doc/version.yo
--- zsh-4.3.2/Doc/version.yo2006-03-02 15:29:07.0 +0100
+++ /home/joerg/programmieren/pkg/zsh-4.3.2/Doc/version.yo 2006-10-08
03:25:10.0 +0200
@@ -1,4 +1,4 @@
-STARTDEF()
+INCWSLEVEL()
def(version)(0)(4.3.2)
def(date)(0)(March 2, 2006)
-ENDDEF()\
+DECWSLEVEL()\
diff -u -x '*.1' -x '*.texi' -r zsh-4.3.2/Doc/zmacros.yo
/home/joerg/programmieren/pkg/zsh-4.3.2/Doc/zmacros.yo
--- zsh-4.3.2/Doc/zmacros.yo2005-08-19 15:51:12.0 +0200
+++ /home/joerg/programmieren/pkg/zsh-4.3.2/Doc/zmacros.yo 2006-10-08
03:36:15.0 +0200
@@ -1,4 +1,4 @@
-STARTDEF()
+INCWSLEVEL()
DEFINEMACRO(includefile)(1)(\
TYPEOUT(Including file ARG1)\
@@ -13,7 +13,7 @@
UNDEFINEMACRO(ARG1)\
)
DEFINEMACRO(redef)(3)(\
- UNDEFINEMACRO(ARG1)\
+ DELETEMACRO(ARG1)\
DEFINEMACRO(ARG1)(ARG2)(ARG3)\
)
@@ -32,4 +32,4 @@
DEFINEMACRO(ifztexi)(1)()
DEFINEMACRO(ifnztexi)(1)(ARG1)
-ENDDEF()
+DECWSLEVEL()
diff -u -x '*.1' -x '*.texi' -r zsh-4.3.2/Doc/zman.yo
/home/joerg/programmieren/pkg/zsh-4.3.2/Doc/zman.yo
--- zsh-4.3.2/Doc/zman.yo 2001-06-28 19:02:57.0 +0200
+++ /home/joerg/programmieren/pkg/zsh-4.3.2/Doc/zman.yo 2006-10-08
04:04:29.0 +0200
@@ -1,7 +1,7 @@
-STARTDEF()
+INCWSLEVEL()
TYPEOUT(Zsh Yodl-to-man converter)
-DEFINESYMBOL(zman)
+DEFINESYMBOL(zman)()
INCLUDEFILE(zmacros)
redef(ifzman)(1)(ARG1)
@@ -25,10 +25,10 @@
COMMENT(--- emphasised text ---)
-def(em)(1)(NOTRANS(\fI)ARG1NOTRANS(\fP))
-def(bf)(1)(NOTRANS(\fB)ARG1NOTRANS(\fP))
-def(tt)(1)(NOTRANS(\fB)ARG1NOTRANS(\fP))
-def(var)(1)(NOTRANS(\fI)ARG1NOTRANS(\fP))
+def(em)(1)(NOTRANS(\fI)ARG1+NOTRANS(\fP))
+def(bf)(1)(NOTRANS(\fB)ARG1+NOTRANS(\fP))
+def(tt)(1)(NOTRANS(\fB)ARG1+NOTRANS(\fP))
+def(var)(1)(NOTRANS(\fI)ARG1+NOTRANS(\fP))
COMMENT(--- man page headers ---)
@@ -81,14 +81,14 @@
)
def(comment)(1)(\
USECHARTABLE(roffcomment)\
- NOTRANS(.\ )ARG1\
+ NOTRANS(.\ )ARG1+NL()\
USECHARTABLE(standard)\
)
COMMENT(--- cross-references ---)
def(manref)(2)(\
- NOTRANS(\fI)ARG1NOTRANS(\fP)(ARG2)\
+ NOTRANS(\fI)ARG1+NOTRANS(\fP)(ARG2)\
)
def(zmanref)(1)(manref(ARG1)(1))
def(noderef)(1)(the section `ARG1')
@@ -116,7 +116,7 @@
Bug#391002: too much .RE in zsh manpages
Package: zsh
Version: 4.3.2-18
Severity: minor
Tags: patch
Hi,
you have more .RE than .RS in the zsh manpages.
% grep -c '\.RE' /tmp/zshcompsys.1
177
% grep -c '\.RS' /tmp/zshcompsys.1
171
diff -u -ur man1~/zshcompctl.1 man1/zshcompctl.1
--- man1~/zshcompctl.1 2006-10-01 00:59:38.0 +0200
+++ man1/zshcompctl.1 2006-10-04 02:08:57.0 +0200
@@ -342,7 +342,6 @@
which forces completion to look back in the history list for a word if
no filename matches\.
.RE
-.RE
.PP
.SS Control Flags
These do not directly specify types of name to be completed, but
diff -u -ur man1~/zshcompsys.1 man1/zshcompsys.1
--- man1~/zshcompsys.1 2006-10-01 00:59:38.0 +0200
+++ man1/zshcompsys.1 2006-10-04 02:08:57.0 +0200
@@ -427,7 +427,6 @@
Wherever applicable, the \fB\-a\fP option makes the \fIfunction\fP
autoloadable, equivalent to \fBautoload \-U \fP\fIfunction\fP\.
.RE
-.RE
.PP
The function \fBcompdef\fP can be used to associate existing completion
functions with new commands\. For example,
@@ -3349,9 +3348,6 @@
only to the words after the option\. When preceded by three colons, they
are modified to refer only to the words covered by this description\.
.RE
-.RE
-.RE
-.RE
.PP
Any literal colon in an \fIoptname\fP, \fImessage\fP, or \fIaction\fP
must be preceded by a backslash, `\fB\e:\fP\'\.
@@ -3510,7 +3506,6 @@
typically in an expansion of the form [EMAIL PROTECTED]' which preserves empty
elements of the array\.
.RE
-.RE
.PP
During the performance of the action the array `\fBline\fP\'
will be set to the command name and normal arguments from the command
diff -u -ur man1~/zshcompwid.1 man1/zshcompwid.1
--- man1~/zshcompwid.1 2006-10-01 00:59:38.0 +0200
+++ man1/zshcompwid.1 2006-10-04 02:08:57.0 +0200
@@ -830,7 +830,6 @@
.PP
Note that this builtin is defined by the \fBzsh/compctl\fP module\.
.RE
-.RE
.PP
.SH CONDITION CODES
.PP
diff -u -ur man1~/zshcontrib.1 man1/zshcontrib.1
--- man1~/zshcontrib.1 2006-10-01 00:59:38.0 +0200
+++ man1/zshcontrib.1 2006-10-04 02:08:57.0 +0200
@@ -133,7 +133,6 @@
Without the \fB\-p\fP option, \fBzrecompile\fP does not create function digests
that do not already exist, nor does it add new functions to the digest\.
.RE
-.RE
.PP
The following shell loop is an example of a method for creating function
digests for all functions in your \fBfpath\fP, assuming that you have write
@@ -304,7 +303,6 @@
.PD
.PP
If the \fIstate\fP is omitted, \fBall\fP is assumed\.
-.RE
.PP
With the exception of `\fBall\fP\', every \fIstate\fP can be abbreviated by
any prefix, even a single letter; thus \fBa\fP is the same as \fBaliases\fP,
@@ -1413,7 +1411,6 @@
may be set to an array to give the command and options that will be used to
investigate the command word found\. The default is \fBwhence \-c\fP\.
.RE
-.RE
.PP
.SS Styles
.PP
@@ -1610,7 +1607,6 @@
Check the documentation for the calling widget or function to determine
whether the \fBwidget\fP style is used\.
.RE
-.RE
.PP
.SH EXCEPTION HANDLING
.PP
@@ -1897,7 +1893,6 @@
.RE
.RE
.RE
-.RE
.TP
\fBpick\-web\-browser\fP
This function is separate from the two MIME functions described above
@@ -1939,7 +1934,6 @@
instance of Opera, Konqueror or Netscape, in that order, and if it
fails to find any should attempt to start Opera\.
.RE
-.RE
.PP
.SH OTHER FUNCTIONS
.PP
@@ -2383,7 +2377,6 @@
\fIsubcontext\fP may be the empty string to re\-use the first context
unchanged\.
.RE
-.RE
.PP
.SS Styles
.PP
diff -u -ur man1~/zshexpn.1 man1/zshexpn.1
--- man1~/zshexpn.1 2006-10-01 00:59:38.0 +0200
+++ man1/zshexpn.1 2006-10-04 02:08:57.0 +0200
@@ -832,7 +832,6 @@
in `\fB${${(z)foo}[2]}\fP\'\. Likewise, to remove the quotes in the
resulting words one would do: `\fB${(Q)${(z)foo}}\fP\'\.
.RE
-.RE
.PP
The following flags (except \fBp\fP) are followed by one or more arguments
as shown\. Any character, or the matching pairs `\fB(\fP\.\.\.\fB)\fP\',
@@ -1041,7 +1040,6 @@
.PP
If a single word is not required, this rule is skipped\.
.RE
-.RE
.PP
.SS Examples
The flag \fBf\fP is useful to split a double\-quoted substitution line by
diff -u -ur man1~/zshmisc.1 man1/zshmisc.1
--- man1~/zshmisc.1 2006-10-01 00:59:38.0 +0200
+++ man1/zshmisc.1 2006-10-04 02:08:57.0 +0200
@@ -1952,4 +1952,3 @@
space\. Without the `\fB%\fP\', those two characters would be included
in the string to be truncated\.
.RE
-.RE
diff -u -ur man1~/zshmodules.1 man1/zshmodules.1
--- man1~/zshmodules.1 2006-10-01 00:59:38.0 +0200
+++ man1/zshmodules.1 2006-10-04 02:08:57.0 +0200
@@ -171,7 +171,6 @@
\fBclone\fP is mostly useful as a shell built\-in replacement for
openvt\.
.RE
-.RE
.SH THE ZSH/COMPCTL MODULE
.\ Yodl file: Zsh/mod_compctl.yo
@@ -672,7 +671,6 @@
If \fB\-s\fP \fIscalar\fP is given, assign the date to \fIscalar\fP instead
of printing it\.
.RE
-.RE
.PP
The \fBzsh/datetime\fP
Bug#391002: too much .RE in zsh manpages
you have more .RE than .RS in the zsh manpages. % grep -c '\.RE' /tmp/zshcompsys.1 177 % grep -c '\.RS' /tmp/zshcompsys.1 171 The manpages are auto-generated. Is there a bug in the .yo files or in yodl itself? -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
