Skip to content

Commit 9e0e4f5

Browse files
zbynekzbynek
committed
More JavaDoc fixes
1 parent fb0b0a8 commit 9e0e4f5

16 files changed

Lines changed: 23 additions & 131 deletions

File tree

‎dev/core/src/com/google/gwt/core/ext/typeinfo/JGenericType.java‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,8 +24,8 @@ public interface JGenericType extends JRealClassType, HasTypeParameters {
2424

2525
/**
2626
* Returns the raw type for this generic type. The raw type removes all 'generics' information
27-
* from the class. i.e. {@code void a1(List<T>)} & {@code void a2(List<String>)} becomes
28-
* {@code void a1(List)} & {@code void a2(List))} respectively.
27+
* from the class. i.e. {@code void a1(List<T>)} and {@code void a2(List<String>)} becomes
28+
* {@code void a1(List)} and {@code void a2(List))} respectively.
2929
*/
3030
JRawType getRawType();
3131
}

‎dev/core/src/com/google/gwt/dev/ModulePanel.java‎

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -64,9 +64,6 @@ public void actionPerformed(ActionEvent e) {
6464
session.addModule(moduleName, this);
6565
}
6666

67-
/* (non-Javadoc)
68-
* @see com.google.gwt.dev.Disconnectable#disconnect()
69-
*/
7067
@Override
7168
public void disconnect() {
7269
setDisconnected();
@@ -76,9 +73,6 @@ public TreeLogger getLogger() {
7673
return loggerPanel.getLogger();
7774
}
7875

79-
/* (non-Javadoc)
80-
* @see com.google.gwt.dev.Disconnectable#isDisconnected()
81-
*/
8276
@Override
8377
public boolean isDisconnected() {
8478
return disconnected;

‎dev/core/src/com/google/gwt/dev/javac/AnnotationProxyFactory.java‎

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ class AnnotationProxyFactory {
3232
/**
3333
* {@link InvocationHandler} implementation used by all
3434
* {@link java.lang.annotation.Annotation Annotation} proxies created by the
35-
* {@link TypeOracle}.
35+
* {@link com.google.gwt.dev.javac.typemodel.TypeOracle}.
3636
*/
3737
private static class AnnotationProxyInvocationHandler implements
3838
InvocationHandler {
@@ -211,12 +211,6 @@ public int hashCode() {
211211
return sum;
212212
}
213213

214-
/*
215-
* (non-Javadoc)
216-
*
217-
* @see java.lang.reflect.InvocationHandler#invoke(java.lang.Object,
218-
* java.lang.reflect.Method, java.lang.Object[])
219-
*/
220214
@Override
221215
public Object invoke(Object proxy, Method method, Object[] args)
222216
throws Throwable {

‎user/build.xml‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -159,7 +159,8 @@
159159
<move file="${project.build}/no-servlet-src/com/google/gwt/user/server/Util.java" tofile="${project.build}/jakarta-src/com/google/gwt/user/server/jakarta/Util.java">
160160
<filterchain>
161161
<tokenfilter>
162-
<replacestring from="com.google.gwt.user.server" to="com.google.gwt.user.server.jakarta"/>
162+
<replacestring from="com.google.gwt.user.server.rpc" to="com.google.gwt.user.server.jakarta.rpc"/>
163+
<replacestring from="package com.google.gwt.user.server" to="package com.google.gwt.user.server.jakarta"/>
163164
<replacestring from="javax.servlet" to="jakarta.servlet"/>
164165
</tokenfilter>
165166
</filterchain>

‎user/src/com/google/gwt/i18n/client/Messages.java‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ public interface Messages extends LocalizableResource {
228228
* </pre>
229229
*
230230
* Note that the plural form "other" gets the translation specified in
231-
* {@code &#64;DefaultMessage}, as does any {@code &#64;Select} value not
231+
* {@code @DefaultMessage}, as does any {@code @Select} value not
232232
* listed.
233233
*
234234
* If more than one way of selecting a translation exists, they will be

‎user/src/com/google/gwt/i18n/client/TimeZone.java‎

Lines changed: 0 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -175,9 +175,6 @@ private static String offsetDisplay(int offset) {
175175
private TimeZone() {
176176
}
177177

178-
/* (non-Javadoc)
179-
* @see com.google.gwt.i18n.client.TimeZoneIntf#getDaylightAdjustment(java.util.Date)
180-
*/
181178
@Override
182179
public int getDaylightAdjustment(Date date) {
183180
if (transitionPoints == null) {
@@ -192,25 +189,16 @@ public int getDaylightAdjustment(Date date) {
192189
return (index == 0) ? 0 : adjustments[index - 1];
193190
}
194191

195-
/* (non-Javadoc)
196-
* @see com.google.gwt.i18n.client.TimeZoneIntf#getGMTString(java.util.Date)
197-
*/
198192
@Override
199193
public String getGMTString(Date date) {
200194
return composeGMTString(getOffset(date));
201195
}
202196

203-
/* (non-Javadoc)
204-
* @see com.google.gwt.i18n.client.TimeZoneIntf#getID()
205-
*/
206197
@Override
207198
public String getID() {
208199
return timezoneID;
209200
}
210201

211-
/* (non-Javadoc)
212-
* @see com.google.gwt.i18n.client.TimeZoneIntf#getISOTimeZoneString(java.util.Date)
213-
*/
214202
@Override
215203
public String getISOTimeZoneString(Date date) {
216204
int offset = -getOffset(date);
@@ -226,25 +214,16 @@ public String getISOTimeZoneString(Date date) {
226214
return new String(data);
227215
}
228216

229-
/* (non-Javadoc)
230-
* @see com.google.gwt.i18n.client.TimeZoneIntf#getLongName(java.util.Date)
231-
*/
232217
@Override
233218
public String getLongName(Date date) {
234219
return tzNames[isDaylightTime(date) ? DLT_LONG_NAME : STD_LONG_NAME];
235220
}
236221

237-
/* (non-Javadoc)
238-
* @see com.google.gwt.i18n.client.TimeZoneIntf#getOffset(java.util.Date)
239-
*/
240222
@Override
241223
public int getOffset(Date date) {
242224
return standardOffset - getDaylightAdjustment(date);
243225
}
244226

245-
/* (non-Javadoc)
246-
* @see com.google.gwt.i18n.client.TimeZoneIntf#getRFCTimeZoneString(java.util.Date)
247-
*/
248227
@Override
249228
public String getRFCTimeZoneString(Date date) {
250229
int offset = -getOffset(date);
@@ -260,25 +239,16 @@ public String getRFCTimeZoneString(Date date) {
260239
return new String(data);
261240
}
262241

263-
/* (non-Javadoc)
264-
* @see com.google.gwt.i18n.client.TimeZoneIntf#getShortName(java.util.Date)
265-
*/
266242
@Override
267243
public String getShortName(Date date) {
268244
return tzNames[isDaylightTime(date) ? DLT_SHORT_NAME : STD_SHORT_NAME];
269245
}
270246

271-
/* (non-Javadoc)
272-
* @see com.google.gwt.i18n.client.TimeZoneIntf#getStandardOffset()
273-
*/
274247
@Override
275248
public int getStandardOffset() {
276249
return standardOffset;
277250
}
278251

279-
/* (non-Javadoc)
280-
* @see com.google.gwt.i18n.client.TimeZoneIntf#isDaylightTime(java.util.Date)
281-
*/
282252
@Override
283253
public boolean isDaylightTime(Date date) {
284254
return getDaylightAdjustment(date) > 0;

‎user/src/com/google/gwt/i18n/rebind/format/PropertiesFormat.java‎

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -41,12 +41,6 @@ public String getExtension() {
4141
return ".properties";
4242
}
4343

44-
/*
45-
* (non-Javadoc)
46-
*
47-
* @see com.google.gwt.i18n.rebind.format.MessageCatalogFormat#write(com.google.gwt.i18n.rebind.util.AbstractResource,
48-
* java.io.File, com.google.gwt.core.ext.typeinfo.JClassType)
49-
*/
5044
@Override
5145
public void write(TreeLogger logger, String locale,
5246
ResourceList resourceList, PrintWriter out, JClassType messageInterface) {

‎user/src/com/google/gwt/resources/gss/ImageSpriteCreator.java‎

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -53,25 +53,27 @@
5353
* Visitor that detects sprite definitions and replace them by several css rules in order to create
5454
* the corresponding sprited image.
5555
* <p>This visitor will replace the following gss:
56+
* <pre>
5657
* {@code
5758
* .foo {
5859
* padding: 5px;
5960
* gwt-sprite: imageResource;
6061
* width: 150px;
6162
* }
6263
* }
64+
* </pre>
6365
* to the corresponding gss:
64-
* {@code
65-
* .foo {
66-
* padding: 5px;
67-
* /* @alternate &#42;/ width: eval("imageResource.getWidth", "px");
68-
* /* @alternate &#42;/ height: eval("imageResource.getHeight", "px");
69-
* /* @alternate &#42;/ overflow: hidden;
70-
* /* @alternate &#42;/ background: resourceUrl("imageResource") eval("imageResource.getLeft",
71-
* "px") eval("imageResource.getTop", "px") no-repeat;
72-
* width: 150px;
73-
* }
66+
* <pre><code>
67+
* .foo {
68+
* padding: 5px;
69+
* /* @alternate {@literal *}/ width: eval("imageResource.getWidth", "px");
70+
* /* @alternate {@literal *}/ height: eval("imageResource.getHeight", "px");
71+
* /* @alternate {@literal *}/ overflow: hidden;
72+
* /* @alternate {@literal *}/ background: resourceUrl("imageResource") eval("imageResource.getLeft",
73+
* "px") eval("imageResource.getTop", "px") no-repeat;
74+
* width: 150px;
7475
* }
76+
* </code></pre>
7577
* <p>This visitor will also check the presence of the {@link ImageOptions} annotation on the
7678
* image resource in order to support correctly horizontal or vertical repetition.
7779
*/

‎user/src/com/google/gwt/safecss/shared/SafeStylesString.java‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@
2020
*
2121
* <p>
2222
* This class is package-private and intended for internal use by the
23-
* {@link com.google.gwt.safecss} package.
23+
* {@link com.google.gwt.safecss.shared} package.
2424
*
2525
* <p>
2626
* All implementors must implement .equals and .hashCode so that they operate

‎user/src/com/google/gwt/safehtml/shared/SafeHtmlString.java‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@
2323
*
2424
* <p>
2525
* This class is package-private and intended for internal use by the
26-
* {@link com.google.gwt.safehtml} package.
26+
* {@link com.google.gwt.safehtml.shared} package.
2727
*
2828
* <p>
2929
* All implementors must implement .equals and .hashCode so that they operate

0 commit comments

Comments
 (0)