You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by Luca Toscano <to...@gmail.com> on 2020/02/08 10:20:14 UTC

Building docs for trunk and 2.4.x without changing char encoding

Hi everybody,

apologies in advance for my question, I haven't followed completely
all the past threads. I am trying to add some docs for mod_systemd,
and while building the trunk's docs I keep getting a diff like:

-<a href="./es/sitemap.html" hreflang="es" rel="alternate"
title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
-<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
+<a href="./es/sitemap.html" hreflang="es" rel="alternate"
title="Espa�ol">&nbsp;es&nbsp;</a> |
+<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
title="Fran�ais">&nbsp;fr&nbsp;</a> |

To build, I do the usual ./build.sh in docs/manual/build. I am aware
that there are issues with char encodings from a quick glance on older
threads, but I am wondering if there is a current best practice in how
to build docs to avoid committing weird changes :)

Thanks in advance,

Luca

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


Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Lucien Gentis <lu...@univ-lorraine.fr>.
Le 09/02/2020 à 16:34, Mike Rumph a écrit :
> Hello all,
>
> Like mentioned before to Eric, I apologize for committing the massive 
> changes resulting from switching to Java 11 without first discussing 
> it on docs (I just didn't understand the issues at that time).
> One thing is fairly certain is that we wouldn't want to keep switching 
> back and forth between Java 8 and Java 11.
> Which version does the buildbot use (probably Java 8).
> I took the approach of just letting the buildbot generate the .html 
> files with my commit for 2.4 branch.
> (Because I didn't want to do more damage until the issue is settled.)
>
> One solution that is used by some of the files is to switch to utf8.
> Notice that some of the files end in .html.<language> while others in 
> html.<language>.utf8.
Those in .html.<language> are in ISO-8859 (en, de), while those in 
html.<language>.utf8 are in UTF-8 (fr, es, ja, tr)
>
> Maybe there is also away to configure Java 11 to behave in a different 
> way.
>
>
>
> On Sun, Feb 9, 2020 at 7:13 AM Luca Toscano <toscano.luca@gmail.com 
> <ma...@gmail.com>> wrote:
>
>     Hi Lucien,
>
>     I am using java 8, not 11 :)
>
>     What Christophe suggested seems right, namely that Mike R. committed
>     with r1873229 new versions of files replacing UTF-8 chars with
>     something different. For example, in my current case the following
>     diff shows up after building:
>
>     docs/manual/rewrite/flags.html.en
>
>     -<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
>     title="Fran&#231;ais">&nbsp;fr&nbsp;</a></p>
>     +<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
>     title="Fran�ais">&nbsp;fr&nbsp;</a></p>
>
>     If you check r1873229 you'll see the following:
>
>     http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/rewrite/flags.html.en?limit_changes=0&r1=1873229&r2=1873228&pathrev=1873229
>
>     -<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
>     title="Fran�ais">&nbsp;fr&nbsp;</a></p>
>     +<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
>     title="Fran&#231;ais">&nbsp;fr&nbsp;</a></p>
>
>     So my build with Java 8 is basically reverting what Mike did after
>     building with Java 11. Not sure now what is the best path, or if the
>     is a workaround, this is why I asked in the last email what do we want
>     to do. Maybe just using Java 11 and stick with it?
>
>     Long term solution, in my opinion, is what Humbedooh suggested in
>     #httpd-dev on Freenode, namely commit .xml files and let buildbot to
>     automagically create html files (so we'll have only one way to build
>     things, on one platform).
>
>     Luca
>
>     Il giorno dom 9 feb 2020 alle ore 15:04 Lucien Gentis
>     <lucien.gentis@univ-lorraine.fr
>     <ma...@univ-lorraine.fr>> ha scritto:
>     >
>     > Hi,
>     >
>     > I cannot reproduce these diff here.
>     >
>     > I also have java 11 ; java --version gives :
>     >
>     > openjdk 11.0.6 2020-01-14
>     > OpenJDK Runtime Environment (build 11.0.6+10-post-Debian-1deb10u1)
>     > OpenJDK 64-Bit Server VM (build 11.0.6+10-post-Debian-1deb10u1,
>     mixed
>     > mode, sharing)
>     >
>     > I have downloaded trunk repos in a clean working directory and
>     launched
>     > "build.sh on it,
>     >
>     > and docs/manual/new_features_2_4.html.en still contains :
>     >
>     > <p><span>Available Languages: </span><a
>     > href="./en/new_features_2_4.html"
>     title="English">&nbsp;en&nbsp;</a> |
>     > <a href="./es/new_features_2_4.html" hreflang="es" rel="alternate"
>     > title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>     >
>     > where non ASCII characters are replaced by there html entities and
>     > "Espa&#241;ol"> is not replaced by "Espa�ol">
>     >
>     > Did you modify some file in manual/style directory ?
>     >
>     > Le 08/02/2020 à 19:33, Luca Toscano a écrit :
>     > > Hi Lucien,
>     > >
>     > > some of the files:
>     > >
>     > > docs/manual/rewrite/flags.html.en
>     > > docs/manual/new_features_2_4.html.en
>     > > docs/manual/mod/mod_systemd.html.en
>     > >
>     > > Il giorno sab 8 feb 2020 alle ore 18:29 Lucien Gentis
>     > > <lucien.gentis@univ-lorraine.fr
>     <ma...@univ-lorraine.fr>> ha scritto:
>     > >> In what file do you get the diff :
>     > >>
>     > >> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>     > >> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>     > >> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>     > >> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
>     > >> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>     > >> title="Espa�ol">&nbsp;es&nbsp;</a> |
>     > >> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>     > >> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>     > >>
>     > >> Le 08/02/2020 à 17:55, Luca Toscano a écrit :
>     > >>> Hi Mike,
>     > >>>
>     > >>> thanks for following up. I noticed the thread but I am using
>     java 8,
>     > >>> and I haven't had any problems with it in the past, so I
>     didn't try to
>     > >>> remove the Xbootclasspath parameter. I just did now but the
>     problem
>     > >>> persists, so it must be something else :(
>     > >>>
>     > >>> Luca
>     > >>>
>     > >>> Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
>     > >>> <mrumph68@gmail.com <ma...@gmail.com>> ha scritto:
>     > >>>> I should also mention that this difference does not appear
>     in the .html.utf8 files.
>     > >>>>
>     > >>>> On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph
>     <mrumph68@gmail.com <ma...@gmail.com>> wrote:
>     > >>>>> Hello Luca,
>     > >>>>>
>     > >>>>> See the previous thread related to commit r1873229:
>     > >>>>> -
>     http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
>     > >>>>>
>     > >>>>> I caused a problem or solved one depending on one's
>     perspective.
>     > >>>>> I created a massive change by running ./build.sh with 
>     Java 11.
>     > >>>>> (Was it right or wrong to commit those changes is up to
>     debate.)
>     > >>>>> To make ./build.sh work I needed to modify the script to
>     remove the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
>     > >>>>> There is another thread for this also in the above link.
>     > >>>>> That option is not in Java versions after Java 8.
>     > >>>>> So I think the change to use encodings was a side effect
>     of moving to Java 11.
>     > >>>>> What version of Java are you using?
>     > >>>>>
>     > >>>>> BTW. I committed the Java 11 changes to the trunk branch
>     but not to the 2.4 branch.
>     > >>>>>
>     > >>>>> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano
>     <toscano.luca@gmail.com <ma...@gmail.com>> wrote:
>     > >>>>>> Hi everybody,
>     > >>>>>>
>     > >>>>>> apologies in advance for my question, I haven't followed
>     completely
>     > >>>>>> all the past threads. I am trying to add some docs for
>     mod_systemd,
>     > >>>>>> and while building the trunk's docs I keep getting a diff
>     like:
>     > >>>>>>
>     > >>>>>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>     > >>>>>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>     > >>>>>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>     > >>>>>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
>     > >>>>>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>     > >>>>>> title="Espa�ol">&nbsp;es&nbsp;</a> |
>     > >>>>>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>     > >>>>>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>     > >>>>>>
>     > >>>>>> To build, I do the usual ./build.sh in docs/manual/build.
>     I am aware
>     > >>>>>> that there are issues with char encodings from a quick
>     glance on older
>     > >>>>>> threads, but I am wondering if there is a current best
>     practice in how
>     > >>>>>> to build docs to avoid committing weird changes :)
>     > >>>>>>
>     > >>>>>> Thanks in advance,
>     > >>>>>>
>     > >>>>>> Luca
>     > >>>>>>
>     > >>>>>>
>     ---------------------------------------------------------------------
>     > >>>>>> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
>     <ma...@httpd.apache.org>
>     > >>>>>> For additional commands, e-mail:
>     docs-help@httpd.apache.org <ma...@httpd.apache.org>
>     > >>>>>>
>     > >>>
>     ---------------------------------------------------------------------
>     > >>> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
>     <ma...@httpd.apache.org>
>     > >>> For additional commands, e-mail: docs-help@httpd.apache.org
>     <ma...@httpd.apache.org>
>     > >>>
>     > >>
>     ---------------------------------------------------------------------
>     > >> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
>     <ma...@httpd.apache.org>
>     > >> For additional commands, e-mail: docs-help@httpd.apache.org
>     <ma...@httpd.apache.org>
>     > >>
>     > >
>     ---------------------------------------------------------------------
>     > > To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
>     <ma...@httpd.apache.org>
>     > > For additional commands, e-mail: docs-help@httpd.apache.org
>     <ma...@httpd.apache.org>
>     > >
>     >
>     >
>     ---------------------------------------------------------------------
>     > To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
>     <ma...@httpd.apache.org>
>     > For additional commands, e-mail: docs-help@httpd.apache.org
>     <ma...@httpd.apache.org>
>     >
>
>     ---------------------------------------------------------------------
>     To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
>     <ma...@httpd.apache.org>
>     For additional commands, e-mail: docs-help@httpd.apache.org
>     <ma...@httpd.apache.org>
>

Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Luca Toscano <to...@gmail.com>.
Hi Mike,

no need to apologize! Anybody is welcome to work on docs, these are
weird encoding issues, we'll sort them out, it is just a matter of
deciding how to proceed :)

