Re: xhtml errors

Rich Bowen <[email protected]> Sun, 31 May 2026 11:30:19 -0400
Newsgroups gmane.comp.apache.documentation
Message-ID <CAD6Vrev4TYxYyEER2bvtg6YUcfj31U0xGw1KpNA_bN_P-+A=2A@mail.gmail.com>
--0000000000001b17fe06531ec2ef
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Along the way I learned that when you tweak the base xsl you have to run
'build.sh bootstrap' to recreate the language-specific files. In 20 years I
have never had to do that. Apparently we were still running the original
stuff that Joshua Slive lovingly hand crafted in 2003 or thereabouts when
we switched from writing raw html.

So cheers to Joshua, wherever you are!



Rich

On Sun, May 31, 2026, 11:25 Lucien Gentis <[email protected]>
wrote:

> Le 31/05/2026 =C3=A0 13:48, Rich Bowen a =C3=A9crit :
>
>
> On Sat, May 30, 2026, 18:33 Rich Bowen <[email protected]> wrote:
>
>> I=E2=80=99ve gone ahead and patched trunk, but note that this means I=E2=
=80=99ve also
>> patched the build/ repo, so I need to go ahead and patch 2.4 pretty soon=
,
>> or things will be kinda broken in the meanwhile.
>>
>
>
> https://validator.w3.org/nu/?doc=3Dhttps%3A%2F%2Fhttpd.apache.org%2Fdocs%=
2Ftrunk%2Fbind.html
>
>
> We're down to one warning and one error, and neither one of them
> particularly concern me.  I'll push this over to 2.4 today or tomorrow.
>
> Note that there's related problems with the httpd-site repo but since tha=
t
> site is generated completely differently I haven't looked at that yet. I
> expect it's related but that the fix will be different.
>
> I tested trunk :
>
> =3D=3D=3D TESTING =3D=3D=3D
>
> 1. Apply patch, rebuild one language: ./build.sh en
> ./build.sh validate-xml : OK
> ./build.sh fr : OK
> ./build.sh validate-xhtml : OK
>
> 2. Inspect generated .html =E2=80=94 verify DOCTYPE is HTML5
> First two lines of bind.html.fr.utf8 :
> <!DOCTYPE html SYSTEM "about:legacy-compat">
> <html lang=3D"fr"><head><META http-equiv=3D"Content-Type" content=3D"text=
/html; charset=3DUTF-8">
>
> 3. Run: java -jar vnu.jar --skip-non-html ../bind.html.en.utf8
> Ran directly ./build.sh validate-xhtml : OK
>
> 4. Confirm void elements are not self-closed (<br> not <br/>)
> No <br/> found in manual directory
>
> 5. Spot-check pages render identically in browser
> I committed bind.html.fr.utf8, didn=E2=80=99t see any rendering problem.
>
>
> All things seem to be OK
>
> Great job Rich !
>

--0000000000001b17fe06531ec2ef
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"auto"><div>Along the way I learned that when you tweak the base=
 xsl you have to run &#39;build.sh bootstrap&#39; to recreate the language-=
specific files. In 20 years I have never had to do that. Apparently we were=
 still running the original stuff that Joshua Slive lovingly hand crafted i=
n 2003 or thereabouts when we switched from writing raw html.</div><div dir=
=3D"auto"><br></div><div dir=3D"auto">So cheers to Joshua, wherever you are=
!</div><div dir=3D"auto"><br></div><div dir=3D"auto"><br></div><div><br></d=
iv><div data-smartmail=3D"gmail_signature">Rich</div></div><br><div class=
=3D"gmail_quote gmail_quote_container"><div dir=3D"ltr" class=3D"gmail_attr=
">On Sun, May 31, 2026, 11:25 Lucien Gentis &lt;<a href=3D"mailto:lucien.ge=
[email protected]">[email protected]</a>&gt; wrote:<br></d=
iv><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left=
:1px #ccc solid;padding-left:1ex"><u></u>

 =20
   =20
 =20
  <div>
    <div>Le 31/05/2026 =C3=A0 13:48, Rich Bowen a
      =C3=A9crit=C2=A0:<br>
    </div>
    <blockquote type=3D"cite">
     =20
      <div dir=3D"auto">
        <div dir=3D"auto"><br>
        </div>
        <div class=3D"gmail_quote" dir=3D"auto">
          <div dir=3D"ltr" class=3D"gmail_attr">On Sat, May 30, 2026, 18:33
            Rich Bowen &lt;<a href=3D"mailto:[email protected]" target=3D"=
