daz wrote:
>
> /**********************************************************************
>
>   iconv.c -
>
>   $Author: nobu $
>   $Date: 2005/03/27 23:40:02 $
>   created at: Wed Dec  1 20:28:09 JST 1999
>
>   All the files in this distribution are covered under the Ruby's
>   license (see the file COPYING).
>
>   Documentation by Yukihiro Matsumoto and Gavin Sinclair.
>
> **********************************************************************/
>
> Is there a case for having a $Doc: Name $ in the header ?

What would that do?

> Perhaps also a standard way to add contributors names to doc updates
> which doesn't wipe out the original documentor's name (as seems to
> happen with $Author: Name $ in many patched core files).

But author and documenter are often different people.  Recording the
credits in plain text (as above) ensures they are not lost as CVS tags
come and go.

> $Doc: Dave Thomas; gs; jeg; kj $  - which magically expands to HTML
> links for each member on ruby-doc-squad-wiki.org might be possible
> (later?).

Are you suggesting that every person who cvs commits a file is
recorded?

Cheers,
Gavin