On Thu, May 30, 2002 at 03:43:34PM +0200, Bodo Moeller wrote:
> On Thu, May 30, 2002 at 03:39:21PM +0200, Richard Levitte - VMS Whacker wrote:
> >> Specifically, we'd have to test that multi-line NAME sections are
> >> handled correctly; it appears this bug was fixed only recently in the
> >> pod2man that comes with Perl.
>
> > Hmm, I tested with doc/crypto/des.pod with the pod2man.pl we had
> > before the small fix that supposedly fixed this (-r 1.1), and I can't
> > see anything wrong with the output.
> >
> > If you could tell me what the difference is between a broken pod2man
> > and a working one, I might be able to make an appropriate test...
>
> The bug reported that led to the change was
>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
> Christoph Martin <[EMAIL PROTECTED]>:
> > Wichert Akkerman writes:
>
> >> Package: openssl
> >> Version: 0.9.6-1
> >> Severity: normal
> >>
> >> The HISTORY section of RAND_add(3ssl) isn't formated correctly, its end
> >> looks like this:
> >>
> >> RAND_event() in OpenSSL 0.9.5a.
> >>
> >> entropy to the PRNG"
>
> > The .pod file is incorrect. Apparently you are not allowed to have
> > more than one line in the NAME section. The following patch fixes
> > this.
> <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
>
> A later comment was
>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
> The pod2man which comes with perl 5.6 has the same problem.
> <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
I remember having had problems with multi line NAME sections.
The solution for me was simple: I made sure that all manual pages I wrote
only had a single line, even a long one, in the NAME section.
We therefore do have another option for this problem.
Falling back to a delivered pod2man.pl in case the system does not have
however seems to be reasonable for me.
Best regards,
Lutz
--
Lutz Jaenicke [EMAIL PROTECTED]
http://www.aet.TU-Cottbus.DE/personen/jaenicke/
BTU Cottbus, Allgemeine Elektrotechnik
Universitaetsplatz 3-4, D-03044 Cottbus
______________________________________________________________________
OpenSSL Project http://www.openssl.org
Development Mailing List [EMAIL PROTECTED]
Automated List Manager [EMAIL PROTECTED]
