Re: Technical issues with the HTML documentation

Mike Musterd <[email protected]> Sun, 19 Jul 2026 18:02:41 +0200
Newsgroups gmane.comp.lib.wxwindows.general
Message-ID <CA+824D3dvv0xHst_LLX-KSBUw+-6FwUubu=KgTmk-AyoxbS1Xg@mail.gmail.com>
--000000000000c7990d0656f8ec8c
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

In c++ the argument name in header or interface does not matter and is
optional. Omitting this is therefore not an error in documentation.

Regards,

Mike

Op zo 19 jul 2026, 17:20 schreef 'Hibou57' via wx-users <
[email protected]>:

>
> Le dimanche 19 juillet 2026 =C3=A0 15:09:17 UTC+2, Hibou57 a =C3=A9crit :
>
> In https://docs.wxwidgets.org/latest/classwx_p_g_root_property.html the
> method StringToValue appears to have no name for neither arguments. Their
> names in the include file are variant, text and argFlags.
>
> I don=E2=80=99t see what can cause this. May be this is a Doxygen bug?
>
>
> May be more on this, with a more informative case. In
> https://docs.wxwidgets.org/latest/classwx_rich_text_buffer_data_object.ht=
ml
> in the class wxRichTextBufferDataObject, the second overloading
> of GetDataSize has an unnamed argument, which is unnamed also in the
> include file. The argument is not used. May in the previous cases, the
> arguments was named in the signature but not used in the implementation. =
It
> explains things, but it is not that good to expose implementation details
> which may change or depends on the platform,, in the documentation.
>
> Will stop reporting this king of case, since I'm not sure.
>
> --
> Please read https://www.wxwidgets.org/support/mlhowto.htm before posting.
> ---
> 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
> email to [email protected].
> To view this discussion visit
> https://groups.google.com/d/msgid/wx-users/72c3417f-9e5c-4d53-978b-28d1e5=
ee50f9n%40googlegroups.com
> <https://groups.google.com/d/msgid/wx-users/72c3417f-9e5c-4d53-978b-28d1e=
5ee50f9n%40googlegroups.com?utm_medium=3Demail&utm_source=3Dfooter>
> .
>

--=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/CA=
%2B824D3dvv0xHst_LLX-KSBUw%2B-6FwUubu%3DKgTmk-AyoxbS1Xg%40mail.gmail.com.

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

<div dir=3D"auto">In c++ the argument name in header or interface does not =
matter and is optional. Omitting this is therefore not an error in document=
ation.<div dir=3D"auto"><br></div><div dir=3D"auto">Regards,=C2=A0</div><di=
v dir=3D"auto"><br></div><div dir=3D"auto">Mike</div></div><br><div class=
=3D"gmail_quote gmail_quote_container"><div dir=3D"ltr" class=3D"gmail_attr=
">Op zo 19 jul 2026, 17:20 schreef &#39;Hibou57&#39; via wx-users &lt;<a hr=
ef=3D"mailto:[email protected]">[email protected]</a>&gt;:<=
br></div><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;borde=
r-left:1px #ccc solid;padding-left:1ex"><br><div><div dir=3D"auto">Le diman=
che 19 juillet 2026 =C3=A0 15:09:17 UTC+2, Hibou57 a =C3=A9crit=C2=A0:<br><=
/div><blockquote style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rg=
b(204,204,204);padding-left:1ex"><div>In=C2=A0<a href=3D"https://docs.wxwid=
gets.org/latest/classwx_p_g_root_property.html" rel=3D"nofollow noreferrer"=
 target=3D"_blank">https://docs.wxwidgets.org/latest/classwx_p_g_root_prope=
rty.html</a> the method=C2=A0StringToValue appears to have no name for neit=
her arguments. Their names in the include file are variant, text and argFla=
gs.</div><div><br></div><div>I don=E2=80=99t see what can cause this. May b=
e this is a Doxygen bug?</div></blockquote><div><br></div><div>May be more =
on this, with a more informative case. In=C2=A0<a href=3D"https://docs.wxwi=
dgets.org/latest/classwx_rich_text_buffer_data_object.html" target=3D"_blan=
k" rel=3D"noreferrer">https://docs.wxwidgets.org/latest/classwx_rich_text_b=
uffer_data_object.html</a> in the class=C2=A0wxRichTextBufferDataObject,=C2=
=A0the second overloading of=C2=A0GetDataSize=C2=A0has an unnamed argument,=
 which is unnamed also in the include file. The argument is not used. May i=
n the previous cases, the arguments was named in the signature but not used=
 in the implementation. It explains things, but it is not that good to expo=
se implementation details which may change or depends on the platform,, in =
the documentation.</div><div><br></div><div>Will stop reporting this king o=
f case, since I&#39;m not sure.</div><div><br></div></div>

<p></p>

-- <br>
Please read <a href=3D"https://www.wxwidgets.org/support/mlhowto.htm" targe=
t=3D"_blank" rel=3D"noreferrer">https://www.wxwidgets.org/support/mlhowto.h=
tm</a> before posting.<br>
--- <br>
You received this message because you are subscribed to the Google Groups &=
quot;wx-users&quot; group.<br>
To unsubscribe from this group and stop receiving emails from it, send an e=
mail to <a href=3D"mailto:[email protected]" target=3D"=
_blank" rel=3D"noreferrer">[email protected]</a>.<br>
To view this discussion visit <a href=3D"https://groups.google.com/d/msgid/=
wx-users/72c3417f-9e5c-4d53-978b-28d1e5ee50f9n%40googlegroups.com?utm_mediu=
m=3Demail&amp;utm_source=3Dfooter" target=3D"_blank" rel=3D"noreferrer">htt=
ps://groups.google.com/d/msgid/wx-users/72c3417f-9e5c-4d53-978b-28d1e5ee50f=
9n%40googlegroups.com</a>.<br>
</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&quot; 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/CA%2B824D3dvv0xHst_LLX-KSBUw%2B-6FwUubu%3DKgTmk-AyoxbS1Xg%40mail.g=
mail.com?utm_medium=3Demail&utm_source=3Dfooter">https://groups.google.com/=
d/msgid/wx-users/CA%2B824D3dvv0xHst_LLX-KSBUw%2B-6FwUubu%3DKgTmk-AyoxbS1Xg%=
40mail.gmail.com</a>.<br />

--000000000000c7990d0656f8ec8c--