Mailing-List: contact dev-help@geronimo.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@geronimo.apache.org
Received-SPF: pass (asf.osuosl.org: domain of bruce.snyder@gmail.com
 designates 64.233.162.193 as permitted sender)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
        s=beta; d=gmail.com;
        h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references;
        b=UFm2ABRl+wu29m/beJR0Tj+M8LpkYBExfwBmtfqL6nhrSAa/79X6kVhKisngvMtg0LRs6hkNW+B93n/1Zc08IVgZ2VfbUvuN6lqVpsggvCCpbBdNpDQv6DmTCr27eFCSoGrddKwqRKSZ6QHmPqoS46H9vlEh7Oic8XGTLi/QsBs=
Message-ID: <7b3355cb0512032330m4383dbd0r9cfc8fc0acf7cfbb@mail.gmail.com>
Date: Sun, 4 Dec 2005 00:30:23 -0700
From: Bruce Snyder <bruce.snyder@gmail.com>
To: dev@geronimo.apache.org
Subject: Re: files in var/config directory
In-Reply-To: <43929344.7070108@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline
References: <43929344.7070108@gmail.com>

On 12/3/05, John Sisson <jrsisson@gmail.com> wrote:
> On the user list Erin suggested (see mail below) that some of the files
> in the var/config directory be renamed.
>
> * Does renaming the files make less sense now that users can instruct
> Geronimo to use a specific config file (instead of the default
> config.xml file) by setting the org.apache.geronimo.config.file system
> property?

I think that in addition to the org.apache.geronimo.config.file sytem
property a README.txt file in the directory spelling things out is
sufficient.

> * Erin's suggestion of the README file is worthwhile.  I suggest we call
> the README file README.txt (to simplify fixcrlf processing at packaging
> time and to make it easier for windows users to view).

+1

> * In the long term I think we should also have README.txt files in other
> major Geronimo directories so administrators can quickly familiarise
> themselves with the purpose of directories (without having to find and
> read through a  manual).  The README is not a replacement for a manual
> and can contain URLs for the full documentation.

+1 to README.txt files in major directories - and meaningful ones at
that. I don't want to crack open one of these README.txt files and see
a two sentence description, but I also don't want to see one that's
800k either.

Bruce
--
perl -e 'print unpack("u30","D0G)U8V4\@4VYY9&5R\"F)R=3D6-E+G-N>61E<D\!G;6%I=
;\"YC;VT*"
);'

The Castor Project
http://www.castor.org/

Apache Geronimo
http://geronimo.apache.org/