This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [PATCH][BZ #6885] Clarify description of __freading and __fwriting


On 01/09/2013 08:07 PM, Roland McGrath wrote:
>> +The @code{__freading} and @code{__fwriting} functions exist primarily for use
>> +by gnulib and for other legacy software.  Their use in new programs is not
>> +recommended.
> 
> If we were to mention gnulib it would belong in @file or something.  But I
> don't think we should use wording like this.  If we want to discourage use
> of an interface, the the manual should describe why it's suspect to use it
> and what patterns we recommend instead that make its use unnecessary.
 
Agreed.

Cheers,
Carlos.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]