RFR: 8285488: Improve DocFinder [v4]

[Pavel Rappo]

On Fri, 28 Oct 2022 20:03:59 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> > JDK API Documentation is the same, except for two files. In the first file, docs/api/java.management.rmi/javax/management/remote/rmi/RMIConnectionImpl_Stub.html, the order of exceptions has changed, which is insignificant.
> 
> Is there now a defined order in which exceptions will be documented, and what was it before?

Generally speaking, the order was and still is the _encounter order_. It's the resolution of 8287796 that changed a few places so that you can see the difference between BFS and DFS.

There was a commit with a message that describes that. Let me see if I can quickly find it. Yes, here it is: 2475c1f2834dd5ad671c0f05a3e9c906a9a3d29b

    commit 2475c1f2834dd5ad671c0f05a3e9c906a9a3d29b
    Author: Pavel Rappo <prappo at openjdk.org>
    Date:   Wed Oct 12 11:57:55 2022 +0100

        fix: remove auto-inheriting of subexceptions

        This effectively implements 8287796: Stop auto-inheriting documentation
        for subclasses of exceptions whose documentation is inherited.

        All tests pass. The only difference in the JDK API Documentation is
        the order of exceptions in some methods of RMIConnectionImpl_Stub:
        MBeanException and MBeanRegistrationException are ordered
        reversely. That difference is insignificant.

-------------

PR: https://git.openjdk.org/jdk/pull/10746