1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
package org.checkerframework.javacutil.dist;
import com.sun.javadoc.Tag;
import com.sun.tools.doclets.Taglet;
import java.util.Map;
/**
* A taglet for processing the {@code @checker_framework.manual} javadoc block tag, which inserts
* references to the Checker Framework manual into javadoc.
*
* <p>The {@code @checker_framework.manual} tag is used as follows:
*
* <ul>
* <li>{@code @checker_framework.manual #} expands to a top-level link to the Checker Framework
* manual
* <li>{@code @checker_framework.manual #anchor text} expands to a link with some text to a
* particular part of the manual
* </ul>
*/
public class ManualTaglet implements Taglet {
@Override
public String getName() {
return "checker_framework.manual";
}
@Override
public boolean inConstructor() {
return true;
}
@Override
public boolean inField() {
return true;
}
@Override
public boolean inMethod() {
return true;
}
@Override
public boolean inOverview() {
return true;
}
@Override
public boolean inPackage() {
return true;
}
@Override
public boolean inType() {
return true;
}
@Override
public boolean isInlineTag() {
return false;
}
/**
* Formats a link, given an array of tokens.
*
* @param parts the array of tokens
* @return a link to the manual top-level if the array size is one, or a link to a part of the
* manual if it's larger than one
*/
private String formatLink(String[] parts) {
String anchor, text;
if (parts.length < 2) {
anchor = "";
text = "Checker Framework";
} else {
anchor = parts[0];
text = parts[1];
}
return String.format(
"<A HREF=\"https://checkerframework.org/manual/%s\">%s</A>", anchor, text);
}
/**
* Formats the {@code @checker_framework.manual} tag, prepending the tag header to the tag
* content.
*
* @param text the tag content
* @return the formatted tag
*/
private String formatHeader(String text) {
return String.format("<DT><B>See the Checker Framework Manual:</B><DD>%s<BR>", text);
}
@Override
public String toString(Tag tag) {
String[] split = tag.text().split(" ", 2);
return formatHeader(formatLink(split));
}
@Override
public String toString(Tag[] tags) {
if (tags.length == 0) {
return "";
}
StringBuilder sb = new StringBuilder();
for (Tag t : tags) {
String[] split = t.text().split(" ", 2);
if (t != tags[0]) {
sb.append(", ");
}
sb.append(formatLink(split));
}
return formatHeader(sb.toString());
}
@SuppressWarnings({"unchecked", "rawtypes"})
public static void register(Map tagletMap) {
ManualTaglet tag = new ManualTaglet();
Taglet t = (Taglet) tagletMap.get(tag.getName());
if (t != null) {
tagletMap.remove(tag.getName());
}
tagletMap.put(tag.getName(), tag);
}
}
|