Skip to content

Commit 42806c0

Browse files
committed
Fix error in javadoc with java 1.8
1 parent 4ec8a02 commit 42806c0

104 files changed

Lines changed: 822 additions & 481 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎AndroidAnnotations/androidannotations-api/pom.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
<dependency>
2222
<groupId>com.google.android</groupId>
2323
<artifactId>android</artifactId>
24-
<version>1.6_r2</version>
24+
<version>4.1.1.4</version>
2525
<scope>provided</scope>
2626
</dependency>
2727
<dependency>

‎AndroidAnnotations/androidannotations-api/src/main/java/org/androidannotations/annotations/AfterInject.java‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,15 +21,18 @@
2121
import java.lang.annotation.Target;
2222

2323
/**
24+
* <p>
2425
* Methods annotated with @{@link AfterInject} will be called after the
2526
* constructor is called in an enhanced class. Any code depending on injected
2627
* fields should be done in an {@link AfterInject} annotated method.
27-
* <p/>
28+
* </p>
29+
* <p>
2830
* The method MUST have zero parameters.
29-
* <p/>
31+
* </p>
32+
* <p>
3033
* There MAY be several methods annotated with @{@link AfterInject} in the same
3134
* class.
32-
* <p/>
35+
* </p>
3336
* <blockquote>
3437
*
3538
* Example :

‎AndroidAnnotations/androidannotations-api/src/main/java/org/androidannotations/annotations/AfterTextChange.java‎

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -15,29 +15,32 @@
1515
*/
1616
package org.androidannotations.annotations;
1717

18+
import android.text.Editable;
19+
1820
import java.lang.annotation.ElementType;
1921
import java.lang.annotation.Retention;
2022
import java.lang.annotation.RetentionPolicy;
2123
import java.lang.annotation.Target;
2224

23-
import android.text.Editable;
24-
2525
/**
26+
* <p>
2627
* This annotation is intended to be used on methods to receive events defined
2728
* by {@link android.text.TextWatcher#afterTextChanged(Editable s)} after the
2829
* text is changed on the targeted TextView or subclass of TextView.
29-
* <p/>
30+
* </p>
31+
* <p>
3032
* The annotation value should be one or several R.id.* fields that refers to
3133
* TextView or subclasses of TextView. If not set, the method name will be used
3234
* as the R.id.* field name.
33-
* <p/>
35+
* </p>
36+
* <p>
3437
* The method MAY have multiple parameter:
38+
* </p>
3539
* <ul>
3640
* <li>A {@link android.widget.TextView} parameter to know which view has
37-
* targeted this event
38-
* <li>An {@link android.text.Editable} to make changes on modified text.
41+
* targeted this event</li>
42+
* <li>An {@link android.text.Editable} to make changes on modified text.</li>
3943
* </ul>
40-
* <p/>
4144
* <blockquote>
4245
*
4346
* Example :

‎AndroidAnnotations/androidannotations-api/src/main/java/org/androidannotations/annotations/AfterViews.java‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,26 +15,30 @@
1515
*/
1616
package org.androidannotations.annotations;
1717

18+
import android.app.Activity;
19+
1820
import java.lang.annotation.ElementType;
1921
import java.lang.annotation.Retention;
2022
import java.lang.annotation.RetentionPolicy;
2123
import java.lang.annotation.Target;
2224

