This is the mail archive of the
cygwin-developers@sources.redhat.com
mailing list for the Cygwin project.
Re: winsup/doc layout change?
- To: tailbert at yahoo dot com
- Subject: Re: winsup/doc layout change?
- From: DJ Delorie <dj at delorie dot com>
- Date: Thu, 7 Dec 2000 12:30:20 -0500
- CC: cygwin-developers at sources dot redhat dot com
- References: <FMEOJCMLNIMPBKAPFPIHCEFHCFAA.tailbert@yahoo.com>
> cygwin-api/
> cygwin-api-int/
> cygwin-ug/
> cygwin-ug-net/
The *-net variants are derived from the base variant. There shouldn't
be any need to keep the two separate, and jade puts the output files
in separate subdirectories anyway.
> doctool/ <- source for doctool.exe
A whole directory for one source file?
> sgml/ <- sgml sources
> texinfo/ <- texinfo sources
Sources for what? If they're part of the api, ug, or faq docs then
they'd already be elsewhere.
> text/ <- random text files until we have real docs
Those could just stay in the doc/ directory.
> utils/ <- sgml files for the apps in utils
I'd rather keep those with the utils. DJGPP history has shown that
keeping doc files adjacent to source files promotes doc writing. The
whole point of doctool is to put the documentation *in* the sources,
to push this concept even further.