Mailing-List: contact cygwin-developers-help AT sourceware DOT cygnus DOT com; run by ezmlm
List-Subscribe: <mailto:cygwin-developers-subscribe AT sources DOT redhat DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin-developers/>
List-Post: <mailto:cygwin-developers AT sources DOT redhat DOT com>
List-Help: <mailto:cygwin-developers-help AT sources DOT redhat DOT com>, <http://sources.redhat.com/ml/#faqs>
Sender: cygwin-developers-owner AT sources DOT redhat DOT com
Delivered-To: mailing list cygwin-developers AT sources DOT redhat DOT com
From: "edward" <tailbert AT yahoo DOT com>
To: "Cygwin Developers List" <cygwin-developers AT sources DOT redhat DOT com>
Subject: winsup/doc layout change?
Date: Thu, 7 Dec 2000 11:40:21 -0500
Message-ID: <FMEOJCMLNIMPBKAPFPIHCEFHCFAA.tailbert@yahoo.com>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3 (Normal)
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook IMO, Build 9.0.2416 (9.0.2910.0)
X-Mimeole: Produced By Microsoft MimeOLE V5.50.4133.2400
Importance: Normal
X-Apparently-From: Swiftnsavv AT aol DOT com

Hi CygPeepers,

(1) LAYOUT CHANGE

I've been looking at the ~winsup/doc directory and I would like to propose
the following layout change:

~winsup/doc/
	[some common files here, e.g. README, AUTHORS, etc.]
	cygwin-api/
	cygwin-api-int/
	cygwin-ug/
	cygwin-ug-net/
	doctool/		<- source for doctool.exe
	faq/
	sgml/			<- sgml sources
	texinfo/		<- texinfo sources
	text/			<- random text files until we have real docs
	utils/		<- sgml files for the apps in utils

The basic premise is to have subdirectories which contain major pieces of
documentation, like the cygwin-api and cygwin-ug (user guide). Each
directory should contain pretty much all you need for that given document.
The names I've used above are mostly to demonstrate the concept.

I'm fairly indifferent to the names as long as it makes sense.

(2) DOCUMENT SOURCE LANGUAGE

Right now, the documentation varies from simple text, to sgml to texinfo. I
propose we stick with one. DocBook 3.0 is what most of the current documents
use, so it's probably just easiest to go entirely to that.

Once we do that, we can get rid of some of the directories in the layout
above, like texinfo, and text.

(3) AUTOCONF/AUTOMAKE

Any objections to using autoconf/automake in the doc directory?
Specifically, the released versions of automake/autoconf.


When a decision is made about the previous points, I'd like to start working

(4) UTILS MANPAGES

on man pages for the winsup/cygwin/utils apps next.


Cheers,
edward

OH. PS. I've already done (1) - (3) in some form. Just needs to be fine
tuned to whatever is decided.