Repository navigation
gmime-format-options.h: bad <a> #131
Description
gmime/gmime-format-options.h says:
* Content-Disposition parameter values is the method described in
* <a href="https://tools.ietf.org/html/rfc2231">rfc2231</a>. However, it is common for
* some older email clients to improperly encode using the method described in
* <a href="https://tools.ietf.org/html/rfc2047">rfc2047</a> instead.
But the <a href="…"> syntax doesn't seem to be understood by documentation generators.
In https://developer-old.gnome.org/gmime/stable/gmime-GMimeFormatOptions.html#GMimeParamEncodingMethod, this fragment shows up as:
The MIME specifications specify that the proper method for encoding Content-Type and Content-Disposition parameter values is the method described in
<a>rfc2231</a>. However, it is common for
some older email clients to improperly encode using the method described in
<a>rfc2047</a> instead.
Activity
jstedfast commentedon Oct 13, 2022
Ugh, thanks for the heads-up on that. I might just kill the href links.
jwilk commentedon Oct 13, 2022
According to https://wiki.gnome.org/DocumentationProject/GtkDoc#Linking, you can use
<ulink url="…">instead.Use gtk-doc ulink syntax in doc comments instead of <a href=...>
jstedfast commentedon Oct 13, 2022
Of course, now that the docs are fixed in gmime's source repo, I don't think they can be updated on developer-old.gnome.org anymore (I think that's been archived).
The docs used to get regenerated every release, but they don't anymore.