deraadt> > On Sun, 2 Apr 2000, Richard Levitte - VMS Whacker wrote:
deraadt> >
deraadt> > > There's another variant that was proposed here, but hasn't yet
deraadt> > > been implemented, and it's that the section wouldn't just be a
deraadt> > > number. Instead, something like 1ssl, 3ssl, 5ssl and 7ssl would
deraadt> > > be used. The result is that you'd get a threads(3ssl), err(3ssl),
deraadt> > > passwd(1ssl), rc4(3ssl).
deraadt> >
deraadt> > Why not openssl_passwd, openssl_err, etc?
deraadt>
deraadt> I think you missed the point I was making.
deraadt>
deraadt> Why not ERR_get_error(3)?
Thing is, that man page is not just about those functions, it's the
general description on how error codes work in OpenSSL, even how to
extend OpenSSL itself if you want to. So actually, even if you'd
choose one of the functions as the name of the file, the rest of them
will also appear in the whatis (apropos?) database, along with err
(actually, as it's written right now, with *only* err in the name, you
won't see the function names at all, which is not quite right).
So, since that page is about OpenSSL error codes and the handling of
them, rather than just a description of the functions you use, it's
slightly odd to have it function-based. Therefore, openssl_err is
actually a good idea.
Hmm, or rather, BOTH are good ideas. I'm suddenly getting the feeling
that pages like err(3) should really be split in two: openssl_err(7)
and ERR_<whatever>(3). Remember, section 7 is miscellaneous, and I
have a hard time thinking of any other section that could be used for
more general concept description. Theo, what do you say about that
thought? Everyone else, what do you say? Yes, it does require a bit
more work, but might be rewarding and perhaps give an even better
clarity to the OpenSSL functions.
Another thing remains that you haven't said one thing about, Theo.
Things like passwd(1), which is an OpenSSL manpage that conflicts with
the standard passwd(1), what would you do with those? It might be a
good thing to reconsider the 1ssl section I suggested earlier. There
are references from openssl(1) or openssl(1ssl), whichever you'd choose...
--
Richard Levitte \ Spannv�gen 38, II \ [EMAIL PROTECTED]
Chairman@Stacken \ S-168 35 BROMMA \ T: +46-8-26 52 47
Redakteur@Stacken \ SWEDEN \ or +46-708-26 53 44
Procurator Odiosus Ex Infernis -- [EMAIL PROTECTED]
Member of the OpenSSL development team
Unsolicited commercial email is subject to an archival fee of $400.
See <http://www.stacken.kth.se/~levitte/mail/> for more info.
______________________________________________________________________
OpenSSL Project http://www.openssl.org
Development Mailing List [EMAIL PROTECTED]
Automated List Manager [EMAIL PROTECTED]
