langtools/test/jdk/javadoc/doclet/testOrdering/TestOrdering.java

/*
 * Copyright (c) 2014, 2016, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

/*
 * @test
 * @bug 8039410 8042601 8042829 8049393 8050031 8155061
 * @summary test to determine if members are ordered correctly
 * @author ksrini
 * @library ../lib/
 * @modules jdk.javadoc/jdk.javadoc.internal.tool
 * @build JavadocTester
 * @run main TestOrdering
 */

import java.io.File;
import java.io.IOException;
import java.nio.file.Files;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;

import static java.nio.file.StandardOpenOption.*;

public class TestOrdering extends JavadocTester {

    public static void main(String[] args) throws Exception {
        TestOrdering tester = new TestOrdering();
        tester.runTests();
    }

    @Test
    void testUnnamedPackagesForClassUse() {
        javadoc("-d", "out",
                "-sourcepath", testSrc,
                "-use",
                testSrc("C.java"), testSrc("UsedInC.java"));
        checkExit(Exit.OK);
        checkExecutableMemberOrdering("class-use/UsedInC.html");
    }

    @Test
    void testNamedPackagesForClassUse() {
        javadoc("-d", "out-1",
                "-sourcepath", testSrc,
                "-use",
                "pkg1");
        checkExit(Exit.OK);
        checkClassUseOrdering("pkg1/class-use/UsedClass.html");
        checkOrder("pkg1/class-use/UsedClass.html", expectedClassUseMethodOrdering);
        checkOrder("pkg1/class-use/UsedClass.html", expectedClassUseWithTypeParams);
        checkOrder("pkg1/class-use/UsedClass.html", expectedInnerClassContructors);
        checkOrder("pkg1/ImplementsOrdering.html", expectedImplementsOrdering);
        checkOrder("pkg1/OverrideOrdering.html", expectedOverrideOrdering);
        checkOrder("allclasses-noframe.html", expectedAllClasses);
        checkOrder("allclasses-frame.html", expectedAllClasses);
    }

    enum ListOrder { NONE, REVERSE, SHUFFLE };
    /*
     * By default we do not shuffle the input list, in order to keep the list deterministic,
     * and the test predictable. However, we can turn on the stress mode, by setting the following
     * property if required.
     */
    static final ListOrder STRESS_MODE = Boolean.getBoolean("TestOrder.STRESS")
            ? ListOrder.SHUFFLE
            : ListOrder.REVERSE;

    /*
     * Controls the number of sibling packages,  pkg0, pkg1, pkg2, .....
     */
    static final int MAX_PACKAGES = 4;

    /*
     * Controls the number of children packages, pkg0, pkg0.pkg, pkg0.pkg.pkg, .....
     * Note: having too long a depth (> 256 chars on Windows), will likely lead to
     * cause problems with automated build and test systems.
     */
    static final int MAX_SUBPACKAGES_DEPTH = 4;
    @Test
    void testIndexOrdering() throws IOException {
        final String clsname = "Add";
        List<String> cmdArgs = new ArrayList();
        cmdArgs.add("-d");
        cmdArgs.add("out-2");
        cmdArgs.add("-sourcepath");
        cmdArgs.add("src");
        cmdArgs.add("-package");
        System.out.println("STRESS_MODE: " + STRESS_MODE);
        emitFile(null, clsname, STRESS_MODE);
        for (int width = 0 ; width < MAX_PACKAGES ; width++) {
            String wpkgname = "add" + width;
            String dpkgname = wpkgname;
            emitFile(wpkgname, clsname, ListOrder.NONE); // list as-is
            cmdArgs.add(wpkgname);
            for (int depth = 1 ; depth < MAX_SUBPACKAGES_DEPTH ; depth++) {
                dpkgname = dpkgname + ".add";
                emitFile(dpkgname, clsname, STRESS_MODE);
                cmdArgs.add(dpkgname);
            }
        }
        File srcDir = new File(new File("."), "src");
        cmdArgs.add(new File(srcDir, clsname + ".java").getPath());
        javadoc(cmdArgs.toArray(new String[cmdArgs.size()]));
        checkExit(Exit.OK);
        checkOrder("index-all.html", composeTestVectors());
        checkOrder("add0/add/package-tree.html", expectedPackageTreeOrdering);
        checkOrder("overview-tree.html", expectedOverviewOrdering);
        checkOrder("overview-frame.html", expectedOverviewFrameOrdering);
    }