For buildbot, I am still not sure if it is doable or not, I'll follow
up with Humbedooh during the next days but I am pretty sure it might
take a while before we have it ready to test.

Luca

Il giorno dom 9 feb 2020 alle ore 16:34 Mike Rumph
<mr...@gmail.com> ha scritto:
>
> Hello all,
>
> Like mentioned before to Eric, I apologize for committing the massive changes resulting from switching to Java 11 without first discussing it on docs (I just didn't understand the issues at that time).
> One thing is fairly certain is that we wouldn't want to keep switching back and forth between Java 8 and Java 11.
> Which version does the buildbot use (probably Java 8).
> I took the approach of just letting the buildbot generate the .html files with my commit for 2.4 branch.
> (Because I didn't want to do more damage until the issue is settled.)
>
> One solution that is used by some of the files is to switch to utf8.
> Notice that some of the files end in .html.<language> while others in html.<language>.utf8.
>
> Maybe there is also away to configure Java 11 to behave in a different way.
>
>
>
> On Sun, Feb 9, 2020 at 7:13 AM Luca Toscano <to...@gmail.com> wrote:
>>
>> Hi Lucien,
>>
>> I am using java 8, not 11 :)
>>
>> What Christophe suggested seems right, namely that Mike R. committed
>> with r1873229 new versions of files replacing UTF-8 chars with
>> something different. For example, in my current case the following
>> diff shows up after building:
>>
>> docs/manual/rewrite/flags.html.en
>>
>> -<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a></p>
>> +<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
>> title="Fran�ais">&nbsp;fr&nbsp;</a></p>
>>
>> If you check r1873229 you'll see the following:
>>
>> http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/rewrite/flags.html.en?limit_changes=0&r1=1873229&r2=1873228&pathrev=1873229
>>
>> -<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
>> title="Fran�ais">&nbsp;fr&nbsp;</a></p>
>> +<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a></p>
>>
>> So my build with Java 8 is basically reverting what Mike did after
>> building with Java 11. Not sure now what is the best path, or if the
>> is a workaround, this is why I asked in the last email what do we want
>> to do. Maybe just using Java 11 and stick with it?
>>
>> Long term solution, in my opinion, is what Humbedooh suggested in
>> #httpd-dev on Freenode, namely commit .xml files and let buildbot to
>> automagically create html files (so we'll have only one way to build
>> things, on one platform).
>>
>> Luca
>>
>> Il giorno dom 9 feb 2020 alle ore 15:04 Lucien Gentis
>> <lu...@univ-lorraine.fr> ha scritto:
>> >
>> > Hi,
>> >
>> > I cannot reproduce these diff here.
>> >
>> > I also have java 11 ; java --version gives :
>> >
>> > openjdk 11.0.6 2020-01-14
>> > OpenJDK Runtime Environment (build 11.0.6+10-post-Debian-1deb10u1)
>> > OpenJDK 64-Bit Server VM (build 11.0.6+10-post-Debian-1deb10u1, mixed
>> > mode, sharing)
>> >
>> > I have downloaded trunk repos in a clean working directory and launched
>> > "build.sh on it,
>> >
>> > and docs/manual/new_features_2_4.html.en still contains :
>> >
>> > <p><span>Available Languages: </span><a
>> > href="./en/new_features_2_4.html" title="English">&nbsp;en&nbsp;</a> |
>> > <a href="./es/new_features_2_4.html" hreflang="es" rel="alternate"
>> > title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>> >
>> > where non ASCII characters are replaced by there html entities and
>> > "Espa&#241;ol"> is not replaced by "Espa�ol">
>> >
>> > Did you modify some file in manual/style directory ?
>> >
>> > Le 08/02/2020 à 19:33, Luca Toscano a écrit :
>> > > Hi Lucien,
>> > >
>> > > some of the files:
>> > >
>> > > docs/manual/rewrite/flags.html.en
>> > > docs/manual/new_features_2_4.html.en
>> > > docs/manual/mod/mod_systemd.html.en
>> > >
>> > > Il giorno sab 8 feb 2020 alle ore 18:29 Lucien Gentis
>> > > <lu...@univ-lorraine.fr> ha scritto:
>> > >> In what file do you get the diff :
>> > >>
>> > >> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>> > >> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>> > >> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>> > >> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
>> > >> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>> > >> title="Espa�ol">&nbsp;es&nbsp;</a> |
>> > >> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>> > >> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>> > >>
>> > >> Le 08/02/2020 à 17:55, Luca Toscano a écrit :
>> > >>> Hi Mike,
>> > >>>
>> > >>> thanks for following up. I noticed the thread but I am using java 8,
>> > >>> and I haven't had any problems with it in the past, so I didn't try to
>> > >>> remove the Xbootclasspath parameter. I just did now but the problem
>> > >>> persists, so it must be something else :(
>> > >>>
>> > >>> Luca
>> > >>>
>> > >>> Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
>> > >>> <mr...@gmail.com> ha scritto:
>> > >>>> I should also mention that this difference does not appear in the .html.utf8 files.
>> > >>>>
>> > >>>> On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph <mr...@gmail.com> wrote:
>> > >>>>> Hello Luca,
>> > >>>>>
>> > >>>>> See the previous thread related to commit r1873229:
>> > >>>>> - http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
>> > >>>>>
>> > >>>>> I caused a problem or solved one depending on one's perspective.
>> > >>>>> I created a massive change by running ./build.sh with  Java 11.
>> > >>>>> (Was it right or wrong to commit those changes is up to debate.)
>> > >>>>> To make ./build.sh work I needed to modify the script to remove the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
>> > >>>>> There is another thread for this also in the above link.
>> > >>>>> That option is not in Java versions after Java 8.
>> > >>>>> So I think the change to use encodings was a side effect of moving to Java 11.
>> > >>>>> What version of Java are you using?
>> > >>>>>
>> > >>>>> BTW. I committed the Java 11 changes to the trunk branch but not to the 2.4 branch.
>> > >>>>>
>> > >>>>> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano <to...@gmail.com> wrote:
>> > >>>>>> Hi everybody,
>> > >>>>>>
>> > >>>>>> apologies in advance for my question, I haven't followed completely
>> > >>>>>> all the past threads. I am trying to add some docs for mod_systemd,
>> > >>>>>> and while building the trunk's docs I keep getting a diff like:
>> > >>>>>>
>> > >>>>>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>> > >>>>>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>> > >>>>>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>> > >>>>>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
>> > >>>>>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>> > >>>>>> title="Espa�ol">&nbsp;es&nbsp;</a> |
>> > >>>>>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>> > >>>>>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>> > >>>>>>
>> > >>>>>> To build, I do the usual ./build.sh in docs/manual/build. I am aware
>> > >>>>>> that there are issues with char encodings from a quick glance on older
>> > >>>>>> threads, but I am wondering if there is a current best practice in how
>> > >>>>>> to build docs to avoid committing weird changes :)
>> > >>>>>>
>> > >>>>>> Thanks in advance,
>> > >>>>>>
>> > >>>>>> Luca
>> > >>>>>>
>> > >>>>>> ---------------------------------------------------------------------
>> > >>>>>> 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
>> > >>>
>> > >> ---------------------------------------------------------------------
>> > >> 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
>> > >
>> >
>> > ---------------------------------------------------------------------
>> > 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
>>

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


Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Mike Rumph <mr...@gmail.com>.
Hello all,

Like mentioned before to Eric, I apologize for committing the massive
changes resulting from switching to Java 11 without first discussing it on
docs (I just didn't understand the issues at that time).
One thing is fairly certain is that we wouldn't want to keep switching back
and forth between Java 8 and Java 11.
Which version does the buildbot use (probably Java 8).
I took the approach of just letting the buildbot generate the .html files
with my commit for 2.4 branch.
(Because I didn't want to do more damage until the issue is settled.)

One solution that is used by some of the files is to switch to utf8.
Notice that some of the files end in .html.<language> while others in
html.<language>.utf8.

Maybe there is also away to configure Java 11 to behave in a different way.



On Sun, Feb 9, 2020 at 7:13 AM Luca Toscano <to...@gmail.com> wrote:

> Hi Lucien,
>
> I am using java 8, not 11 :)
>
> What Christophe suggested seems right, namely that Mike R. committed
> with r1873229 new versions of files replacing UTF-8 chars with
> something different. For example, in my current case the following
> diff shows up after building:
>
> docs/manual/rewrite/flags.html.en
>
> -<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
> title="Fran&#231;ais">&nbsp;fr&nbsp;</a></p>
> +<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
> title="Fran�ais">&nbsp;fr&nbsp;</a></p>
>
> If you check r1873229 you'll see the following:
>
>
> http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/rewrite/flags.html.en?limit_changes=0&r1=1873229&r2=1873228&pathrev=1873229
>
> -<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
> title="Fran�ais">&nbsp;fr&nbsp;</a></p>
> +<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
> title="Fran&#231;ais">&nbsp;fr&nbsp;</a></p>
>
> So my build with Java 8 is basically reverting what Mike did after
> building with Java 11. Not sure now what is the best path, or if the
> is a workaround, this is why I asked in the last email what do we want
> to do. Maybe just using Java 11 and stick with it?
>
> Long term solution, in my opinion, is what Humbedooh suggested in
> #httpd-dev on Freenode, namely commit .xml files and let buildbot to
> automagically create html files (so we'll have only one way to build
> things, on one platform).
>
> Luca
>
> Il giorno dom 9 feb 2020 alle ore 15:04 Lucien Gentis
> <lu...@univ-lorraine.fr> ha scritto:
> >
> > Hi,
> >
> > I cannot reproduce these diff here.
> >
> > I also have java 11 ; java --version gives :
> >
> > openjdk 11.0.6 2020-01-14
> > OpenJDK Runtime Environment (build 11.0.6+10-post-Debian-1deb10u1)
> > OpenJDK 64-Bit Server VM (build 11.0.6+10-post-Debian-1deb10u1, mixed
> > mode, sharing)
> >
> > I have downloaded trunk repos in a clean working directory and launched
> > "build.sh on it,
> >
> > and docs/manual/new_features_2_4.html.en still contains :
> >
> > <p><span>Available Languages: </span><a
> > href="./en/new_features_2_4.html" title="English">&nbsp;en&nbsp;</a> |
> > <a href="./es/new_features_2_4.html" hreflang="es" rel="alternate"
> > title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
> >
> > where non ASCII characters are replaced by there html entities and
> > "Espa&#241;ol"> is not replaced by "Espa�ol">
> >
> > Did you modify some file in manual/style directory ?
> >
> > Le 08/02/2020 à 19:33, Luca Toscano a écrit :
> > > Hi Lucien,
> > >
> > > some of the files:
> > >
> > > docs/manual/rewrite/flags.html.en
> > > docs/manual/new_features_2_4.html.en
> > > docs/manual/mod/mod_systemd.html.en
> > >
> > > Il giorno sab 8 feb 2020 alle ore 18:29 Lucien Gentis
> > > <lu...@univ-lorraine.fr> ha scritto:
> > >> In what file do you get the diff :
> > >>
> > >> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> > >> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
> > >> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> > >> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
> > >> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> > >> title="Espa�ol">&nbsp;es&nbsp;</a> |
> > >> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> > >> title="Fran�ais">&nbsp;fr&nbsp;</a> |
> > >>
> > >> Le 08/02/2020 à 17:55, Luca Toscano a écrit :
> > >>> Hi Mike,
> > >>>
> > >>> thanks for following up. I noticed the thread but I am using java 8,
> > >>> and I haven't had any problems with it in the past, so I didn't try
> to
> > >>> remove the Xbootclasspath parameter. I just did now but the problem
> > >>> persists, so it must be something else :(
> > >>>
> > >>> Luca
> > >>>
> > >>> Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
> > >>> <mr...@gmail.com> ha scritto:
> > >>>> I should also mention that this difference does not appear in the
> .html.utf8 files.
> > >>>>
> > >>>> On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph <mr...@gmail.com>
> wrote:
> > >>>>> Hello Luca,
> > >>>>>
> > >>>>> See the previous thread related to commit r1873229:
> > >>>>> -
> http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
> > >>>>>
> > >>>>> I caused a problem or solved one depending on one's perspective.
> > >>>>> I created a massive change by running ./build.sh with  Java 11.
> > >>>>> (Was it right or wrong to commit those changes is up to debate.)
> > >>>>> To make ./build.sh work I needed to modify the script to remove
> the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
> > >>>>> There is another thread for this also in the above link.
> > >>>>> That option is not in Java versions after Java 8.
> > >>>>> So I think the change to use encodings was a side effect of moving
> to Java 11.
> > >>>>> What version of Java are you using?
> > >>>>>
> > >>>>> BTW. I committed the Java 11 changes to the trunk branch but not
> to the 2.4 branch.
> > >>>>>
> > >>>>> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano <
> toscano.luca@gmail.com> wrote:
> > >>>>>> Hi everybody,
> > >>>>>>
> > >>>>>> apologies in advance for my question, I haven't followed
> completely
> > >>>>>> all the past threads. I am trying to add some docs for
> mod_systemd,
> > >>>>>> and while building the trunk's docs I keep getting a diff like:
> > >>>>>>
> > >>>>>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> > >>>>>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
> > >>>>>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> > >>>>>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
> > >>>>>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> > >>>>>> title="Espa�ol">&nbsp;es&nbsp;</a> |
> > >>>>>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> > >>>>>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
> > >>>>>>
> > >>>>>> To build, I do the usual ./build.sh in docs/manual/build. I am
> aware
> > >>>>>> that there are issues with char encodings from a quick glance on
> older
> > >>>>>> threads, but I am wondering if there is a current best practice
> in how
> > >>>>>> to build docs to avoid committing weird changes :)
> > >>>>>>
> > >>>>>> Thanks in advance,
> > >>>>>>
> > >>>>>> Luca
> > >>>>>>
> > >>>>>>
> ---------------------------------------------------------------------
> > >>>>>> 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
> > >>>
> > >> ---------------------------------------------------------------------
> > >> 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
> > >
> >
> > ---------------------------------------------------------------------
> > 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
>
>

Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Luca Toscano <to...@gmail.com>.
Hi Lucien,

I am using java 8, not 11 :)

What Christophe suggested seems right, namely that Mike R. committed
with r1873229 new versions of files replacing UTF-8 chars with
something different. For example, in my current case the following
diff shows up after building:

docs/manual/rewrite/flags.html.en

-<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
title="Fran&#231;ais">&nbsp;fr&nbsp;</a></p>
+<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
title="Fran�ais">&nbsp;fr&nbsp;</a></p>

If you check r1873229 you'll see the following:

http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/rewrite/flags.html.en?limit_changes=0&r1=1873229&r2=1873228&pathrev=1873229

-<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
title="Fran�ais">&nbsp;fr&nbsp;</a></p>
+<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate"
title="Fran&#231;ais">&nbsp;fr&nbsp;</a></p>

So my build with Java 8 is basically reverting what Mike did after
building with Java 11. Not sure now what is the best path, or if the
is a workaround, this is why I asked in the last email what do we want
to do. Maybe just using Java 11 and stick with it?

Long term solution, in my opinion, is what Humbedooh suggested in
#httpd-dev on Freenode, namely commit .xml files and let buildbot to
automagically create html files (so we'll have only one way to build
things, on one platform).

Luca

Il giorno dom 9 feb 2020 alle ore 15:04 Lucien Gentis
<lu...@univ-lorraine.fr> ha scritto:
>
> Hi,
>
> I cannot reproduce these diff here.
>
> I also have java 11 ; java --version gives :
>
> openjdk 11.0.6 2020-01-14
> OpenJDK Runtime Environment (build 11.0.6+10-post-Debian-1deb10u1)
> OpenJDK 64-Bit Server VM (build 11.0.6+10-post-Debian-1deb10u1, mixed
> mode, sharing)
>
> I have downloaded trunk repos in a clean working directory and launched
> "build.sh on it,
>
> and docs/manual/new_features_2_4.html.en still contains :
>
> <p><span>Available Languages: </span><a
> href="./en/new_features_2_4.html" title="English">&nbsp;en&nbsp;</a> |
> <a href="./es/new_features_2_4.html" hreflang="es" rel="alternate"
> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>
> where non ASCII characters are replaced by there html entities and
> "Espa&#241;ol"> is not replaced by "Espa�ol">
>
> Did you modify some file in manual/style directory ?
>
> Le 08/02/2020 à 19:33, Luca Toscano a écrit :
> > Hi Lucien,
> >
> > some of the files:
> >
> > docs/manual/rewrite/flags.html.en
> > docs/manual/new_features_2_4.html.en
> > docs/manual/mod/mod_systemd.html.en
> >
> > Il giorno sab 8 feb 2020 alle ore 18:29 Lucien Gentis
> > <lu...@univ-lorraine.fr> ha scritto:
> >> In what file do you get the diff :
> >>
> >> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> >> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
> >> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> >> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
> >> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> >> title="Espa�ol">&nbsp;es&nbsp;</a> |
> >> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> >> title="Fran�ais">&nbsp;fr&nbsp;</a> |
> >>
> >> Le 08/02/2020 à 17:55, Luca Toscano a écrit :
> >>> Hi Mike,
> >>>
> >>> thanks for following up. I noticed the thread but I am using java 8,
> >>> and I haven't had any problems with it in the past, so I didn't try to
> >>> remove the Xbootclasspath parameter. I just did now but the problem
> >>> persists, so it must be something else :(
> >>>
> >>> Luca
> >>>
> >>> Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
> >>> <mr...@gmail.com> ha scritto:
> >>>> I should also mention that this difference does not appear in the .html.utf8 files.
> >>>>
> >>>> On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph <mr...@gmail.com> wrote:
> >>>>> Hello Luca,
> >>>>>
> >>>>> See the previous thread related to commit r1873229:
> >>>>> - http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
> >>>>>
> >>>>> I caused a problem or solved one depending on one's perspective.
> >>>>> I created a massive change by running ./build.sh with  Java 11.
> >>>>> (Was it right or wrong to commit those changes is up to debate.)
> >>>>> To make ./build.sh work I needed to modify the script to remove the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
> >>>>> There is another thread for this also in the above link.
> >>>>> That option is not in Java versions after Java 8.
> >>>>> So I think the change to use encodings was a side effect of moving to Java 11.
> >>>>> What version of Java are you using?
> >>>>>
> >>>>> BTW. I committed the Java 11 changes to the trunk branch but not to the 2.4 branch.
> >>>>>
> >>>>> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano <to...@gmail.com> wrote:
> >>>>>> Hi everybody,
> >>>>>>
> >>>>>> apologies in advance for my question, I haven't followed completely
> >>>>>> all the past threads. I am trying to add some docs for mod_systemd,
> >>>>>> and while building the trunk's docs I keep getting a diff like:
> >>>>>>
> >>>>>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> >>>>>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
> >>>>>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> >>>>>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
> >>>>>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> >>>>>> title="Espa�ol">&nbsp;es&nbsp;</a> |
> >>>>>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> >>>>>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
> >>>>>>
> >>>>>> To build, I do the usual ./build.sh in docs/manual/build. I am aware
> >>>>>> that there are issues with char encodings from a quick glance on older
> >>>>>> threads, but I am wondering if there is a current best practice in how
> >>>>>> to build docs to avoid committing weird changes :)
> >>>>>>
> >>>>>> Thanks in advance,
> >>>>>>
> >>>>>> Luca
> >>>>>>
> >>>>>> ---------------------------------------------------------------------
> >>>>>> 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
> >>>
> >> ---------------------------------------------------------------------
> >> 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
> >
>
> ---------------------------------------------------------------------
> 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


Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Lucien Gentis <lu...@univ-lorraine.fr>.
Hi,

I cannot reproduce these diff here.

I also have java 11 ; java --version gives :

openjdk 11.0.6 2020-01-14
OpenJDK Runtime Environment (build 11.0.6+10-post-Debian-1deb10u1)
OpenJDK 64-Bit Server VM (build 11.0.6+10-post-Debian-1deb10u1, mixed 
mode, sharing)

I have downloaded trunk repos in a clean working directory and launched 
"build.sh on it,

and docs/manual/new_features_2_4.html.en still contains :

<p><span>Available Languages: </span><a 
href="./en/new_features_2_4.html" title="English">&nbsp;en&nbsp;</a> |
<a href="./es/new_features_2_4.html" hreflang="es" rel="alternate" 
title="Espa&#241;ol">&nbsp;es&nbsp;</a> |

where non ASCII characters are replaced by there html entities and 
"Espa&#241;ol"> is not replaced by "Espa�ol">

Did you modify some file in manual/style directory ?

Le 08/02/2020 à 19:33, Luca Toscano a écrit :
> Hi Lucien,
>
> some of the files:
>
> docs/manual/rewrite/flags.html.en
> docs/manual/new_features_2_4.html.en
> docs/manual/mod/mod_systemd.html.en
>
> Il giorno sab 8 feb 2020 alle ore 18:29 Lucien Gentis
> <lu...@univ-lorraine.fr> ha scritto:
>> In what file do you get the diff :
>>
>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>> title="Espa�ol">&nbsp;es&nbsp;</a> |
>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>>
>> Le 08/02/2020 à 17:55, Luca Toscano a écrit :
>>> Hi Mike,
>>>
>>> thanks for following up. I noticed the thread but I am using java 8,
>>> and I haven't had any problems with it in the past, so I didn't try to
>>> remove the Xbootclasspath parameter. I just did now but the problem
>>> persists, so it must be something else :(
>>>
>>> Luca
>>>
>>> Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
>>> <mr...@gmail.com> ha scritto:
>>>> I should also mention that this difference does not appear in the .html.utf8 files.
>>>>
>>>> On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph <mr...@gmail.com> wrote:
>>>>> Hello Luca,
>>>>>
>>>>> See the previous thread related to commit r1873229:
>>>>> - http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
>>>>>
>>>>> I caused a problem or solved one depending on one's perspective.
>>>>> I created a massive change by running ./build.sh with  Java 11.
>>>>> (Was it right or wrong to commit those changes is up to debate.)
>>>>> To make ./build.sh work I needed to modify the script to remove the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
>>>>> There is another thread for this also in the above link.
>>>>> That option is not in Java versions after Java 8.
>>>>> So I think the change to use encodings was a side effect of moving to Java 11.
>>>>> What version of Java are you using?
>>>>>
>>>>> BTW. I committed the Java 11 changes to the trunk branch but not to the 2.4 branch.
>>>>>
>>>>> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano <to...@gmail.com> wrote:
>>>>>> Hi everybody,
>>>>>>
>>>>>> apologies in advance for my question, I haven't followed completely
>>>>>> all the past threads. I am trying to add some docs for mod_systemd,
>>>>>> and while building the trunk's docs I keep getting a diff like:
>>>>>>
>>>>>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>>>>>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>>>>>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>>>>>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
>>>>>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>>>>>> title="Espa�ol">&nbsp;es&nbsp;</a> |
>>>>>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>>>>>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>>>>>>
>>>>>> To build, I do the usual ./build.sh in docs/manual/build. I am aware
>>>>>> that there are issues with char encodings from a quick glance on older
>>>>>> threads, but I am wondering if there is a current best practice in how
>>>>>> to build docs to avoid committing weird changes :)
>>>>>>
>>>>>> Thanks in advance,
>>>>>>
>>>>>> Luca
>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>>>> 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
>>>
>> ---------------------------------------------------------------------
>> 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
>

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


Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Luca Toscano <to...@gmail.com>.
Hi Lucien,

some of the files:

docs/manual/rewrite/flags.html.en
docs/manual/new_features_2_4.html.en
docs/manual/mod/mod_systemd.html.en

Il giorno sab 8 feb 2020 alle ore 18:29 Lucien Gentis
<lu...@univ-lorraine.fr> ha scritto:
>
> In what file do you get the diff :
>
> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> title="Espa�ol">&nbsp;es&nbsp;</a> |
> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>
> Le 08/02/2020 à 17:55, Luca Toscano a écrit :
> > Hi Mike,
> >
> > thanks for following up. I noticed the thread but I am using java 8,
> > and I haven't had any problems with it in the past, so I didn't try to
> > remove the Xbootclasspath parameter. I just did now but the problem
> > persists, so it must be something else :(
> >
> > Luca
> >
> > Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
> > <mr...@gmail.com> ha scritto:
> >> I should also mention that this difference does not appear in the .html.utf8 files.
> >>
> >> On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph <mr...@gmail.com> wrote:
> >>> Hello Luca,
> >>>
> >>> See the previous thread related to commit r1873229:
> >>> - http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
> >>>
> >>> I caused a problem or solved one depending on one's perspective.
> >>> I created a massive change by running ./build.sh with  Java 11.
> >>> (Was it right or wrong to commit those changes is up to debate.)
> >>> To make ./build.sh work I needed to modify the script to remove the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
> >>> There is another thread for this also in the above link.
> >>> That option is not in Java versions after Java 8.
> >>> So I think the change to use encodings was a side effect of moving to Java 11.
> >>> What version of Java are you using?
> >>>
> >>> BTW. I committed the Java 11 changes to the trunk branch but not to the 2.4 branch.
> >>>
> >>> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano <to...@gmail.com> wrote:
> >>>> Hi everybody,
> >>>>
> >>>> apologies in advance for my question, I haven't followed completely
> >>>> all the past threads. I am trying to add some docs for mod_systemd,
> >>>> and while building the trunk's docs I keep getting a diff like:
> >>>>
> >>>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> >>>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
> >>>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> >>>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
> >>>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> >>>> title="Espa�ol">&nbsp;es&nbsp;</a> |
> >>>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> >>>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
> >>>>
> >>>> To build, I do the usual ./build.sh in docs/manual/build. I am aware
> >>>> that there are issues with char encodings from a quick glance on older
> >>>> threads, but I am wondering if there is a current best practice in how
> >>>> to build docs to avoid committing weird changes :)
> >>>>
> >>>> Thanks in advance,
> >>>>
> >>>> Luca
> >>>>
> >>>> ---------------------------------------------------------------------
> >>>> 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
> >
>
> ---------------------------------------------------------------------
> 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


Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Lucien Gentis <lu...@univ-lorraine.fr>.
In what file do you get the diff :

-<a href="./es/sitemap.html" hreflang="es" rel="alternate"
title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
-<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
+<a href="./es/sitemap.html" hreflang="es" rel="alternate"
title="Espa�ol">&nbsp;es&nbsp;</a> |
+<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
title="Fran�ais">&nbsp;fr&nbsp;</a> |

Le 08/02/2020 à 17:55, Luca Toscano a écrit :
> Hi Mike,
>
> thanks for following up. I noticed the thread but I am using java 8,
> and I haven't had any problems with it in the past, so I didn't try to
> remove the Xbootclasspath parameter. I just did now but the problem
> persists, so it must be something else :(
>
> Luca
>
> Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
> <mr...@gmail.com> ha scritto:
>> I should also mention that this difference does not appear in the .html.utf8 files.
>>
>> On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph <mr...@gmail.com> wrote:
>>> Hello Luca,
>>>
>>> See the previous thread related to commit r1873229:
>>> - http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
>>>
>>> I caused a problem or solved one depending on one's perspective.
>>> I created a massive change by running ./build.sh with  Java 11.
>>> (Was it right or wrong to commit those changes is up to debate.)
>>> To make ./build.sh work I needed to modify the script to remove the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
>>> There is another thread for this also in the above link.
>>> That option is not in Java versions after Java 8.
>>> So I think the change to use encodings was a side effect of moving to Java 11.
>>> What version of Java are you using?
>>>
>>> BTW. I committed the Java 11 changes to the trunk branch but not to the 2.4 branch.
>>>
>>> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano <to...@gmail.com> wrote:
>>>> Hi everybody,
>>>>
>>>> apologies in advance for my question, I haven't followed completely
>>>> all the past threads. I am trying to add some docs for mod_systemd,
>>>> and while building the trunk's docs I keep getting a diff like:
>>>>
>>>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>>>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>>>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>>>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
>>>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>>>> title="Espa�ol">&nbsp;es&nbsp;</a> |
>>>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>>>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>>>>
>>>> To build, I do the usual ./build.sh in docs/manual/build. I am aware
>>>> that there are issues with char encodings from a quick glance on older
>>>> threads, but I am wondering if there is a current best practice in how
>>>> to build docs to avoid committing weird changes :)
>>>>
>>>> Thanks in advance,
>>>>
>>>> Luca
>>>>
>>>> ---------------------------------------------------------------------
>>>> 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
>

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


Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Luca Toscano <to...@gmail.com>.
Thanks! What should be the best course of action then? Should I just
commit my version to trunk (generated with java8) or should we proceed
in a different way?

Luca

Il giorno dom 9 feb 2020 alle ore 09:46 Marion & Christophe JAILLET
<ch...@wanadoo.fr> ha scritto:
>
> You see some differences on trunk only because Mike R has committed
> files generated with Java 11 on trunk.
> I guess that the last one who committed generated files on 2.4 was using
> an Java 8 or older version.
>
>
> CJ
>
> Le 08/02/2020 à 18:28, Luca Toscano a écrit :
> > Wasn't able to repro in 2.4.x (docs build repo up to date to last
> > version, same environment), in fact I just committed
> > http://svn.apache.org/r1873802. Very strange.. If anybody has
> > suggestions, I am all ears! I'll keep testing :)
> >
> > Luca
> >
> > Il giorno sab 8 feb 2020 alle ore 17:55 Luca Toscano
> > <to...@gmail.com>  ha scritto:
> >> Hi Mike,
> >>
> >> thanks for following up. I noticed the thread but I am using java 8,
> >> and I haven't had any problems with it in the past, so I didn't try to
> >> remove the Xbootclasspath parameter. I just did now but the problem
> >> persists, so it must be something else :(
> >>
> >> Luca
> >>
> >> Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
> >> <mr...@gmail.com>  ha scritto:
> >>> I should also mention that this difference does not appear in the .html.utf8 files.
> >>>
> >>> On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph<mr...@gmail.com>  wrote:
> >>>> Hello Luca,
> >>>>
> >>>> See the previous thread related to commit r1873229:
> >>>> -http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
> >>>>
> >>>> I caused a problem or solved one depending on one's perspective.
> >>>> I created a massive change by running ./build.sh with  Java 11.
> >>>> (Was it right or wrong to commit those changes is up to debate.)
> >>>> To make ./build.sh work I needed to modify the script to remove the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
> >>>> There is another thread for this also in the above link.
> >>>> That option is not in Java versions after Java 8.
> >>>> So I think the change to use encodings was a side effect of moving to Java 11.
> >>>> What version of Java are you using?
> >>>>
> >>>> BTW. I committed the Java 11 changes to the trunk branch but not to the 2.4 branch.
> >>>>
> >>>> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano<to...@gmail.com>  wrote:
> >>>>> Hi everybody,
> >>>>>
> >>>>> apologies in advance for my question, I haven't followed completely
> >>>>> all the past threads. I am trying to add some docs for mod_systemd,
> >>>>> and while building the trunk's docs I keep getting a diff like:
> >>>>>
> >>>>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> >>>>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
> >>>>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> >>>>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
> >>>>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> >>>>> title="Espa�ol">&nbsp;es&nbsp;</a> |
> >>>>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> >>>>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
> >>>>>
> >>>>> To build, I do the usual ./build.sh in docs/manual/build. I am aware
> >>>>> that there are issues with char encodings from a quick glance on older
> >>>>> threads, but I am wondering if there is a current best practice in how
> >>>>> to build docs to avoid committing weird changes :)
> >>>>>
> >>>>> Thanks in advance,
> >>>>>
> >>>>> Luca
> >>>>>
> >>>>> ---------------------------------------------------------------------
> >>>>> 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
> >
>
> ---------------------------------------------------------------------
> 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


Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Marion & Christophe JAILLET <ch...@wanadoo.fr>.
You see some differences on trunk only because Mike R has committed 
files generated with Java 11 on trunk.
I guess that the last one who committed generated files on 2.4 was using 
an Java 8 or older version.


