docs/65530: [patch] minor improvement to getgrent(3)

[Mikhail Teterin]

четвер 12 жовтень 2006 04:45, Tom Rhodes написав:
> This information is duplicated from the /usr/include/grp.h
> header file, we should change both or none.

Why? Header files are only a second-from-last sources of information 
(implementation being the last). A good manual page leaves no need to look at 
the declaration.

> I don't see a good reason to really change them right now as it seems seems
> self-explainatory.  Thanks for the submission!

?? The information was put there in 1996 -- it just got lost because of a cvs 
mishap.

I don't believe it to be self-explanatory -- there is not even a single 
example in the man-page. One could *guess*, that the list is null terminated, 
but it should be explicit, or else time will be wasted searching for other 
api (getgroupnumber() ?) or writing test-programs.

Yours,

	-mi

http://www.freebsd.org/cgi/query-pr.cgi?pr=65530