    @Test
    void testIndexTypeClustering() {
        javadoc("-d", "out-3",
                "-sourcepath", testSrc("src-2"),
                "-use",
                "a",
                "b",
                "e",
                "something");
        checkOrder("index-all.html", typeTestVectors);
        checkExit(Exit.OK);
    }

    @Test
    void testMethodDetailOrdering() {
        javadoc("-d", "out-4",
                "-sourcepath", testSrc(new File(".").getPath()),
                "order"
        );
        checkOrder("order/MethodOrder.html", methodSourceOrderVectors);
        checkExit(Exit.OK);
    }

    String[] methodSourceOrderVectors = {
        "<pre>public&nbsp;void&nbsp;d()</pre>\n" +
        "<div class=\"block\">Method d.\n" +
        " Second line.</div>",
        "<pre>public&nbsp;void&nbsp;b()</pre>\n" +
        "<div class=\"block\">Method b.\n" +
        " Second line.</div>",
        "<pre>public&nbsp;void&nbsp;c()</pre>\n" +
        "<div class=\"block\">Method c.\n" +
        " Second line.</div>",
        "<pre>public&nbsp;void&nbsp;a()</pre>\n" +
        "<div class=\"block\">Method a.\n" +
        " Second line.</div>"
    };

    String[] typeTestVectors = {
        "something</a> - package something</dt>",
        "something</span></a> - Class in",
        "something</span></a> - Enum in",
        "something</span></a> - Interface in",
        "something</span></a> - Annotation Type in",
        "something</a></span> - Variable in class",
        "something()</a></span> - Constructor",
        "something()</a></span> - Method in class a.<a href=\"a/A.html\"",
        "something()</a></span> - Method in class a.<a href=\"a/something.html\"",
        "something()</a></span> - Method in class something.<a href=\"something/J.html\""
    };
    String[] composeTestVectors() {
        List<String> testList = new ArrayList<>();

        testList.addAll(Arrays.asList(expectedPackageOrdering));

        for (String x : expectedMethodOrdering) {
            testList.add(x);
            for (int i = 0; i < MAX_PACKAGES; i++) {
                String wpkg = "add" + i;
                testList.add(wpkg + "/" + x);
                String dpkg = wpkg;
                for (int j = 1; j < MAX_SUBPACKAGES_DEPTH; j++) {
                    dpkg = dpkg + "/" + "add";
                    testList.add(dpkg + "/" + x);
                }
            }
        }

        for (String x : expectedEnumOrdering) {
            testList.add(x.replace("REPLACE_ME", "&lt;Unnamed&gt;"));
            for (int i = 0; i < MAX_PACKAGES; i++) {
                String wpkg = "add" + i;
                testList.add(wpkg + "/" + x.replace("REPLACE_ME", wpkg));
                String dpkg = wpkg;
                for (int j = 1; j < MAX_SUBPACKAGES_DEPTH; j++) {
                    dpkg = dpkg + "/" + "add";
                    testList.add(dpkg + "/" + x.replace("REPLACE_ME", pathToPackage(dpkg)));
                }
            }
        }

        testList.addAll(Arrays.asList(expectedFieldOrdering));

        return testList.toArray(new String[testList.size()]);
    }

    void checkExecutableMemberOrdering(String usePage) {
        String contents = readFile(usePage);
        // check constructors
        checking("constructors");
        int idx1 = contents.indexOf("C.html#C-UsedInC");
        int idx2 = contents.indexOf("C.html#C-UsedInC-int");
        int idx3 = contents.indexOf("C.html#C-UsedInC-java.lang.String");
        if (idx1 == -1 || idx2 == -1 || idx3 == -1) {
            failed("ctor strings not found");
        } else if (idx1 > idx2 || idx2 > idx3 || idx1 > idx3) {
            failed("ctor strings are out of order");
        } else
            passed("ctor strings are in order");

        // check methods
        checking("methods");
        idx1 = contents.indexOf("C.html#ymethod-int");
        idx2 = contents.indexOf("C.html#ymethod-java.lang.String");
        if (idx1 == -1 || idx2 == -1) {
            failed("#ymethod strings not found");
        } else if (idx1 > idx2) {
            failed("#ymethod strings are out of order");
        } else
            passed("Executable Member Ordering: OK");
    }

