Re: Technical issues with the HTML documentation
"'Hibou57' via wx-users" <[email protected]> Sat, 18 Jul 2026 17:58:44 -0700 (PDT)
| Newsgroups | gmane.comp.lib.wxwindows.general |
|---|---|
| Message-ID | <[email protected]> |
------=_Part_504628_1505457173.1784422724923 Content-Type: multipart/alternative; boundary="----=_Part_504629_901950220.1784422724923" ------=_Part_504629_901950220.1784422724923 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable In https://docs.wxwidgets.org/latest/helpfrm_8h.html , wxHF_DEFAULT_STYLE= =20 appears as having no value. Le samedi 18 juillet 2026 =C3=A0 23:42:04 UTC+2, Hibou57 a =C3=A9crit : > 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 i= s=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 i= s=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=20 > known anything about Doxygen templates and document generation, so can=E2= =80=99t=20 > tell more, except at the time div#page_container is closed, div#doc-conte= nt=20 > is 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 a= nd=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 = fine. > > 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#a1ec38b831d762= 61146f8e2f28e57f7b7=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 argumen= t=20 > type appears. > > I don=E2=80=99t know C++ (knew it a so much long time ago it was not the = same),=20 > but 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/74= 3c7f2e-8baa-4bfe-93ad-9c97cdfa8a29n%40googlegroups.com. ------=_Part_504629_901950220.1784422724923 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable In https://docs.wxwidgets.org/latest/helpfrm_8h.html , wxHF_DEFAULT_STYLE a= ppears as having no value.<br /><br /><div class=3D"gmail_quote"><div dir= =3D"auto" class=3D"gmail_attr">Le samedi 18 juillet 2026 =C3=A0 23:42:04 UT= C+2, Hibou57 a =C3=A9crit=C2=A0:<br/></div><blockquote class=3D"gmail_quote= " style=3D"margin: 0 0 0 0.8ex; border-left: 1px solid rgb(204, 204, 204); = padding-left: 1ex;"><div>Prior note: wanted to submit it as an issue on Git= Hub, but the relevant 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=A0<a href=3D"https://forums.wxwidgets.org/viewtopic.php?t=3D526= 56" target=3D"_blank" rel=3D"nofollow" data-saferedirecturl=3D"https://www.= google.com/url?hl=3Dfr&q=3Dhttps://forums.wxwidgets.org/viewtopic.php?t= %3D52656&source=3Dgmail&ust=3D1784509015344000&usg=3DAOvVaw2GEf= njC4dDq0zHKzoVAZH9">https://forums.wxwidgets.org/viewtopic.php?t=3D52656</a= >=C2=A0):</div><div><br></div><div>Was parsing the documentation for some p= urpose. 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></s= pan></div><div><span><span>=C2=A0 =C2=A0 </div>=C2=A0</span></span></= div><div><span><span>=C2=A0 =C2=A0 </div> <!-- #page_container --&= gt;=C2=A0</span></span></div><div><span><span>=C2=A0 =C2=A0 </body>= =C2=A0</span></span></div><div><span><span>=C2=A0 =C2=A0 </html></spa= n></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></div>= <div>Something else not markup related. In <a href=3D"https://docs.wxwidget= s.org/latest/classwx_aui_tab_art.html#a1ec38b831d76261146f8e2f28e57f7b7" ta= rget=3D"_blank" rel=3D"nofollow" data-saferedirecturl=3D"https://www.google= .com/url?hl=3Dfr&q=3Dhttps://docs.wxwidgets.org/latest/classwx_aui_tab_= art.html%23a1ec38b831d76261146f8e2f28e57f7b7&source=3Dgmail&ust=3D1= 784509015344000&usg=3DAOvVaw0XK4ICUZU46AuGui4D4lK_">https://docs.wxwidg= ets.org/latest/classwx_aui_tab_art.html#a1ec38b831d76261146f8e2f28e57f7b7</= a> , 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=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></blockquote></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/743c7f2e-8baa-4bfe-93ad-9c97cdfa8a29n%40googlegroups.com?utm_mediu= m=3Demail&utm_source=3Dfooter">https://groups.google.com/d/msgid/wx-users/7= 43c7f2e-8baa-4bfe-93ad-9c97cdfa8a29n%40googlegroups.com</a>.<br /> ------=_Part_504629_901950220.1784422724923-- ------=_Part_504628_1505457173.1784422724923--