[Patch] Document __secure_getenv

[Florian Weimer]

On 07/11/2012 03:43 PM, Roland McGrath wrote:

> No function starting with __ is intended for general public use and is thus
> appropriate for the manual.  If there is interest in making this a public
> interface, then we should export it with a public name (and document it).

It is exported and already documented in <stdlib.h>.  There are 
precedents for documenting __ symbols in the manual, such as __freading.

__secure_getenv has been available basically since forever.  I hope it's 
not going away.  In application code, an alternative name would need a 
configure check or libc version check, plus an out-of-line copy or 
fallback to __secure_getenv.  Perhaps this is avoidable.

-- 
Florian Weimer / Red Hat Product Security Team