1 /*

     2  * Copyright 2002-2005 Sun Microsystems, Inc.  All Rights Reserved.

     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

     4  *

     5  * This code is free software; you can redistribute it and/or modify it

     6  * under the terms of the GNU General Public License version 2 only, as

     7  * published by the Free Software Foundation.

     8  *

     9  * This code is distributed in the hope that it will be useful, but WITHOUT

    10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

    11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

    12  * version 2 for more details (a copy is included in the LICENSE file that

    13  * accompanied this code).

    14  *

    15  * You should have received a copy of the GNU General Public License version

    16  * 2 along with this work; if not, write to the Free Software Foundation,

    17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

    18  *

    19  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,

    20  * CA 95054 USA or visit www.sun.com if you need additional information or

    21  * have any questions.

    22  */

    23 

    24 /*

    25  * @test

    26  * @bug 4720957 5020118

    27  * @summary Test to make sure that -link and -linkoffline link to

    28  * right files.

    29  * @author jamieh

    30  * @library ../lib/

    31  * @build JavadocTester

    32  * @build TestLinkOption

    33  * @run main TestLinkOption

    34  */

    35 

    36 public class TestLinkOption extends JavadocTester {

    37 

    38     private static final String BUG_ID = "4720957-5020118";

    39 

    40     //Generate the documentation using -linkoffline and a URL as the first parameter.

    41     private static final String[] ARGS1 = new String[] {

    42         "-d", BUG_ID + "-1", "-sourcepath", SRC_DIR,

    43         "-linkoffline", "http://java.sun.com/j2se/1.4/docs/api/",

    44         SRC_DIR, "-package", "pkg", "java.lang"

    45     };

    46 

    47     private static final String[][] TEST1 = {

    48         {BUG_ID + "-1" + FS + "pkg" + FS + "C.html",

    49             "<A HREF=\"http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html?is-external=true\" " +

    50             "title=\"class or interface in java.lang\"><CODE>Link to String Class</CODE></A>"

    51         },

    52         //Make sure the parameters are indented properly when the -link option is used.

    53         {BUG_ID + "-1" + FS + "pkg" + FS + "C.html",

    54                                 "(int p1," + NL +

    55             "                     int p2," + NL +

    56             "                     int p3)"

    57         },

    58         {BUG_ID + "-1" + FS + "pkg" + FS + "C.html",

    59                                 "(int p1," + NL +

    60             "                     int p2," + NL +

    61             "                     " +

    62             "<A HREF=\"http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html?is-external=true\" " +

    63             "title=\"class or interface in java.lang\">Object</A>&nbsp;p3)"

    64         },

    65         {BUG_ID + "-1" + FS + "java" + FS + "lang" + FS + "StringBuilderChild.html",

    66                 "public abstract class <B>StringBuilderChild</B><DT>extends <A HREF=\"http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html?is-external=true\" title=\"class or interface in java.lang\">Object</A>"

    67         },

    68 

    69     };

    70     private static final String[][] NEGATED_TEST1 = NO_TEST;

    71 

    72     //Generate the documentation using -linkoffline and a relative path as the first parameter.

    73     //We will try linking to the docs generated in test 1 with a relative path.

    74     private static final String[] ARGS2 = new String[] {

    75         "-d", BUG_ID + "-2", "-sourcepath", SRC_DIR,

    76         "-linkoffline", "../" + BUG_ID + "-1", BUG_ID + "-1", "-package", "pkg2"

    77     };

    78 

    79     private static final String[][] TEST2 = {

    80         {BUG_ID + "-2" + FS + "pkg2" + FS + "C2.html",

    81             "This is a link to <A HREF=\"../../" + BUG_ID + "-1/pkg/C.html?is-external=true\" " +

    82             "title=\"class or interface in pkg\"><CODE>Class C</CODE></A>."

    83         }

    84     };

    85     private static final String[][] NEGATED_TEST2 = NO_TEST;

    86 

    87     /**

    88      * The entry point of the test.

    89      * @param args the array of command line arguments.

    90      */

    91     public static void main(String[] args) {

    92         TestLinkOption tester = new TestLinkOption();

    93         run(tester, ARGS1, TEST1, NEGATED_TEST1);

    94         run(tester, ARGS2, TEST2, NEGATED_TEST2);

    95         tester.printSummary();

    96     }

    97 

    98     /**

    99      * {@inheritDoc}

   100      */

   101     public String getBugId() {

   102         return BUG_ID;

   103     }

   104 

   105     /**

   106      * {@inheritDoc}

   107      */

   108     public String getBugName() {

   109         return getClass().getName();

   110     }

   111 }