src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/util/DocPaths.java
author bpatel
Wed, 13 Dec 2017 12:45:06 -0800
changeset 48295 c79d31ba84b9
parent 48029 e9dab2492924
child 48759 ffa68af7da87
permissions -rw-r--r--
8164407: Add module support for -link and -linkoffline javadoc option Reviewed-by: jjg, ksrini
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
     1
/*
43370
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
     2
 * Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
     4
 *
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    10
 *
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    15
 * accompanied this code).
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    16
 *
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    20
 *
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    23
 * questions.
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    24
 */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    25
35426
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs
ksrini
parents: 33920
diff changeset
    26
package jdk.javadoc.internal.doclets.toolkit.util;
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    27
36526
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
    28
import javax.lang.model.element.ModuleElement;
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
    29
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    30
/**
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    31
 * Standard DocPath objects.
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    32
 *
14368
6f4c62de6985 8001664: refactor javadoc to use abstraction to handle files
jjg
parents: 14357
diff changeset
    33
 *  <p><b>This is NOT part of any supported API.
6f4c62de6985 8001664: refactor javadoc to use abstraction to handle files
jjg
parents: 14357
diff changeset
    34
 *  If you write code that depends on this, you do so at your own risk.
6f4c62de6985 8001664: refactor javadoc to use abstraction to handle files
jjg
parents: 14357
diff changeset
    35
 *  This code and its internal interfaces are subject to change or
6f4c62de6985 8001664: refactor javadoc to use abstraction to handle files
jjg
parents: 14357
diff changeset
    36
 *  deletion without notice.</b>
6f4c62de6985 8001664: refactor javadoc to use abstraction to handle files
jjg
parents: 14357
diff changeset
    37
 *
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    38
 */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    39
