<div dir="ltr">As discussed previously regarding auto-generation of css styleables, an annotation on the property can be made displayable in javadoc. The problem is that it will display *all* the parameters of the annotation. For autogeneration, we need more than what we would like to display, so perhaps two different annotations could work, one for the autogeneration and one for doc marking.</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Jul 2, 2024 at 3:49 PM Eric Bresie <<a href="mailto:ebresie@gmail.com">ebresie@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="auto">A little off topic but…</div><div dir="auto"><br></div><div dir="auto">There is a pending JEP for allowing markup to be included in javadocs<br clear="all"><div dir="auto"><a href="https://openjdk.org/jeps/467" target="_blank">https://openjdk.org/jeps/467</a></div><br clear="all"><div dir="auto"><div dir="ltr" class="gmail_signature"><div dir="ltr"><div>Eric Bresie<br><a href="mailto:ebresie@gmail.com" target="_blank">ebresie@gmail.com</a><br></div></div></div></div></div><div><br></div><div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Jul 1, 2024 at 4:35 PM Michael Strauß <<a href="mailto:michaelstrau2@gmail.com" target="_blank">michaelstrau2@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="auto">Further testing shows that while the javadoc tool does support custom tags, it doesn’t lift custom tags defined on JavaFX property fields to the property method documentation.</div><div dir="auto"><br></div><div dir="auto">Lifting documentation from the property field to property methods is a JavaFX-specific feature of Javadoc. At first glance, there seems to be no particular reason why custom tags are ignored in this situation; probably it just wasn’t implemented.</div><div dir="auto"><br></div><div dir="auto">So if we add this custom tag, it won’t show up on the generated HTML. We could start using a custom tag, and then file an enhancement request for Javadoc to lift custom tags to methods just as it does with other tags. What’s your opinion on that?</div><div dir="auto"><br></div><div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Andy Goryachev <<a href="mailto:andy.goryachev@oracle.com" target="_blank">andy.goryachev@oracle.com</a>> schrieb am Mo. 1. Juli 2024 um 23:20:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">





<div lang="EN-US">
<div>
<p class="MsoNormal"><span style="font-size:11pt;font-family:"Iosevka Fixed SS16"">Would even work with Eclipse out of the box:<u style="font-family:"Iosevka Fixed SS16""></u><u style="font-family:"Iosevka Fixed SS16""></u></span></p>
<p class="MsoNormal"><span style="font-family:"Iosevka Fixed SS16";font-size:11pt"> </span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:"Iosevka Fixed SS16""><u style="font-family:"Iosevka Fixed SS16""></u> <u style="font-family:"Iosevka Fixed SS16""></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:"Iosevka Fixed SS16"">I also like the fact that we won't need to maintain links manually as there would not be any.</span></p></div></div><div lang="EN-US"><div><p class="MsoNormal"><span style="font-size:11pt;font-family:"Iosevka Fixed SS16""><u style="font-family:"Iosevka Fixed SS16""></u><u style="font-family:"Iosevka Fixed SS16""></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:"Iosevka Fixed SS16""><u style="font-family:"Iosevka Fixed SS16""></u> <u style="font-family:"Iosevka Fixed SS16""></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:"Iosevka Fixed SS16"">-andy</span></p></div></div></blockquote></div></div>
</blockquote></div></div>
</blockquote></div>