Guy Harris wrote:
On Tue, May 25, 2004 at 08:57:58AM -0400, Carlos Pignataro wrote:
There's 2 small issues with ethereal man page:
1. Since now ethereal.1 is made from pod2man $(srcdir)/ethereal-tmp.pod, the man title
now displays "ETHEREAL-TMP 1" instead of "ETHEREAL 1":
man ethereal | head
ETHEREAL-TMP(1) The Ethereal Network Analyzer ETHEREAL-TMP(1)
We might want to rename "ethereal.pod" back to to "ethereal.pod.in" and
generate "ethereal.pod" from it and from AUTHORS-SHORT.
Seems to be the right way, but how do we rename files in CVS?
2. Since make-authors-short.pl is making AUTHORS-SHORT with all lines starting without
space or tab, pod is treating the paragraphs as `Ordinary Paragraph' instead of
`Verbatim Paragraph' [check man perlpod] and misaligning:
...
The following patch fixes #2 by prepending a space into all non empty lines.
Unfortunately, that appears to cause *all* the stuff from the AUTHORS
file to be turned into verbatim text, including the paragraphs after the
list of authors.
Hmmm, that might not be nice, but would be acceptable.
It also means that every line in AUTHORS-SHORT begins with a space; that
causes a space before every line in the "Authors" page of the "About"
dialog if Ethereal is built with GTK+ 1.3[.x] or 2.x. That might be OK,
but....
That will be also ok IMO.
Another (better?) solution would be to give the perl script a parameter
which controls, if it should prepend a space or not.
Regards, ULFL