public class DocPaths {
40500
f293dbb81a53 8162353: javadoc should provide a way to disable use of frames
jjg
parents: 40229
diff changeset
    40
    /** The name of the file for all classes, without using frames, when --no-frames is specified. */
f293dbb81a53 8162353: javadoc should provide a way to disable use of frames
jjg
parents: 40229
diff changeset
    41
    public static final DocPath ALLCLASSES = DocPath.create("allclasses.html");
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    42
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    43
    /** The name of the file for all classes, using frames. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    44
    public static final DocPath ALLCLASSES_FRAME = DocPath.create("allclasses-frame.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    45
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    46
    /** The name of the file for all classes, without using frames. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    47
    public static final DocPath ALLCLASSES_NOFRAME = DocPath.create("allclasses-noframe.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    48
40500
f293dbb81a53 8162353: javadoc should provide a way to disable use of frames
jjg
parents: 40229
diff changeset
    49
    public static DocPath AllClasses(boolean frames) {
f293dbb81a53 8162353: javadoc should provide a way to disable use of frames
jjg
parents: 40229
diff changeset
    50
        return frames ? ALLCLASSES_NOFRAME : ALLCLASSES;
f293dbb81a53 8162353: javadoc should provide a way to disable use of frames
jjg
parents: 40229
diff changeset
    51
    }
f293dbb81a53 8162353: javadoc should provide a way to disable use of frames
jjg
parents: 40229
diff changeset
    52
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    53
    /** The name of the sub-directory for storing class usage info. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    54
    public static final DocPath CLASS_USE = DocPath.create("class-use");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    55
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    56
    /** The name of the file for constant values. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    57
    public static final DocPath CONSTANT_VALUES = DocPath.create("constant-values.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    58
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    59
    /** The name of the fie for deprecated elements. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    60
    public static final DocPath DEPRECATED_LIST = DocPath.create("deprecated-list.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    61
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    62
    /** The name of the subdirectory for user-provided additional documentation files. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    63
    public static final DocPath DOC_FILES = DocPath.create("doc-files");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    64
48295
c79d31ba84b9 8164407: Add module support for -link and -linkoffline javadoc option
bpatel
parents: 48029
diff changeset
    65
    /** The name of the file for the element list. */
c79d31ba84b9 8164407: Add module support for -link and -linkoffline javadoc option
bpatel
parents: 48029
diff changeset
    66
    public static final DocPath ELEMENT_LIST = DocPath.create("element-list");
c79d31ba84b9 8164407: Add module support for -link and -linkoffline javadoc option
bpatel
parents: 48029
diff changeset
    67
33920
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    68
    /** The name of the image file showing a magnifying glass on the search box. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    69
    public static final DocPath GLASS_IMG = DocPath.create("glass.png");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    70
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    71
    /** The name of the file for help info. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    72
    public static final DocPath HELP_DOC = DocPath.create("help-doc.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    73
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    74
    /** The name of the main index file. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    75
    public static final DocPath INDEX = DocPath.create("index.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    76
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    77
    /** The name of the single index file for all classes. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    78
    public static final DocPath INDEX_ALL = DocPath.create("index-all.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    79
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    80
    /** The name of the directory for the split index files. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    81
    public static final DocPath INDEX_FILES = DocPath.create("index-files");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    82
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    83
    /** Generate the name of one of the files in the split index. */
22163
3651128c74eb 8030244: Update langtools to use Diamond
briangoetz
parents: 15723
diff changeset
    84
    public static DocPath indexN(int n) {
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    85
        return DocPath.create("index-" + n + ".html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    86
    }
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
    87
14549
0599d73bf1da 8002304: Group methods by types in methods summary section
bpatel
parents: 14368
diff changeset
    88
    /** The name of the default javascript file. */
0599d73bf1da 8002304: Group methods by types in methods summary section
bpatel
parents: 14368
diff changeset
    89
    public static final DocPath JAVASCRIPT = DocPath.create("script.js");
0599d73bf1da 8002304: Group methods by types in methods summary section
bpatel
parents: 14368
diff changeset
    90
33920
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    91
    /** The name of the directory for the jQuery. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    92
    public static final DocPath JQUERY_FILES = DocPath.create("jquery");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    93
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    94
    /** The name of the default jQuery stylesheet file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    95
    public static final DocPath JQUERY_STYLESHEET_FILE = DocPath.create("jquery-ui.css");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    96
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    97
    /** The name of the default jQuery javascript file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    98
    public static final DocPath JQUERY_JS_1_10 = DocPath.create("jquery-1.10.2.js");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
    99
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   100
    /** The name of the default jQuery javascript file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   101
    public static final DocPath JQUERY_JS = DocPath.create("jquery-ui.js");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   102
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   103
    /** The name of the default jszip javascript file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   104
    public static final DocPath JSZIP = DocPath.create("jszip/dist/jszip.js");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   105
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   106
    /** The name of the default jszip javascript file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   107
    public static final DocPath JSZIP_MIN = DocPath.create("jszip/dist/jszip.min.js");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   108
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   109
    /** The name of the default jszip-utils javascript file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   110
    public static final DocPath JSZIPUTILS = DocPath.create("jszip-utils/dist/jszip-utils.js");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   111
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   112
    /** The name of the default jszip-utils javascript file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   113
    public static final DocPath JSZIPUTILS_MIN = DocPath.create("jszip-utils/dist/jszip-utils.min.js");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   114
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   115
    /** The name of the default jszip-utils javascript file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   116
    public static final DocPath JSZIPUTILS_IE = DocPath.create("jszip-utils/dist/jszip-utils-ie.js");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   117
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   118
    /** The name of the default jszip-utils javascript file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   119
    public static final DocPath JSZIPUTILS_IE_MIN = DocPath.create("jszip-utils/dist/jszip-utils-ie.min.js");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   120
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   121
    /** The name of the member search index file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   122
    public static final DocPath MEMBER_SEARCH_INDEX_JSON = DocPath.create("member-search-index.json");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   123
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   124
    /** The name of the member search index zip file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   125
    public static final DocPath MEMBER_SEARCH_INDEX_ZIP = DocPath.create("member-search-index.zip");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   126
43370
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   127
    /** The name of the member search index js file. */
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   128
    public static final DocPath MEMBER_SEARCH_INDEX_JS = DocPath.create("member-search-index.js");
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   129
40511
1b3c502e0bdc 8155995: Update javadoc to include module search
bpatel
parents: 40500
diff changeset
   130
    /** The name of the module search index file. */
1b3c502e0bdc 8155995: Update javadoc to include module search
bpatel
parents: 40500
diff changeset
   131
    public static final DocPath MODULE_SEARCH_INDEX_JSON = DocPath.create("module-search-index.json");
1b3c502e0bdc 8155995: Update javadoc to include module search
bpatel
parents: 40500
diff changeset
   132
43370
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   133
    /** The name of the module search index zip file. */
40511
1b3c502e0bdc 8155995: Update javadoc to include module search
bpatel
parents: 40500
diff changeset
   134
    public static final DocPath MODULE_SEARCH_INDEX_ZIP = DocPath.create("module-search-index.zip");
1b3c502e0bdc 8155995: Update javadoc to include module search
bpatel
parents: 40500
diff changeset
   135
43370
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   136
    /** The name of the module search index js file. */
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   137
    public static final DocPath MODULE_SEARCH_INDEX_JS = DocPath.create("module-search-index.js");
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   138
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   139
    /** The name of the file for the overview frame. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   140
    public static final DocPath OVERVIEW_FRAME = DocPath.create("overview-frame.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   141
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   142
    /** The name of the file for the overview summary. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   143
    public static final DocPath OVERVIEW_SUMMARY = DocPath.create("overview-summary.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   144
40500
f293dbb81a53 8162353: javadoc should provide a way to disable use of frames
jjg
parents: 40229
diff changeset
   145
    public static DocPath overviewSummary(boolean frames) {
f293dbb81a53 8162353: javadoc should provide a way to disable use of frames
jjg
parents: 40229
diff changeset
   146
        return frames ? OVERVIEW_SUMMARY : INDEX;
f293dbb81a53 8162353: javadoc should provide a way to disable use of frames
jjg
parents: 40229
diff changeset
   147
    }
f293dbb81a53 8162353: javadoc should provide a way to disable use of frames
jjg
parents: 40229
diff changeset
   148
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   149
    /** The name of the file for the overview tree. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   150
    public static final DocPath OVERVIEW_TREE = DocPath.create("overview-tree.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   151
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   152
    /** The name of the file for the package frame. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   153
    public static final DocPath PACKAGE_FRAME = DocPath.create("package-frame.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   154
48295
c79d31ba84b9 8164407: Add module support for -link and -linkoffline javadoc option
bpatel
parents: 48029
diff changeset
   155
    /** The name of the file for the package list. This is to support the legacy mode. */
33920
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   156
    public static final DocPath PACKAGE_LIST = DocPath.create("package-list");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   157
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   158
    /** The name of the package search index file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   159
    public static final DocPath PACKAGE_SEARCH_INDEX_JSON = DocPath.create("package-search-index.json");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   160
43370
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   161
    /** The name of the package search index zip file. */
33920
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   162
    public static final DocPath PACKAGE_SEARCH_INDEX_ZIP = DocPath.create("package-search-index.zip");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   163
43370
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   164
    /** The name of the package search index js file. */
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   165
    public static final DocPath PACKAGE_SEARCH_INDEX_JS = DocPath.create("package-search-index.js");
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   166
33920
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   167
    /** The name of the file for the package summary. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   168
    public static final DocPath PACKAGE_SUMMARY = DocPath.create("package-summary.html");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   169
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   170
    /** The name of the file for the package tree. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   171
    public static final DocPath PACKAGE_TREE = DocPath.create("package-tree.html");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   172
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   173
    /** The name of the file for the package usage info. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   174
    public static final DocPath PACKAGE_USE = DocPath.create("package-use.html");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   175
48029
e9dab2492924 8185985: Html files in doc-files directories should be wrapped with standard header and footer
ksrini
parents: 47216
diff changeset
   176
    /** The name of the output directory for module documentation files. */
e9dab2492924 8185985: Html files in doc-files directories should be wrapped with standard header and footer
ksrini
parents: 47216
diff changeset
   177
    public static DocPath moduleDocFiles(ModuleElement mdle) {
e9dab2492924 8185985: Html files in doc-files directories should be wrapped with standard header and footer
ksrini
parents: 47216
diff changeset
   178
        return DocPath.create(mdle.getQualifiedName() + "-doc-files");
e9dab2492924 8185985: Html files in doc-files directories should be wrapped with standard header and footer
ksrini
parents: 47216
diff changeset
   179
    }
e9dab2492924 8185985: Html files in doc-files directories should be wrapped with standard header and footer
ksrini
parents: 47216
diff changeset
   180
36526
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   181
    /** The name of the file for the module frame. */
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   182
    public static DocPath moduleFrame(ModuleElement mdle) {
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   183
        return DocPath.create(mdle.getQualifiedName() + "-frame.html");
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   184
    }
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   185
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   186
    /** The name of the file for the module summary. */
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   187
    public static DocPath moduleSummary(ModuleElement mdle) {
48295
c79d31ba84b9 8164407: Add module support for -link and -linkoffline javadoc option
bpatel
parents: 48029
diff changeset
   188
        return DocPaths.moduleSummary(mdle.getQualifiedName().toString());
c79d31ba84b9 8164407: Add module support for -link and -linkoffline javadoc option
bpatel
parents: 48029
diff changeset
   189
    }
c79d31ba84b9 8164407: Add module support for -link and -linkoffline javadoc option
bpatel
parents: 48029
diff changeset
   190
c79d31ba84b9 8164407: Add module support for -link and -linkoffline javadoc option
bpatel
parents: 48029
diff changeset
   191
    /** The name of the file for the module summary. */
c79d31ba84b9 8164407: Add module support for -link and -linkoffline javadoc option
bpatel
parents: 48029
diff changeset
   192
    public static DocPath moduleSummary(String mdleName) {
c79d31ba84b9 8164407: Add module support for -link and -linkoffline javadoc option
bpatel
parents: 48029
diff changeset
   193
        return DocPath.create(mdleName + "-summary.html");
36526
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   194
    }
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   195
40229
09f4478d07e5 8154817: Fix the click-through navigation for modules
bpatel
parents: 36526
diff changeset
   196
    /** The name of the file for the module frame. */
09f4478d07e5 8154817: Fix the click-through navigation for modules
bpatel
parents: 36526
diff changeset
   197
    public static DocPath moduleTypeFrame(ModuleElement mdle) {
09f4478d07e5 8154817: Fix the click-through navigation for modules
bpatel
parents: 36526
diff changeset
   198
        return DocPath.create(mdle.getQualifiedName() + "-type-frame.html");
09f4478d07e5 8154817: Fix the click-through navigation for modules
bpatel
parents: 36526
diff changeset
   199
    }
09f4478d07e5 8154817: Fix the click-through navigation for modules
bpatel
parents: 36526
diff changeset
   200
36526
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   201
    /** The name of the file for the module overview frame. */
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   202
    public static final DocPath MODULE_OVERVIEW_FRAME = DocPath.create("module-overview-frame.html");
3b41f1c69604 8142968: Module System implementation
alanb
parents: 35426
diff changeset
   203
22447
364fe5d83775 8016549: jdk7 javadocs are hard to read
bpatel
parents: 15723
diff changeset
   204
    /** The name of the sub-package from which resources are read. */
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   205
    public static final DocPath RESOURCES = DocPath.create("resources");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   206
33920
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   207
    /** The name of the search javascript file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   208
    public static final DocPath SEARCH_JS = DocPath.create("search.js");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   209
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   210
    /** The name of the file for the serialized form info. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   211
    public static final DocPath SERIALIZED_FORM = DocPath.create("serialized-form.html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   212
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   213
    /** The name of the directory in which HTML versions of the source code
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   214
     *  are generated.
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   215
     */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   216
    public static final DocPath SOURCE_OUTPUT = DocPath.create("src-html");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   217
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   218
    /** The name of the default stylesheet. */
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   219
    public static final DocPath STYLESHEET = DocPath.create("stylesheet.css");
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   220
33920
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   221
    /** The name of the tag search index file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   222
    public static final DocPath TAG_SEARCH_INDEX_JSON = DocPath.create("tag-search-index.json");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   223
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   224
    /** The name of the tag search index zip file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   225
    public static final DocPath TAG_SEARCH_INDEX_ZIP = DocPath.create("tag-search-index.zip");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   226
43370
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   227
    /** The name of the tag search index js file. */
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   228
    public static final DocPath TAG_SEARCH_INDEX_JS = DocPath.create("tag-search-index.js");
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   229
33920
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   230
    /** The name of the type search index file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   231
    public static final DocPath TYPE_SEARCH_INDEX_JSON = DocPath.create("type-search-index.json");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   232
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   233
    /** The name of the type search index zip file. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   234
    public static final DocPath TYPE_SEARCH_INDEX_ZIP = DocPath.create("type-search-index.zip");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   235
43370
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   236
    /** The name of the type search index js file. */
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   237
    public static final DocPath TYPE_SEARCH_INDEX_JS = DocPath.create("type-search-index.js");
5969237f927c 8166175: javadoc search doesn't work on local doc bundles
bpatel
parents: 40511
diff changeset
   238
33920
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   239
    /** The name of the image file for undo button on the search box. */
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   240
    public static final DocPath X_IMG = DocPath.create("x.png");
bd731341c405 8141492: Implement search feature in javadoc
bpatel
parents: 25874
diff changeset
   241
14357
faf9cde2817b 8000741: refactor javadoc to use abstraction to handle relative paths
jjg
parents:
diff changeset
   242
}