* Gustavo Delfino wrote:
> Hello all, I am new to this list. I am writing because I want to help make
> apache documentation better. I think this is important as I have spent
> many many hours trying to make and install my apache under FreeBSD
> correctly (and I'm still trying).
Welcome!
> My first comment is in regards to the INSTALL file. It contains the
> following text:
>
>> There are currently two layouts pre-defined in the file
>> config.layout: `Apache' for the classical Apache path layout and
>> `GNU' for a path layout conforming to the GNU `standards' document.
Doh, right. This one is quite outdated.
> -----------------------------------------
> There are many layouts pre-defined in the file
> config.layout: `Apache' for the classical Apache path layout,
> `GNU' for a path layout conforming to the GNU `standards' document, and
> there are other you can see by using the command:
>
> grep "^<Layout" config.layout
> -----------------------------------------
I see no reason to mention the GNU layout explicitly any longer. Additionally
the sentence before are not really correct, so I'd suggest to change it that
way:
Index: INSTALL
===================================================================
RCS file: /home/cvs/apache-1.3/INSTALL,v
retrieving revision 1.67
diff -u -r1.67 INSTALL
--- INSTALL 6 Jun 2003 19:48:50 -0000 1.67
+++ INSTALL 6 Sep 2003 17:31:43 -0000
@@ -216,11 +216,15 @@
chosen paths via the --layout option.
Use the --with-layout=[F:]ID option to select a particular installation
- path base-layout. You always _HAVE_ to select a base-layout. There are
- currently two layouts pre-defined in the file config.layout: `Apache' for
- the classical Apache path layout and `GNU' for a path layout conforming
- to the GNU `standards' document. When you want to use your own custom
- layout FOO, either add a corresponding "<Layout FOO>...</Layout>" section
+ path base-layout. There are many layouts pre-defined in the file
+ config.layout. Except on MacOS(X) configure defaults to the `Apache'
+ classical path layout. You can get an overview of the existing layouts
+ by using the command:
+
+ grep "^<Layout" config.layout
+
+ When you want to use your own custom layout FOO, either add a
+ corresponding "<Layout FOO>...</Layout>" section
to config.layout and use --with-layout=FOO or place it into your own
file, say config.mypaths, and use --with-layout=config.mypaths:FOO.
> or we could actually show the names of the layout available:
I don't like that, since it's harder to maintain (as you see in the current
INSTALL document).
> Please let me know what you think. I have noe idea of how to make these
> changes make it into the acual INSTALL file.
The best way to suggest changes is to use unified diffs. Once you have a CVS
checkout, you can modify the file, 'cvs diff -u', and send it as an attachment
(text/plain).
Thanks!
nd
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
