William A. Rowe, Jr. wrote:

At 09:05 PM 5/26/2004, Stas Bekman wrote:


I've posted the following wording:

/**
* Validate hashes created by APR-supported algorithms: md5 and base64.
* hashes created by crypt are supported only on platforms that provide
* crypt(3), so don't rely on that function unless you know that your
* application will be run only on platforms that support it.
* @param passwd The password to validate
* @param hash The password to validate against
*/

Is that good enough?


_Please_ use @bug to document any platform specific, unpredictable,
or wildly incorrect behavior.  The days of /* XXX: */ should be long gone
now that doxygen will tabulate all our problems for us :)

Cool!

Bill

Reply via email to