CJ

Le 08/02/2020 à 18:28, Luca Toscano a écrit :
> Wasn't able to repro in 2.4.x (docs build repo up to date to last
> version, same environment), in fact I just committed
> http://svn.apache.org/r1873802. Very strange.. If anybody has
> suggestions, I am all ears! I'll keep testing :)
>
> Luca
>
> Il giorno sab 8 feb 2020 alle ore 17:55 Luca Toscano
> <to...@gmail.com>  ha scritto:
>> Hi Mike,
>>
>> thanks for following up. I noticed the thread but I am using java 8,
>> and I haven't had any problems with it in the past, so I didn't try to
>> remove the Xbootclasspath parameter. I just did now but the problem
>> persists, so it must be something else :(
>>
>> Luca
>>
>> Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
>> <mr...@gmail.com>  ha scritto:
>>> I should also mention that this difference does not appear in the .html.utf8 files.
>>>
>>> On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph<mr...@gmail.com>  wrote:
>>>> Hello Luca,
>>>>
>>>> See the previous thread related to commit r1873229:
>>>> -http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
>>>>
>>>> I caused a problem or solved one depending on one's perspective.
>>>> I created a massive change by running ./build.sh with  Java 11.
>>>> (Was it right or wrong to commit those changes is up to debate.)
>>>> To make ./build.sh work I needed to modify the script to remove the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
>>>> There is another thread for this also in the above link.
>>>> That option is not in Java versions after Java 8.
>>>> So I think the change to use encodings was a side effect of moving to Java 11.
>>>> What version of Java are you using?
>>>>
>>>> BTW. I committed the Java 11 changes to the trunk branch but not to the 2.4 branch.
>>>>
>>>> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano<to...@gmail.com>  wrote:
>>>>> Hi everybody,
>>>>>
>>>>> apologies in advance for my question, I haven't followed completely
>>>>> all the past threads. I am trying to add some docs for mod_systemd,
>>>>> and while building the trunk's docs I keep getting a diff like:
>>>>>
>>>>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>>>>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>>>>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>>>>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
>>>>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>>>>> title="Espa�ol">&nbsp;es&nbsp;</a> |
>>>>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>>>>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>>>>>
>>>>> To build, I do the usual ./build.sh in docs/manual/build. I am aware
>>>>> that there are issues with char encodings from a quick glance on older
>>>>> threads, but I am wondering if there is a current best practice in how
>>>>> to build docs to avoid committing weird changes :)
>>>>>
>>>>> Thanks in advance,
>>>>>
>>>>> Luca
>>>>>
>>>>> ---------------------------------------------------------------------
>>>>> 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
>

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


Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Luca Toscano <to...@gmail.com>.
Wasn't able to repro in 2.4.x (docs build repo up to date to last
version, same environment), in fact I just committed
http://svn.apache.org/r1873802. Very strange.. If anybody has
suggestions, I am all ears! I'll keep testing :)