    void checkClassUseOrdering(String usePage) {
        checkClassUseOrdering(usePage, "pkg1/C#ITERATION#.html#zfield");
        checkClassUseOrdering(usePage, "pkg1/C#ITERATION#.html#fieldInC#ITERATION#");
        checkClassUseOrdering(usePage, "pkg1/C#ITERATION#.html#zmethod-pkg1.UsedClass");
        checkClassUseOrdering(usePage, "pkg1/C#ITERATION#.html#methodInC#ITERATION#");
    }

    void checkClassUseOrdering(String usePage, String searchString) {
        String contents = readFile(usePage);
        int lastidx = 0;
        System.out.println("testing for " + searchString);
        for (int i = 1; i < 5; i++) {
            String s = searchString.replaceAll("#ITERATION#", Integer.toString(i));
            checking(s);
            int idx = contents.indexOf(s);
            if (idx < lastidx) {
                failed(s + ", member ordering error, last:" + lastidx + ", got:" + idx);
            } else {
                passed("\tlast: " + lastidx + " got:" + idx);
            }
            lastidx = idx;
        }
    }

    static String[] contents = {
        "public add ADDADD;",
        "public add AddAdd;",
        "public add addadd;",
        "public enum add {add, ADD, addd, ADDD};",
        "public enum ADD {ADD, add, addd, ADDD};",
        "public void   add(){}",
        "public void   add(double d){}",
        "public void   add(int i, float f){}",
        "public void   add(float f, int i){}",
        "public void   add(double d, byte b){}",
        "public Double add(Double d) {return (double) 22/7;}",
        "public double add(double d1, double d2) {return d1 + d2;}",
        "public double add(double d1, Double  d2) {return d1 + d2;}",
        "public Float  add(float f) {return (float) 22/7;}",
        "public void   add(int i){}",
        "public int    add(Integer i) {return 0;}"
    };

    void emitFile(String pkgname, String clsname, ListOrder order) throws IOException {
        File srcDir = new File("src");
        File outDir = pkgname == null
            ? srcDir
            : new File(srcDir, pkgname.replace(".", File.separator));
        File outFile = new File(outDir, clsname + ".java");
        outDir.mkdirs();
        List<String> scratch = new ArrayList<>(Arrays.asList(contents));
        switch (order) {
            case SHUFFLE:
                Collections.shuffle(scratch);
                break;
            case REVERSE:
                Collections.reverse(scratch);
                break;
            default:
                // leave list as-is
        }
        // insert the header
        scratch.add(0, "public class " + clsname + " {");
        if (pkgname != null) {
            scratch.add(0, "package " + pkgname + ";");
        }
        // append the footer
        scratch.add("}");
        Files.write(outFile.toPath(), scratch, CREATE, TRUNCATE_EXISTING);
    }

    String pathToPackage(String in) {
        return in.replace("/", ".");
    }

    final String expectedAllClasses[] = {
        "pkg1/A.html\" title=\"class in pkg1",
        "pkg1/A.C.html\" title=\"class in pkg1",
        "pkg1/B.html\" title=\"class in pkg1",
        "pkg1/B.A.html\" title=\"class in pkg1",
        "pkg1/C1.html\" title=\"class in pkg1",
        "pkg1/C2.html\" title=\"class in pkg1",
        "pkg1/C3.html\" title=\"class in pkg1",
        "pkg1/C4.html\" title=\"class in pkg1",
        "pkg1/ImplementsOrdering.html\" title=\"interface in pkg1",
        "pkg1/MethodOrder.html\" title=\"class in pkg1",
        "pkg1/OverrideOrdering.html\" title=\"class in pkg1",
        "pkg1/UsedClass.html\" title=\"class in pkg1"

    };

    final String expectedInnerClassContructors[] = {
        "../../pkg1/A.html#A-pkg1.UsedClass-",
        "../../pkg1/B.A.html#A-pkg1.UsedClass-",
        "../../pkg1/B.html#B-pkg1.UsedClass-",
        "../../pkg1/A.C.html#C-pkg1.UsedClass-java.lang.Object:A-",
        "../../pkg1/A.C.html#C-pkg1.UsedClass-java.util.Collection-",
        "../../pkg1/A.C.html#C-pkg1.UsedClass-java.util.List-"
    };

