httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Mike Rumph <mike.ru...@oracle.com>
Subject Re: [RFC] Quoting arguments in examples (trunk vs 2.4)
Date Fri, 29 Jan 2016 13:17:51 GMT


On 1/28/2016 10:49 PM, Marion & Christophe JAILLET wrote:
>
> 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
Here is a little background on this.
These changes were done at the docathon at ApacheCon NA 2015 in answer 
to bug 53530.
- https://bz.apache.org/bugzilla/show_bug.cgi?id=53530
At least some of the changes were done in the 2.4 branch.
- http://svn.apache.org/viewvc?view=revision&revision=1673563
Some of the other revisions were r1673582, r1673651, r1673652, r1673653, 
r1673656, r1673657 and r1673658.
>
>
> CJ
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
>
>


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


Mime
View raw message