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
Date: Thu, 1 Nov 2001 21:57:49 -0500
From: Christopher Faylor <cgf AT redhat DOT com>
To: cygwin-developers AT cygwin DOT com
Subject: Re: setup doco
Message-ID: <20011101215749.A7109@redhat.com>
Reply-To: cygwin-developers AT cygwin DOT com
Mail-Followup-To: cygwin-developers AT cygwin DOT com
References: <1004669085 DOT 5558 DOT 36 DOT camel AT lifelesswks>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <1004669085.5558.36.camel@lifelesswks>
User-Agent: Mutt/1.3.21i

On Fri, Nov 02, 2001 at 01:44:44PM +1100, Robert Collins wrote:
>I'm about to write up some doco on setup & related topics, covering
>setup.exe
>progamming setup.exe
>setup.hint
>creating packages
>categories
>
>Now, some of this - categories, setup.hint and creating packages isn't
>strictly setup.exe dependent.
>
>I'd like that stuff to be available as html from the website, to point
>contributors to. (Rather than repeating it in the cygwin-apps list n
>times).

setup.hint and setup.ini are already documented on the
http://cygwin.com/setup.html web pages.

You can make changes to it if you want.  I think I gave you the ability
to update the web site long ago.

>I have a very useful XML/XSL docbook build environment that I really
>like using, but it requires automake (1.4 or 1.5) - is there any issue
>with me adding the documentation in cinstall/doco as a sub package? (I
>use this on cygwin and on linux do generate doco).

cinstall is your directory, now.  Go nuts.

Also, if you want to change categories, for the most part, you just have
to edit setup.ini, currently.  A few packages are controlled via
setup.hint, too, so those will have to be changed as well.

You should be able to safely edit setup.ini file as long as no one is
adding a new package.  Hmm.  Maybe I should add some kind of lock control.

As I said in the cygwin mailing list, though, I don't think that
revamping the categories from the Debian structure (with the possible
exception of Required) makes much sense.  It is your call, though.

cgf