I have made a little patch to allow man pages to be installed in
the standard path for RedHat. The goal was to build a rpm. If the changes
are acceptable to OpenSSL team, I would like to see this patch integrated
in OpenSSL. Maintaining it separately is an overkill if the man pages
change often.
The changes:
1) Changed openssl subcommands from level 1 to level 1s. I did this
for two reasons:
First, passwd.1 conflicts with the page of the passwd command.
This creates problems on systems like RedHat that store all man pages in a
common place like /usr/man. This effectively prevented me from making a
nice RPM. Even if there are no file conflicts, there is still a problem
because one of the man pages would not be directly visible anyway.
Second, this seemed to me the right thing to do (TM). I left the
openssl and CA.pl commands in level 1 where they belong, but IMHO all
openssl subcommands should not "pollute" this namespace. So, I put those in
1s.
I modified the SEE ALSO section of all pages where applicable to
reflect this. I also tweaked the makefile. I hope this works on other
systems as well, but I didn't test it.
2) Added some missing pages to openssl(1) SEE ALSO section.
3) Fixed the dgst(1s) page. The syntax lacked openssl.
4) Changed rand.3 to RAND.3 to avoid conflict with stdlib's
rand(). There is no rand() function in OpenSSL anyway. This page serves as
an intro for the other RAND_* pages. This is only a quick hack, because I
grew tired of all the changes I had to make so far. I suggest that you
change the man pages for the other functions to capital letters to reflect
actual prefixes of openssl functions. IMHO 'dh' should be 'DH' and so on.
That's it. I hope this list is the place to post patches. I
couldn't find another address...
I've also uploaded a RPM of openssl with the patch applied to:
ftp://ftp.zedz.net/pub/crypto/incoming/
Get release 2 (openssl-[devel]-0.9.5-2-*).
Cheers,
Vasile
______________________________________________________________________
OpenSSL Project http://www.openssl.org
Development Mailing List [EMAIL PROTECTED]
Automated List Manager [EMAIL PROTECTED]