Hi there,
Slowly catching up on some of this ticket discussion ...
On Thu, 30 May 2002, Lutz Jaenicke wrote:
> On Thu, May 30, 2002 at 03:43:34PM +0200, Bodo Moeller wrote:
> > 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.
We already assume an adequate version of perl, bc, etc when building and
testing. I don't think it would hurt to assume the presence of an
installed pod2man for those wanting to build docs (this is a similar
problem to many other source packages). Those who don't have or want those
extras installed shouldn't try building the documentation from source.
OTOH: Why not compromise - let it fail if there's no pod2man installed (as
it does now) but emit an error message that a bundled ("though potentially
out-of-date") script exists that can be used by setting an env-var? We
could similarly emit some version information about the bundled version so
the builder could then decide whether to use that or install the latest
from CPAN or wherever. I don't think use of a bundled version should be
automatic - we obviously can't hope to keep that up-to-date and using it
automatically would imply otherwise.
Cheers,
Geoff
--
Geoff Thorpe, geoff(at)openssl(dot)org
The thirst for power is base. The desire to combat and conquer, more base
still. Beware bassists writing foreign policy. Les Claypool for president??
______________________________________________________________________
OpenSSL Project http://www.openssl.org
Development Mailing List [EMAIL PROTECTED]
Automated List Manager [EMAIL PROTECTED]