Luca

Il giorno sab 8 feb 2020 alle ore 17:55 Luca Toscano
<to...@gmail.com> ha scritto:
>
> Hi Mike,
>
> thanks for following up. I noticed the thread but I am using java 8,
> and I haven't had any problems with it in the past, so I didn't try to
> remove the Xbootclasspath parameter. I just did now but the problem
> persists, so it must be something else :(
>
> Luca
>
> Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
> <mr...@gmail.com> ha scritto:
> >
> > I should also mention that this difference does not appear in the .html.utf8 files.
> >
> > On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph <mr...@gmail.com> wrote:
> >>
> >> Hello Luca,
> >>
> >> See the previous thread related to commit r1873229:
> >> - http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
> >>
> >> I caused a problem or solved one depending on one's perspective.
> >> I created a massive change by running ./build.sh with  Java 11.
> >> (Was it right or wrong to commit those changes is up to debate.)
> >> To make ./build.sh work I needed to modify the script to remove the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
> >> There is another thread for this also in the above link.
> >> That option is not in Java versions after Java 8.
> >> So I think the change to use encodings was a side effect of moving to Java 11.
> >> What version of Java are you using?
> >>
> >> BTW. I committed the Java 11 changes to the trunk branch but not to the 2.4 branch.
> >>
> >> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano <to...@gmail.com> wrote:
> >>>
> >>> Hi everybody,
> >>>
> >>> apologies in advance for my question, I haven't followed completely
> >>> all the past threads. I am trying to add some docs for mod_systemd,
> >>> and while building the trunk's docs I keep getting a diff like:
> >>>
> >>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> >>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
> >>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> >>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
> >>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> >>> title="Espa�ol">&nbsp;es&nbsp;</a> |
> >>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> >>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
> >>>
> >>> To build, I do the usual ./build.sh in docs/manual/build. I am aware
> >>> that there are issues with char encodings from a quick glance on older
> >>> threads, but I am wondering if there is a current best practice in how
> >>> to build docs to avoid committing weird changes :)
> >>>
> >>> Thanks in advance,
> >>>
> >>> Luca
> >>>
> >>> ---------------------------------------------------------------------
> >>> 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


Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Luca Toscano <to...@gmail.com>.
Hi Mike,

