[OpenAFS-Doc] Re: [OpenAFS-devel] "openafs" man page

Chaz Chandler clc31@inbox.com
Thu, 25 Feb 2010 15:53:34 -0500


> 
>> If there is consensus that using a man page would be inappropriate,
>> I am not opposed to generating a new document.   Looking at the
>> contents of some /usr/doc/<project>/ directories, I often see
>> separate text only files for AUTHORS, CHANGELOG, COPYING or LICENSE,
>> INSTALL, NEWS, README, etc.  We could certainly do the same or install
>> .html and .pdf versions of the documentation files which could include
>> the same contents.
> 
> I have tools to convert a well-formatted text file to HTML that I use for
> all of my web pages, including handling of documents like this.  I can get
> something like that working for OpenAFS as well.
> 


>> We might also want to add a link to
> 
>>   https://www.ohloh.net/p/openafs/contributors
> 
>> which generates a list from the Git repository contents.

You can also get a list like this:

git log --pretty=format:"%an" | sort | uniq


Where do we stand on this?  READMEs, man pages?