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

畷婟籤 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. ⒛hanks 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
_______________________________________________
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"