    final String expectedClassUseMethodOrdering[] = {
        "../../pkg1/MethodOrder.html#m--",
        "../../pkg1/MethodOrder.html#m-byte:A-",
        "../../pkg1/MethodOrder.html#m-double-",
        "../../pkg1/MethodOrder.html#m-double-double-",
        "../../pkg1/MethodOrder.html#m-double-java.lang.Double-",
        "../../pkg1/MethodOrder.html#m-int-",
        "../../pkg1/MethodOrder.html#m-int-int-",
        "../../pkg1/MethodOrder.html#m-int-java.lang.Integer-",
        "../../pkg1/MethodOrder.html#m-long-",
        "../../pkg1/MethodOrder.html#m-long-long-",
        "../../pkg1/MethodOrder.html#m-long-java.lang.Long-",
        "../../pkg1/MethodOrder.html#m-long-java.lang.Long...-",
        "../../pkg1/MethodOrder.html#m-java.lang.Double-",
        "../../pkg1/MethodOrder.html#m-java.lang.Double-double-",
        "../../pkg1/MethodOrder.html#m-java.lang.Double-java.lang.Double-",
        "../../pkg1/MethodOrder.html#m-java.lang.Integer-",
        "../../pkg1/MethodOrder.html#m-java.lang.Integer-int-",
        "../../pkg1/MethodOrder.html#m-java.lang.Integer-java.lang.Integer-",
        "../../pkg1/MethodOrder.html#m-java.lang.Object:A-",
        "../../pkg1/MethodOrder.html#m-java.util.ArrayList-",
        "../../pkg1/MethodOrder.html#m-java.util.Collection-",
        "../../pkg1/MethodOrder.html#m-java.util.List-"
    };

    final String expectedClassUseWithTypeParams[] = {
        "../../pkg1/MethodOrder.html#tpm-pkg1.UsedClass-",
        "../../pkg1/MethodOrder.html#tpm-pkg1.UsedClass-pkg1.UsedClass-",
        "../../pkg1/MethodOrder.html#tpm-pkg1.UsedClass-pkg1.UsedClass:A-",
        "../../pkg1/MethodOrder.html#tpm-pkg1.UsedClass-java.lang.String-"
    };

    final String expectedPackageOrdering[] = {
        "\"add0/package-summary.html\">add0</a> - package add0",
        "\"add0/add/package-summary.html\">add0.add</a> - package add0.add",
        "\"add0/add/add/package-summary.html\">add0.add.add</a> - package add0.add.add",
        "\"add0/add/add/add/package-summary.html\">add0.add.add.add</a> - package add0.add.add.add",
        "\"add1/package-summary.html\">add1</a> - package add1",
        "\"add1/add/package-summary.html\">add1.add</a> - package add1.add",
        "\"add1/add/add/package-summary.html\">add1.add.add</a> - package add1.add.add",
        "\"add1/add/add/add/package-summary.html\">add1.add.add.add</a> - package add1.add.add.add",
        "\"add2/package-summary.html\">add2</a> - package add2",
        "\"add2/add/package-summary.html\">add2.add</a> - package add2.add",
        "\"add2/add/add/package-summary.html\">add2.add.add</a> - package add2.add.add",
        "\"add2/add/add/add/package-summary.html\">add2.add.add.add</a> - package add2.add.add.add",
        "\"add3/package-summary.html\">add3</a> - package add3",
        "\"add3/add/package-summary.html\">add3.add</a> - package add3.add",
        "\"add3/add/add/package-summary.html\">add3.add.add</a> - package add3.add.add",
        "\"add3/add/add/add/package-summary.html\">add3.add.add.add</a> - package add3.add.add.add"
    };

    final String expectedMethodOrdering[] = {
        "Add.html#add--",
        "Add.html#add-double-",
        "Add.html#add-double-byte-",
        "Add.html#add-double-double-",
        "Add.html#add-double-java.lang.Double-",
        "Add.html#add-float-",
        "Add.html#add-float-int-",
        "Add.html#add-int-",
        "Add.html#add-int-float-",
        "Add.html#add-java.lang.Double-",
        "Add.html#add-java.lang.Integer-"
    };

    final String expectedEnumOrdering[] = {
        "Add.add.html\" title=\"enum in REPLACE_ME\"",
        "Add.ADD.html\" title=\"enum in REPLACE_ME\""
    };