thanks for following up. I noticed the thread but I am using java 8,
and I haven't had any problems with it in the past, so I didn't try to
remove the Xbootclasspath parameter. I just did now but the problem
persists, so it must be something else :(

Luca

Il giorno sab 8 feb 2020 alle ore 17:10 Mike Rumph
<mr...@gmail.com> ha scritto:
>
> I should also mention that this difference does not appear in the .html.utf8 files.
>
> On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph <mr...@gmail.com> wrote:
>>
>> Hello Luca,
>>
>> See the previous thread related to commit r1873229:
>> - http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
>>
>> I caused a problem or solved one depending on one's perspective.
>> I created a massive change by running ./build.sh with  Java 11.
>> (Was it right or wrong to commit those changes is up to debate.)
>> To make ./build.sh work I needed to modify the script to remove the -Xbootclasspath/p:"$LOCALCLASSPATH" option.
>> There is another thread for this also in the above link.
>> That option is not in Java versions after Java 8.
>> So I think the change to use encodings was a side effect of moving to Java 11.
>> What version of Java are you using?
>>
>> BTW. I committed the Java 11 changes to the trunk branch but not to the 2.4 branch.
>>
>> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano <to...@gmail.com> wrote:
>>>
>>> Hi everybody,
>>>
>>> apologies in advance for my question, I haven't followed completely
>>> all the past threads. I am trying to add some docs for mod_systemd,
>>> and while building the trunk's docs I keep getting a diff like:
>>>
>>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
>>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>>> title="Espa�ol">&nbsp;es&nbsp;</a> |
>>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>>>
>>> To build, I do the usual ./build.sh in docs/manual/build. I am aware
>>> that there are issues with char encodings from a quick glance on older
>>> threads, but I am wondering if there is a current best practice in how
>>> to build docs to avoid committing weird changes :)
>>>
>>> Thanks in advance,
>>>
>>> Luca
>>>
>>> ---------------------------------------------------------------------
>>> 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


Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Mike Rumph <mr...@gmail.com>.
I should also mention that this difference does not appear in the
.html.utf8 files.

