On Fri, 4 Mar 2022 14:06:14 GMT, Daniel Fuchs <dfu...@openjdk.org> wrote:
>> src/java.base/share/classes/java/net/doc-files/net-properties.html line 227:
>>
>>> 225: name.</P>
>>> 226: </OL>
>>> 227: <LI><P><B>{@systemProperty http.auth.digest.reEnabledAlgs}</B>
>>> (default: <none>)<BR>
>>
>> Hello Michael, from what I understand of `doc-files` directory (which is
>> where this html file resides) the `javadoc` tool considers it an unprocessed
>> files location[1]. So would adding the `systemProperty` javadoc taglet here
>> be necessary? I think this won't end up being listed in the system
>> properties index generated by the javadoc tool and I think this line here
>> will just get rendered literally.
>>
>> [1]
>> https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html
>
> This actually seems to work. If you build the docs for JDK mainline, you can
> search for instance, for `http.keepAlive.time.proxy` in the javadoc search
> box and it will lead you `net-properties.html`.
You are right indeed. I just checked the generated system properties index and
it does list these properties and even links back to this document. In fact, I
even found a mail which clearly states that this processing of
`@systemProperties` is supported for `doc-files`
https://mail.openjdk.java.net/pipermail/core-libs-dev/2018-November/056653.html
-------------
PR: https://git.openjdk.java.net/jdk/pull/7688