    final String expectedFieldOrdering[] = {
        "Add.html#addadd\"",
        "add0/add/add/add/Add.html#addadd\"",
        "add0/add/add/Add.html#addadd\"",
        "add0/add/Add.html#addadd\"",
        "add0/Add.html#addadd\"",
        "add1/add/add/add/Add.html#addadd\"",
        "add1/add/add/Add.html#addadd\"",
        "add1/add/Add.html#addadd\"",
        "add1/Add.html#addadd\"",
        "add2/add/add/add/Add.html#addadd\"",
        "add2/add/add/Add.html#addadd\"",
        "add2/add/Add.html#addadd\"",
        "add2/Add.html#addadd\"",
        "add3/add/add/add/Add.html#addadd\"",
        "add3/add/add/Add.html#addadd\"",
        "add3/add/Add.html#addadd\"",
        "add3/Add.html#addadd\"",
        "Add.html#AddAdd\"",
        "add0/add/add/add/Add.html#AddAdd\"",
        "add0/add/add/Add.html#AddAdd\"",
        "add0/add/Add.html#AddAdd\"",
        "add0/Add.html#AddAdd\"",
        "add1/add/add/add/Add.html#AddAdd\"",
        "add1/add/add/Add.html#AddAdd\"",
        "add1/add/Add.html#AddAdd\"",
        "add1/Add.html#AddAdd\"",
        "add2/add/add/add/Add.html#AddAdd\"",
        "add2/add/add/Add.html#AddAdd\"",
        "add2/add/Add.html#AddAdd\"",
        "add2/Add.html#AddAdd\"",
        "add3/add/add/add/Add.html#AddAdd\"",
        "add3/add/add/Add.html#AddAdd\"",
        "add3/add/Add.html#AddAdd\"",
        "add3/Add.html#AddAdd\"",
        "Add.html#ADDADD\"",
        "add0/add/add/add/Add.html#ADDADD\"",
        "add0/add/add/Add.html#ADDADD\"",
        "add0/add/Add.html#ADDADD\"",
        "add0/Add.html#ADDADD\"",
        "add1/add/add/add/Add.html#ADDADD\"",
        "add1/add/add/Add.html#ADDADD\"",
        "add1/add/Add.html#ADDADD\"",
        "add1/Add.html#ADDADD\"",
        "add2/add/add/add/Add.html#ADDADD\"",
        "add2/add/add/Add.html#ADDADD\"",
        "add2/add/Add.html#ADDADD\"",
        "add2/Add.html#ADDADD\"",
        "add3/add/add/add/Add.html#ADDADD\"",
        "add3/add/add/Add.html#ADDADD\"",
        "add3/add/Add.html#ADDADD\"",
        "add3/Add.html#ADDADD\""
    };

    final String expectedPackageTreeOrdering[] = {
        "<a href=\"../../add0/add/Add.add.html\" title=\"enum in add0.add\">",
        "<a href=\"../../add0/add/Add.ADD.html\" title=\"enum in add0.add\">"
    };