23-
import android.app.Activity;
24-
2525
/**
26+
* <p>
2627
* Methods annotated with @{@link AfterViews} will be called after
2728
* {@link Activity#setContentView(int)} is called by the generated activity.
28-
* <p/>
29+
* </p>
30+
* <p>
2931
* This occurs AFTER <code>setContentView(View)</code> which is called at the
3032
* end of super.onCreate(). Any view depending code should be done in an
3133
* {@link AfterViews} annotated method.
32-
* <p/>
34+
* </p>
35+
* <p>
3336
* The method MUST have zero parameters.
34-
* <p/>
37+
* </p>
38+
* <p>
3539
* There MAY be several methods annotated with @{@link AfterViews} in the same
3640
* activity.
37-
* <p/>
41+
* </p>
3842
* <blockquote>
3943
*
4044
* Example :

‎AndroidAnnotations/androidannotations-api/src/main/java/org/androidannotations/annotations/App.java‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,11 +21,13 @@
2121
import java.lang.annotation.Target;
2222

2323
/**
24+
* <p>
2425
* Injects an {@link EApplication} annotated class in an enhanced class.
25-
* <p/>
26+
* </p>
27+
* <p>
2628
* Please check that your registered the application in the AndroidManifest.xml
2729
* class prior to using this annotation.
28-
* <p/>
30+
* </p>
2931
* <blockquote>
3032
*
3133
* Example :

‎AndroidAnnotations/androidannotations-api/src/main/java/org/androidannotations/annotations/Background.java‎

Lines changed: 30 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -23,19 +23,23 @@
2323
import java.util.concurrent.ScheduledThreadPoolExecutor;
2424

2525
/**
26+
* <p>
2627
* Should be used on method that must be run in a background thread.
27-
* <p/>
28+
* </p>
29+
* <p>
2830
* The annotated method MUST return void and MAY contain parameters.
29-
* <p/>
30-
* The generated code is based on {@link BackgroundExecutor} methods.
31-
*
31+
* </p>
32+
* <p>
33+
* The generated code is based on {@link org.androidannotations.api.BackgroundExecutor} methods.
34+
* </p>
3235
*
3336
* <h2>Cancellation</h2>
37+
* <p>
3438
* Since 3.0, you're able to cancel a background task by calling
3539
* <code>BackgroundExecutor.cancelAll("id")</code> where "id" matches the
3640
* {@link #id()} value.
3741
*
38-
* <p/>
42+
* </p>
3943
* <blockquote>
4044
*
4145
* <b>Example</b> :
@@ -58,28 +62,31 @@
5862
* </pre>
5963
*
6064
* </blockquote>
61-
* <p/>
65+
* <p>
6266
* <b>Note</b>: Cancellation may or may not be successful. If the task wasn't
6367
* executed yet, it will be removed from the pool. But it could fail if task has
6468
* already completed, has already been cancelled, or could not be cancelled for
6569
* some other reason. See {@link Future#cancel(boolean)} for more information.
66-
*
70+
* </p>
6771
*
6872
* <h2>Execution flow</h2>
73+
* <p>
6974
* By default, all tasks will be put in a {@link ScheduledThreadPoolExecutor}
7075
* with a core pool size of <code>2 * numberOfCpu</code>. Which means that
7176
* background methods will be executed in <b>PARALLEL</b>. You can change this
7277
* by calling <code>BackgroundExecutor.setExecutor(...)</code>.
73-
*
78+
* </p>
79+
* <p>
7480
* If you want execute ALL background methods SEQUENTIALLY, the best way is to
75-
* change the executor of {@link BackgroundExecutor} to a
81+
* change the executor of {@link org.androidannotations.api.BackgroundExecutor} to a
7682
* {@link ScheduledThreadPoolExecutor} with a core pool size of <code>1</code>.
77-
* <p/>
83+
* </p>
84+
* <p>
7885
* If you want execute some background methods SEQUENTIALLY, you should simply
7986
* use {@link #serial()} field. All task with the same serial key will be
8087
* executed sequentially.
81-
*
82-
* <p/>
88+
* </p>
89+
*
8390
* <blockquote>
8491
*
8592
* <b>Example 1</b> (all tasks executed sequentially) :
@@ -132,11 +139,13 @@
132139
*
133140
*
134141
* <h2>Delay</h2>
142+
* <p>
135143
* Sometimes you may want to delay execution of a background method. To do so,
136144
* you should use the {@link #delay()} field.
137-
* <p/>
145+
* </p>
138146
* <b>Example</b> :
139-
*
147+
*
148+
* <blockquote>
140149
* <pre>
141150
* &#064;EBean
142151
* public class MyBean {
@@ -152,7 +161,7 @@
152161
*
153162
*
154163
* @see UiThread
155-
* @see BackgroundExecutor
164+
* @see org.androidannotations.api.BackgroundExecutor
156165
*/
157166
@Retention(RetentionPolicy.CLASS)
158167
@Target(ElementType.METHOD)
@@ -166,11 +175,15 @@
166175
* boolean mayInterruptIfRunning = true;
167176
* BackgroundExecutor.cancelAll(&quot;my_background_id&quot;, mayInterruptIfRunning);
168177
* </pre>
178+
*
179+
* @return the identifier for task cancellation
169180
**/
170181
String id() default "";
171182

172183
/**
173184
* Minimum delay, in milliseconds, before the background task is executed.
185+
*
186+
* @return the minimum delay before execution
174187
*/
175188
int delay() default 0;
176189

@@ -179,6 +192,8 @@
179192
*
180193
* All background tasks having the same <code>serial</code> will be executed
181194
* sequentially.
195+
*
196+
* @return the serial execution group
182197
**/
183198
String serial() default "";
184199
}

