httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Erik Abele <e...@codefaktor.de>
Subject Re: INSTALL
Date Sat, 06 Sep 2003 19:50:48 GMT
On 06/09/2003, at 07:37, André Malo wrote:
>
> 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.

+1.

>> 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).

Yep, nobody will remember to update the INSTALL file when a new layout 
gets added, so please let's be a bit generic here.

>> 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).

And, Gustavo, don't forget to read 
http://httpd.apache.org/docs-project/ if you haven't done so until now. 
Especially http://httpd.apache.org/docs-project/docsformat.html and 
also http://httpd.apache.org/dev/ will be helpful.

Cheers,
Erik

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message