    final String expectedOverviewOrdering[] = {
        "<a href=\"Add.add.html\" title=\"enum in &lt;Unnamed&gt;\">",
        "<a href=\"add0/Add.add.html\" title=\"enum in add0\">",
        "<a href=\"add0/add/Add.add.html\" title=\"enum in add0.add\">",
        "<a href=\"add0/add/add/Add.add.html\" title=\"enum in add0.add.add\">",
        "<a href=\"add0/add/add/add/Add.add.html\" title=\"enum in add0.add.add.add\">",
        "<a href=\"add1/Add.add.html\" title=\"enum in add1\">",
        "<a href=\"add1/add/Add.add.html\" title=\"enum in add1.add\">",
        "<a href=\"add1/add/add/Add.add.html\" title=\"enum in add1.add.add\">",
        "<a href=\"add1/add/add/add/Add.add.html\" title=\"enum in add1.add.add.add\">",
        "<a href=\"add2/Add.add.html\" title=\"enum in add2\">",
        "<a href=\"add2/add/Add.add.html\" title=\"enum in add2.add\">",
        "<a href=\"add2/add/add/Add.add.html\" title=\"enum in add2.add.add\">",
        "<a href=\"add2/add/add/add/Add.add.html\" title=\"enum in add2.add.add.add\">",
        "<a href=\"add3/Add.add.html\" title=\"enum in add3\">",
        "<a href=\"add3/add/Add.add.html\" title=\"enum in add3.add\">",
        "<a href=\"add3/add/add/Add.add.html\" title=\"enum in add3.add.add\">",
        "<a href=\"add3/add/add/add/Add.add.html\" title=\"enum in add3.add.add.add\">",
        "<a href=\"Add.ADD.html\" title=\"enum in &lt;Unnamed&gt;\">",
        "<a href=\"add0/Add.ADD.html\" title=\"enum in add0\">",
        "<a href=\"add0/add/Add.ADD.html\" title=\"enum in add0.add\">",
        "<a href=\"add0/add/add/Add.ADD.html\" title=\"enum in add0.add.add\">",
        "<a href=\"add0/add/add/add/Add.ADD.html\" title=\"enum in add0.add.add.add\">",
        "<a href=\"add1/Add.ADD.html\" title=\"enum in add1\">",
        "<a href=\"add1/add/Add.ADD.html\" title=\"enum in add1.add\">",
        "<a href=\"add1/add/add/Add.ADD.html\" title=\"enum in add1.add.add\">",
        "<a href=\"add1/add/add/add/Add.ADD.html\" title=\"enum in add1.add.add.add\">",
        "<a href=\"add2/Add.ADD.html\" title=\"enum in add2\">",
        "<a href=\"add2/add/Add.ADD.html\" title=\"enum in add2.add\">",
        "<a href=\"add2/add/add/Add.ADD.html\" title=\"enum in add2.add.add\">",
        "<a href=\"add2/add/add/add/Add.ADD.html\" title=\"enum in add2.add.add.add\">",
        "<a href=\"add3/Add.ADD.html\" title=\"enum in add3\">",
        "<a href=\"add3/add/Add.ADD.html\" title=\"enum in add3.add\">",
        "<a href=\"add3/add/add/Add.ADD.html\" title=\"enum in add3.add.add\">",
        "<a href=\"add3/add/add/add/Add.ADD.html\" title=\"enum in add3.add.add.add\">",
    };

    final static String expectedOverviewFrameOrdering[] = {
        "<a href=\"package-frame.html\" target=\"packageFrame\">&lt;unnamed package&gt;</a>",
        "<a href=\"add0/package-frame.html\" target=\"packageFrame\">add0</a>",
        "<a href=\"add0/add/package-frame.html\" target=\"packageFrame\">add0.add</a>",
        "<a href=\"add0/add/add/package-frame.html\" target=\"packageFrame\">add0.add.add</a>",
        "<a href=\"add0/add/add/add/package-frame.html\" target=\"packageFrame\">add0.add.add.add</a>",
        "<a href=\"add1/package-frame.html\" target=\"packageFrame\">add1</a>",
        "<a href=\"add1/add/package-frame.html\" target=\"packageFrame\">add1.add</a>",
        "<a href=\"add1/add/add/package-frame.html\" target=\"packageFrame\">add1.add.add</a>",
        "<a href=\"add1/add/add/add/package-frame.html\" target=\"packageFrame\">add1.add.add.add</a>",
        "<a href=\"add2/package-frame.html\" target=\"packageFrame\">add2</a>",
        "<a href=\"add2/add/package-frame.html\" target=\"packageFrame\">add2.add</a>",
        "<a href=\"add2/add/add/package-frame.html\" target=\"packageFrame\">add2.add.add</a>",
        "<a href=\"add2/add/add/add/package-frame.html\" target=\"packageFrame\">add2.add.add.add</a>",
        "<a href=\"add3/package-frame.html\" target=\"packageFrame\">add3</a>",
        "<a href=\"add3/add/package-frame.html\" target=\"packageFrame\">add3.add</a>",
        "<a href=\"add3/add/add/package-frame.html\" target=\"packageFrame\">add3.add.add</a>",
        "<a href=\"add3/add/add/add/package-frame.html\" target=\"packageFrame\">add3.add.add.add</a></li>"
    };

    final static String expectedImplementsOrdering[] = {
        "<dd><code>close</code>&nbsp;in interface&nbsp;<code>java.lang.AutoCloseable</code></dd>",
        "<dd><code>close</code>&nbsp;in interface&nbsp;<code>java.nio.channels.Channel</code></dd>",
        "<dd><code>close</code>&nbsp;in interface&nbsp;<code>java.io.Closeable</code></dd>"
    };

    final static String expectedOverrideOrdering[] = {
        "<dd><code>iterator</code>&nbsp;in interface&nbsp;<code>java.util.Collection&lt;",
        "<dd><code>iterator</code>&nbsp;in interface&nbsp;<code>java.lang.Iterable&lt;"
    };
}