Subject: lib/36789: bug in modification of the openssl man pages (lib/crypto/man)
To: None <lib-bug-people@netbsd.org, gnats-admin@netbsd.org,>
From: Chris Ross <cross+netbsd@distal.com>
List: netbsd-bugs
Date: 08/15/2007 15:50:00
>Number: 36789
>Category: lib
>Synopsis: openssl command man-pages referenced incorrectly
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: lib-bug-people
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Wed Aug 15 15:50:00 +0000 2007
>Originator: Chris Ross
>Release: NetBSD 4.0_BETA2
>Organization:
>Environment:
System: NetBSD host.distal.com 4.0_BETA2 NetBSD 4.0_BETA2 (GENERIC.MP) #5: Mon Jul 16 13:56:51 EDT 2007 cross@host.distal.com:/obj/sys/arch/i386/compile/GENERIC.MP i386
Architecture: i386
Machine: i386
>Description:
The man pages for the subcommands of openssl(1) are installed in
different locations than the openssl(1) man page points to (in "SEE ALSO").
>How-To-Repeat:
Look at the "SEE ALSO" section of the openssl(1) man page. Realize
that the section-1 man pages listed there don't exist [by those names].
>Fix:
The problem appears to be in lib/libcrypto/man/libcrypto.pl. It
searches for these specifically to do a replacement on the text, so that
the resulting man pages will mention openssl_FOO(1) for each FOO(1). However,
the regexp being used does *not* match the output from pod2man. It should be
easy to fix, and if you'd rather me send a patch, I can craft one. Perhaps
someone who knows pod2man better would be better to do that.