httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Marion & Christophe JAILLET <christophe.jail...@wanadoo.fr>
Subject [RFC] Quoting arguments in examples (trunk vs 2.4)
Date Fri, 29 Jan 2016 06:49:16 GMT


Le 15/04/2015 19:46, coar@apache.org a écrit :
> Author: coar
> Date: Wed Apr 15 17:46:53 2015
> New Revision: 1673892
>
> URL: http://svn.apache.org/r1673892
> Log:
> Enclose parameters in quotation marks for <{Files,Directory,Location}{,Match}>
> containers.

Le 15/04/2015 20:04, coar@apache.org a écrit :
> uthor: coar
> Date: Wed Apr 15 18:04:39 2015
> New Revision: 1673908
>
> URL:http://svn.apache.org/r1673908
> Log:
> Quote {Alias,Redirect,ScriptAlias}{,Match} arguments.


Hi,

last year, several patches on doc have been made in order to add
some quotation marks around many strings in the docs. (examples above)
None of these changes have been merged in 2.4.x yet.

One syntax or the other is mostly a matter of taste.


On one side, i'm not really keen on this change, because it is more
verbose, without any extra benefit

LoadFile"libexec/libxmlparse.so" vs LoadFilelibexec/libxmlparse.so

On the other side, it helps syntax color highlighting of the doc, which
is great.


Anyway, keeping the drift between the 2 is not a solution. It makes life
harder when making some 'diff' or when merging changes


Any thought?

[ ] quoting everywhere should be backported in 2.4.x
[ ] please remove this overloaded syntax from example in trunk


CJ


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


Mime
View raw message