On Sat, Feb 8, 2020 at 7:59 AM Mike Rumph <mr...@gmail.com> wrote:

> Hello Luca,
>
> See the previous thread related to commit r1873229:
> - http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser
>
> I caused a problem or solved one depending on one's perspective.
> I created a massive change by running ./build.sh with  Java 11.
> (Was it right or wrong to commit those changes is up to debate.)
> To make ./build.sh work I needed to modify the script to remove the -Xbootclasspath/p:"$LOCALCLASSPATH"
> option.
> There is another thread for this also in the above link.
> That option is not in Java versions after Java 8.
> So I think the change to use encodings was a side effect of moving to Java
> 11.
> What version of Java are you using?
>
> BTW. I committed the Java 11 changes to the trunk branch but not to the
> 2.4 branch.
>
> On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano <to...@gmail.com>
> wrote:
>
>> Hi everybody,
>>
>> apologies in advance for my question, I haven't followed completely
>> all the past threads. I am trying to add some docs for mod_systemd,
>> and while building the trunk's docs I keep getting a diff like:
>>
>> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
>> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
>> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
>> title="Espa�ol">&nbsp;es&nbsp;</a> |
>> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
>> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>>
>> To build, I do the usual ./build.sh in docs/manual/build. I am aware
>> that there are issues with char encodings from a quick glance on older
>> threads, but I am wondering if there is a current best practice in how
>> to build docs to avoid committing weird changes :)
>>
>> Thanks in advance,
>>
>> Luca
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
>> For additional commands, e-mail: docs-help@httpd.apache.org
>>
>>

