Technical issues with the HTML documentation
"'Hibou57' via wx-users" <[email protected]> Sat, 18 Jul 2026 14:32:49 -0700 (PDT)
| Newsgroups | gmane.comp.lib.wxwindows.general |
|---|---|
| Message-ID | <[email protected]> |
------=_Part_508868_1174850382.1784410369221
Content-Type: multipart/alternative;
boundary="----=_Part_508869_364938032.1784410369221"
------=_Part_508869_364938032.1784410369221
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Prior note: wanted to submit it as an issue on GitHub, but the relevant=20
topic was not in the proposed options. Posted on the user forum and I was=
=20
told it is not the place for that. So trying here, the last option.
Copy-paste of what was posted on the forum=20
( https://forums.wxwidgets.org/viewtopic.php?t=3D52656 ):
Was parsing the documentation for some purpose. It was fine so far (not=20
finished) with documentation for version 3.2.11. Then I noticed there is a=
=20
newer and better looking documentation version, 3.3.3 with some changes,=20
like some #define changed into constexpr. So wanted to update with this.=20
But doing so, was immediately blocked by an error.=20
Parsing starts with files.html.
At (685, 1) there is a body close tag, but that's a div close tag which is=
=20
expected, a div opened at (23, 1). At (684, 1) there is a div close tag. A=
=20
comment says if close a div with page_container ID. But it does not, it is=
=20
closing a div opened at (58, 1) and this is div#doc-content. The=20
div#page_container is opened at (23, 1).
At the end of the file, is this:
<!--EXTRA FOOTER SCRIPT-->=20
</div> <!-- #page_container -->
</body>
</html>
It should be:
<!--EXTRA FOOTER SCRIPT-->=20
</div>=20
</div> <!-- #page_container -->=20
</body>=20
</html>
Checked it is fine with this and the comment is still relevant. Don=E2=80=
=99t known=20
anything about Doxygen templates and document generation, so can=E2=80=99t =
tell=20
more, except at the time div#page_container is closed, div#doc-content is=
=20
not yet closed, and that's the error.
There are multiple occurrences of the same, because after the errors in=20
files.html was fixed, the same error still happens in other files.
Another markup error, at least in documentation version 3.2.11 (not=20
checking 3.3.3 for now, due to previous errors).
In the file for the wxAuiDefaultTabArt class,=20
classwx_aui_default_tab_art.html. At (93, 107) there is a closing P tag and=
=20
at (97, 1) there is an opening P tag. This should be reversed. Turn the=20
first into an open tag and the second into a close tag, and it=E2=80=99s fi=
ne.
The same with the file classwx_aui_simple_tab_art.html
Something else not markup related. In=20
https://docs.wxwidgets.org/latest/classwx_aui_tab_art.html#a1ec38b831d76261=
146f8e2f28e57f7b7=20
, for the class wxAuiTabArt the first argument of the method=20
GetBestTabCtrlSize just have a type (wxWindow *) and no name. Seems the=20
name should be wnd, according to the others places where the same argument=
=20
type appears.
I don=E2=80=99t know C++ (knew it a so much long time ago it was not the sa=
me), but=20
I am rather sure an argument is useless without a name, whatever the=20
language. I still may be wrong=E2=80=AF=E2=80=A6
Searching for =E2=80=9Cconst wxAuiNotebookPageArray &=E2=80=9D and =E2=80=
=9Cconst wxSize &=E2=80=9D in the=20
same page, shows other place with the same issue (unless it is not an=20
issue).
--=20
Please read https://www.wxwidgets.org/support/mlhowto.htm before posting.
---=20
You received this message because you are subscribed to the Google Groups "=
wx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an e=
mail to [email protected].
To view this discussion visit https://groups.google.com/d/msgid/wx-users/14=
7cb519-8a0d-46d4-9228-fe4ff0e979ecn%40googlegroups.com.
------=_Part_508869_364938032.1784410369221
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
<div>Prior note: wanted to submit it as an issue on GitHub, but the relevan=
t topic was not in the proposed options. Posted on the user forum and I was=
told it is not the place for that. So trying here, the last option.</div><=
div><br /></div><div>Copy-paste of what was posted on the forum (=C2=A0http=
s://forums.wxwidgets.org/viewtopic.php?t=3D52656=C2=A0):</div><div><br /></=
div><div>Was parsing the documentation for some purpose. It was fine so far=
(not finished) with=20
documentation for version 3.2.11. Then I noticed there is a newer and=20
better looking documentation version, 3.3.3 with some changes, like some
#define changed into constexpr. So wanted to update with this. But=20
doing so, was immediately blocked by an error. <br />
<br />
Parsing starts with files.html.<br />
<br />
At (685, 1) there is a body close tag, but that's a div close tag which=20
is expected, a div opened at (23, 1). At (684, 1) there is a div close=20
tag. A comment says if close a div with page_container ID. But it does=20
not, it is closing a div opened at (58, 1) and this is div#doc-content.=20
The div#page_container is opened at (23, 1).<br />
<br />
At the end of the file, is this:</div><div><br /></div><div><span><span>=C2=
=A0 =C2=A0 <!--EXTRA FOOTER SCRIPT-->=C2=A0</span></span></div><div><=
span><span>=C2=A0 =C2=A0 </div> <!-- #page_container --></span>=
</span></div><div><span><span>=C2=A0 =C2=A0 </body></span></span></di=
v><div><span><span>=C2=A0 =C2=A0 </html></span></span></div><div><spa=
n><span><br /></span></span></div><div>It should be:</div><div><br /></div>=
<div><span><span>=C2=A0 =C2=A0 <!--EXTRA FOOTER SCRIPT-->=C2=A0</span=
></span></div><div><span><span>=C2=A0 =C2=A0 </div>=C2=A0</span></spa=
n></div><div><span><span>=C2=A0 =C2=A0 </div> <!-- #page_container=
-->=C2=A0</span></span></div><div><span><span>=C2=A0 =C2=A0 </body&g=
t;=C2=A0</span></span></div><div><span><span>=C2=A0 =C2=A0 </html></s=
pan></span></div><div><span><span><br /></span></span></div><div>Checked it=
is fine with this and the comment is still relevant. Don=E2=80=99t=20
known anything about Doxygen templates and document generation, so=20
can=E2=80=99t tell more, except at the time div#page_container is closed,=
=20
div#doc-content is not yet closed, and that's the error.<br />
<br />
There are multiple occurrences of the same, because after the errors in=20
files.html was fixed, the same error still happens in other files.</div><di=
v><br /></div><div>Another markup error, at least in documentation version =
3.2.11 (not checking 3.3.3 for now, due to previous errors).<br />
<br />
In the file for the wxAuiDefaultTabArt class,=20
classwx_aui_default_tab_art.html. At (93, 107) there is a closing P tag=20
and at (97, 1) there is an opening P tag. This should be reversed. Turn=20
the first into an open tag and the second into a close tag, and it=E2=80=99=
s=20
fine.<br />
<br />
The same with the file classwx_aui_simple_tab_art.html</div><div><br /></di=
v><div>Something else not markup related. In https://docs.wxwidgets.org/lat=
est/classwx_aui_tab_art.html#a1ec38b831d76261146f8e2f28e57f7b7 , for the cl=
ass wxAuiTabArt the first argument of the method=20
GetBestTabCtrlSize just have a type (wxWindow *) and no name. Seems the=20
name should be wnd, according to the others places where the same=20
argument type appears.<br />
<br />
I don=E2=80=99t know C++ (knew it a so much long time ago it was not the sa=
me),=20
but I am rather sure an argument is useless without a name, whatever the
language. I still may be wrong=E2=80=AF=E2=80=A6<br />
<br />
Searching for =E2=80=9Cconst wxAuiNotebookPageArray &=E2=80=9D and =E2=
=80=9Cconst wxSize=20
&=E2=80=9D in the same page, shows other place with the same issue (unl=
ess=20
it is not an issue).</div><div><br /></div><div><br /></div>
<p></p>
-- <br />
Please read <a href=3D"https://www.wxwidgets.org/support/mlhowto.htm">https=
://www.wxwidgets.org/support/mlhowto.htm</a> before posting.<br />
--- <br />
You received this message because you are subscribed to the Google Groups &=
quot;wx-users" group.<br />
To unsubscribe from this group and stop receiving emails from it, send an e=
mail to <a href=3D"mailto:[email protected]">wx-users+u=
[email protected]</a>.<br />
To view this discussion visit <a href=3D"https://groups.google.com/d/msgid/=
wx-users/147cb519-8a0d-46d4-9228-fe4ff0e979ecn%40googlegroups.com?utm_mediu=
m=3Demail&utm_source=3Dfooter">https://groups.google.com/d/msgid/wx-users/1=
47cb519-8a0d-46d4-9228-fe4ff0e979ecn%40googlegroups.com</a>.<br />
------=_Part_508869_364938032.1784410369221--
------=_Part_508868_1174850382.1784410369221--