Re: Question about header file documentation

["Michael F. Brown" <mbrown@emc.com>]

cscope is also great utility for accomplishing this:

http://cscope.sourceforge.net/


-Michael F. Brown, Sym API - EMC Corp.

email:  mbrown@emc.com
phone:  (800) 445-2588   x11390

"I wonder if pawns just realize that they're just pawns
 in someone's (chess) game."   -L. Fitzgerald Sjöberg

On Thu, 12 Apr 2001, Ralph Corderoy wrote:

> Date: Thu, 12 Apr 2001 18:46:16 +0100
> From: Ralph Corderoy <ralph@inputplus.demon.co.uk>
> To: Chris Snow <chris@baldric.uwo.ca>
> Cc: kernelnewbies@nl.linux.org
> Subject: Re: Question about header file documentation
>
>
> Hi Chris,
>
> > However, it seems like none (or very few) of the kernel header files do
> > this.  Is there a particular reason that I don't see ??
>
> I can't answer for the various authors but I wouldn't do it because
> it's duplicating information easily obtained in another way, e.g.
> ctags, and unlike a mechanical method can become out of date and be
> mis-leading, as can many comments.
>
> Comments can be useful, but never believe them.  :-)
>
>
> Ralph.
>
> -
> Kernelnewbies: Help each other learn about the Linux kernel.
> Archive:       http://mail.nl.linux.org/
> IRC Channel:   irc.openprojects.net / #kernelnewbies
> Web Page:      http://www.kernelnewbies.org/
>

-
Kernelnewbies: Help each other learn about the Linux kernel.
Archive:       http://mail.nl.linux.org/
IRC Channel:   irc.openprojects.net / #kernelnewbies
Web Page:      http://www.kernelnewbies.org/