Re: Building docs for trunk and 2.4.x without changing char encoding

Posted by Mike Rumph <mr...@gmail.com>.
Hello Luca,

See the previous thread related to commit r1873229:
- http://mail-archives.apache.org/mod_mbox/httpd-docs/202001.mbox/browser

I caused a problem or solved one depending on one's perspective.
I created a massive change by running ./build.sh with  Java 11.
(Was it right or wrong to commit those changes is up to debate.)
To make ./build.sh work I needed to modify the script to remove the
-Xbootclasspath/p:"$LOCALCLASSPATH"
option.
There is another thread for this also in the above link.
That option is not in Java versions after Java 8.
So I think the change to use encodings was a side effect of moving to Java
11.
What version of Java are you using?

BTW. I committed the Java 11 changes to the trunk branch but not to the 2.4
branch.

On Sat, Feb 8, 2020 at 2:20 AM Luca Toscano <to...@gmail.com> wrote:

> Hi everybody,
>
> apologies in advance for my question, I haven't followed completely
> all the past threads. I am trying to add some docs for mod_systemd,
> and while building the trunk's docs I keep getting a diff like:
>
> -<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
> -<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> title="Fran&#231;ais">&nbsp;fr&nbsp;</a> |
> +<a href="./es/sitemap.html" hreflang="es" rel="alternate"
> title="Espa�ol">&nbsp;es&nbsp;</a> |
> +<a href="./fr/sitemap.html" hreflang="fr" rel="alternate"
> title="Fran�ais">&nbsp;fr&nbsp;</a> |
>
> To build, I do the usual ./build.sh in docs/manual/build. I am aware
> that there are issues with char encodings from a quick glance on older
> threads, but I am wondering if there is a current best practice in how
> to build docs to avoid committing weird changes :)
>
> Thanks in advance,
>
> Luca
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
>
>