_blank" rel=3D"noreferrer">[email protected]</a>&gt;
            wrote:<br>
          </div>
          <blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;bord=
er-left:1px #ccc solid;padding-left:1ex">I=E2=80=99ve
            gone ahead and patched trunk, but note that this means I=E2=80=
=99ve
            also patched the build/ repo, so I need to go ahead and
            patch 2.4 pretty soon, or things will be kinda broken in the
            meanwhile.<br>
          </blockquote>
        </div>
        <div dir=3D"auto"><br>
        </div>
        <div dir=3D"auto"><a href=3D"https://validator.w3.org/nu/?doc=3Dhtt=
ps%3A%2F%2Fhttpd.apache.org%2Fdocs%2Ftrunk%2Fbind.html" target=3D"_blank" r=
el=3D"noreferrer">https://validator.w3.org/nu/?doc=3Dhttps%3A%2F%2Fhttpd.ap=
ache.org%2Fdocs%2Ftrunk%2Fbind.html</a></div>
        <div dir=3D"auto"><br>
        </div>
        <div dir=3D"auto"><br>
        </div>
        <div dir=3D"auto">We&#39;re down to one warning and one error, and
          neither one of them particularly concern me.=C2=A0 I&#39;ll push =
this
          over to 2.4 today or tomorrow.=C2=A0</div>
        <div dir=3D"auto"><br>
        </div>
        <div dir=3D"auto">Note that there&#39;s related problems with the
          httpd-site repo but since that site is generated completely
          differently I haven&#39;t looked at that yet. I expect it&#39;s
          related but that the fix will be different.</div>
        <div dir=3D"auto"><br>
        </div>
        <div class=3D"gmail_quote" dir=3D"auto">
          <blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;bord=
er-left:1px #ccc solid;padding-left:1ex">
          </blockquote>
        </div>
      </div>
    </blockquote>
    <p>I tested trunk :</p>
    <pre>=3D=3D=3D TESTING =3D=3D=3D

1. Apply patch, rebuild one language: ./build.sh en
./build.sh validate-xml : OK
./build.sh fr : OK
./build.sh validate-xhtml : OK

2. Inspect generated .html =E2=80=94 verify DOCTYPE is HTML5
First two lines of bind.html.fr.utf8 :
&lt;!DOCTYPE html SYSTEM <a rel=3D"noreferrer">&quot;about:legacy-compat&qu=
ot;</a>&gt;
&lt;html lang=3D&quot;fr&quot;&gt;&lt;head&gt;&lt;META http-equiv=3D&quot;C=
ontent-Type&quot; content=3D&quot;text/html; charset=3DUTF-8&quot;&gt;

3. Run: java -jar vnu.jar --skip-non-html ../bind.html.en.utf8
Ran directly ./build.sh validate-xhtml : OK

4. Confirm void elements are not self-closed (&lt;br&gt; not &lt;br/&gt;)
No &lt;br/&gt; found in manual directory

5. Spot-check pages render identically in browser
I committed bind.html.fr.utf8, didn=E2=80=99t see any rendering problem.

</pre>
    <p>All things seem to be OK</p>
    <p>Great job Rich !</p>
  </div>

</blockquote></div>

--0000000000001b17fe06531ec2ef--