‎AndroidAnnotations/androidannotations-api/src/main/java/org/androidannotations/annotations/Bean.java‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,11 +21,13 @@
2121
import java.lang.annotation.Target;
2222

2323
/**
24+
* <p>
2425
* Injects an {@link EBean} annotated class in an enhanced class.
25-
* <p/>
26+
* </p>
27+
* <p>
2628
* You can specify a specific implementation to inject using the value
2729
* attribute.
28-
* <p/>
30+
* </p>
2931
* <blockquote>
3032
*
3133
* Example :

‎AndroidAnnotations/androidannotations-api/src/main/java/org/androidannotations/annotations/BeforeTextChange.java‎

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,28 +21,32 @@
2121
import java.lang.annotation.Target;
2222

2323
/**
24+
* <p>
2425
* This annotation is intended to be used on methods to receive events defined
2526
* by
2627
* {@link android.text.TextWatcher#beforeTextChanged(CharSequence s, int start, int count, int after)}
2728
* before the text is changed on the targeted TextView or subclass of TextView.
28-
* <p/>
29+
* </p>
30+
* <p>
2931
* The annotation value should be one or several R.id.* fields that refers to
3032
* TextView or subclasses of TextView. If not set, the method name will be used
3133
* as the R.id.* field name.
32-
* <p/>
34+
* </p>
35+
* <p>
3336
* The method MAY have multiple parameters:
37+
* </p>
3438
* <ul>
3539
* <li>A {@link android.widget.TextView} parameter to know which view has
36-
* targeted this event
40+
* targeted this event</li>
3741
* <li>An {@link java.lang.CharSequence} parameter to get the text before
38-
* modification.
42+
* modification.</li>
3943
* <li>An int parameter named start to get the start position of the modified
40-
* text.
41-
* <li>An int parameter named count to know the number of modified characters.
44+
* text.</li>
45+
* <li>An int parameter named count to know the number of modified characters.</li>
4246
* <li>An int parameter named after to know the text length after the text
43-
* modification.
47+
* modification.</li>
4448
* </ul>
45-
* <p/>
49+
*
4650
* <blockquote>
4751
*
4852
* Example :

‎AndroidAnnotations/androidannotations-api/src/main/java/org/androidannotations/annotations/CheckedChange.java‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -21,23 +21,26 @@
2121
import java.lang.annotation.Target;
2222

2323
/**
24+
* <p>
2425
* This annotation is intended to be used on methods to receive events defined
2526
* by
2627
* {@link android.widget.CompoundButton.OnCheckedChangeListener#onCheckedChanged(android.widget.CompoundButton, boolean)}
2728
* after the checked state is changed on the targeted CompoundButton or subclass
2829
* of CompoundButton.
29-
* <p/>
30+
* </p>
31+
* <p>
3032
* The annotation value should be one or several R.id.* fields that refers to
3133
* CompoundButton or subclasses of CompoundButton. If not set, the method name
3234
* will be used as the R.id.* field name.
33-
* <p/>
35+
* </p>
36+
* <p>
3437
* The method MAY have multiple parameter:
38+
* </p>
3539
* <ul>
3640
* <li>A {@link android.widget.CompoundButton} parameter to know which view has
37-
* targeted this event
38-
* <li>An {@link boolean} to know the new state of the view.
41+
* targeted this event</li>
42+
* <li>An {@link boolean} to know the new state of the view.</li>
3943
* </ul>
40-
* <p/>
4144
* <blockquote>
4245
*
4346
* Example :

‎AndroidAnnotations/androidannotations-api/src/main/java/org/androidannotations/annotations/Click.java‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,18 +21,21 @@
2121
import java.lang.annotation.Target;
2222

2323
/**
24+
* <p>
2425
* This annotation is intended to be used on methods to receive events defined
2526
* by {@link android.view.View.OnClickListener#onClick(android.view.View)} when
2627
* the view has been clicked by the user.
27-
* <p/>
28+
* </p>
29+
* <p>
2830
* The annotation value should be one or several of R.id.* fields. If not set,
2931
* the method name will be used as the R.id.* field name.
30-
* <p/>
32+
* </p>
33+
* <p>
3134
* The method MAY have one parameter:
35+
* </p>
3236
* <ul>
33-
* <li>A {@link android.view.View} parameter to know which view has been clicked
37+
* <li>A {@link android.view.View} parameter to know which view has been clicked</li>
3438
* </ul>
35-
* <p/>
3639
* <blockquote>
3740
*
3841
* Example :

0 commit comments

Comments
 (0)