Lately, I've been incorporating the OpenSSL manual pages into
OpenBSD'S manual pages. Our project has been working really hard to
make sure that our man pages are perfect.
So, I'm basically running a ton of pod2man's to get them into decent
shape. That's all fine.
However, a few glitches remain, and in the interest of all projects, I
think it would be nice if a few changes were made.
As Timothy said before, crypto/rand.pod should probably become RAND.pod
Some other pages cause problems, if we wish to install these into the
system as a whole:
rand.pod
err.pod
rc4.pod
threads.pod
ripemd.pod
rc4.pod
etc.
These are function-describing manual pages which have a name, but that
name is not the function they export. This is manual page system
pollution. I do not want to install a threads(3) man page. I do not
want to install a err(3) man page either, since we already have one in
our system, and err() is a real function libc exports.
For instance, rc4.pod says:
void RC4_set_key(RC4_KEY *key, int len, const unsigned char *data);
void RC4(RC4_KEY *key, unsigned long len, const unsigned char *indata,
unsigned char *outdata);
I would prefer if the file in question called RC4_set_key.pod or
RC4.pod; and in either case things can cross-reference easily to
those.
If someone wants to work with me on this, please get in touch.
______________________________________________________________________
OpenSSL Project http://www.openssl.org
Development Mailing List [EMAIL PROTECTED]
Automated List Manager [EMAIL PROTECTED]
