Skip to content

Commit

Permalink
Remove blank Javadoc
Browse files Browse the repository at this point in the history
This commit cleans up Javadoc that does not add information.
It resolves ecj warnings:
 `Javadoc: Description expected after ...`
It helps to prevent future empty javadoc by disabling
missingJavaDoc warnings. This resolves
 `Javadoc: Missing ...`

The modification is a result of regular expression search&replace:

in files `*.java`
 `^[\s]*\*[\s]*(@return|@param[\s]*[^\s]+|@throws[\s]*[^\s]+)\R([\s]*\*[\s]*@|[\s]*\*/\R)`
 ->`$2`
 `^([\s]*\*[\s]*\R)([\s]*\*/\R)`
 ->`$2`
 `^[\S\t ]*/\*\*\R[\s]*\*/\R`
 ->``

in files `org.eclipse.jdt.core.prefs`
 `org\.eclipse\.jdt\.core\.compiler\.problem\.missingJavadoc(Comments|Tags)\=[^\s]*`
 ->`org\.eclipse\.jdt\.core\.compiler\.problem\.missingJavadoc$1\=ignore`
  • Loading branch information
EcljpseB0T committed Dec 4, 2023
1 parent c345382 commit 52ba405
Show file tree
Hide file tree
Showing 520 changed files with 2 additions and 2,182 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,6 @@ public class TryVirtualThread implements Runnable {

/**
* Runs the test program
* @param args
*/
public static void main(java.lang.String[] args) {
// Ensure at least one carrier thread is created.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -688,7 +688,6 @@ private void launchCommandLineTarget() {
* Parse the command {@link String} to make sure we use
* {@link Runtime#exec(String[])}.
*
* @param command
* @return the array of items from the command {@link String}
* @since 4.3
*/
Expand Down Expand Up @@ -843,7 +842,6 @@ private void injectVMArgs(Vector<String> commandLine) {
* Flattens the variable size command line and calls Runtime.exec().
* @param commandLine A vector of command line argument strings.
* @return The Process created by Runtime.exec()
* @throws IOException
*/
private Process exec(Vector<String> commandLine) throws IOException {
String[] vmString = new String[commandLine.size()];
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,6 @@ abstract public class AbstractReader {

/**
* Constructor
* @param name
*/
public AbstractReader(String name) {
fName = name;
Expand All @@ -35,7 +34,6 @@ public AbstractReader(String name) {
abstract protected void readerLoop();
/**
* Start the thread that reads events.
*
*/
public void start() {
fReaderThread = new Thread(new Runnable() {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new AccessibleTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new ArrayReferenceTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new ArrayTypeTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,6 @@

import junit.framework.TestSuite;

/**
*/
public class AutomatedSuite extends TestSuite {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new BooleanValueTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,6 @@ public void localTearDown() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new BreakpointRequestTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new ByteValueTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new CharValueTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new ClassLoaderReferenceTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,6 @@ public void localTearDown() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new ClassPrepareEventTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,6 @@ public class ClassPrepareEventWaiter extends EventWaiter {

/**
* Constructor
* @param request
* @param shouldGo
* @param className
*/
public ClassPrepareEventWaiter(EventRequest request, boolean shouldGo, String className) {
super(request, shouldGo);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(String[] args) {
new ClassPrepareRequestTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new ClassTypeTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new ClassesByNameTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new DoubleValueTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,89 +36,76 @@ public interface EventListener {
/**
* Handles an access watchpoint event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean accessWatchpoint(AccessWatchpointEvent event);
/**
* Handles a breakpoint event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean breakpoint(BreakpointEvent event);
/**
* Handles a class prepare event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean classPrepare(ClassPrepareEvent event);
/**
* Handles a class unload event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean classUnload(ClassUnloadEvent event);
/**
* Handles an exception event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean exception(ExceptionEvent event);
/**
* Handles a method entry event
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean methodEntry(MethodEntryEvent event);
/**
* Handles a method exit event
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean methodExit(MethodExitEvent event);
/**
* Handles a modification watchpoint event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean modificationWatchpoint(ModificationWatchpointEvent event);
/**
* Handles a step event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean step(StepEvent event);
/**
* Handles a thread death event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean threadDeath(ThreadDeathEvent event);
/**
* Handles a thread start event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean threadStart(ThreadStartEvent event);
/**
* Handles a vm death event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean vmDeath(VMDeathEvent event);
/**
* Handles a vm disconnect event.
* Returns whether the VM should be resumed if it was interrupted.
* @param event
* @return whether the VM should be resumed if it was interrupted.
*/
public boolean vmDisconnect(VMDisconnectEvent event);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,16 +47,13 @@ public class EventReader extends AbstractReader {

/**
* Constructor
* @param name
* @param queue
*/
public EventReader(String name, EventQueue queue) {
super(name);
fEventQueue = queue;
}
/**
* Registers the given event listener.
* @param listener
*/
public synchronized void addEventListener(EventListener listener) {
fEventListeners.addElement(listener);
Expand Down Expand Up @@ -141,7 +138,6 @@ protected void readerLoop() {
}
/**
* De-registers the given event listener.
* @param listener
*/
public synchronized void removeEventListener(EventListener listener) {
fEventListeners.removeElement(listener);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new EventRequestManagerTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,6 @@ public void localTearDown() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new EventRequestTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,6 @@ public void localTearDown() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new EventTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,6 @@ public class EventWaiter implements EventListener {
/**
* Creates a new EventWaiter for the given request. Sets whether it
* should let the VM go after it got the event.
* @param request
* @param shouldGo
*/
public EventWaiter(EventRequest request, boolean shouldGo) {
fRequest = request;
Expand Down Expand Up @@ -159,7 +157,6 @@ public boolean vmDisconnect(VMDisconnectEvent event) {
/**
* Waits for the first event corresponding to this waiter's request.
* @return if the vm should be restarted
* @throws InterruptedException
*/
synchronized public Event waitEvent() throws InterruptedException {
if (fEvent == null) {
Expand All @@ -172,9 +169,7 @@ synchronized public Event waitEvent() throws InterruptedException {
/**
* Waits for the first event corresponding to this waiter's request
* for the given time (in ms). If it times out, return null.
* @param time
* @return if the vm should be restarted or not
* @throws InterruptedException
*/
synchronized public Event waitEvent(long time)
throws InterruptedException {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,6 @@ public void localTearDown() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new ExceptionEventTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,6 @@ public void localTearDown() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new ExceptionRequestTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new FieldTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,6 @@ public class FileConsoleReader extends AbstractReader {
private FileOutputStream fFileOutputStream;
/**
* Creates a new console reader that will read from the given input stream.
* @param name
* @param fileName
* @param input
*/
public FileConsoleReader(String name, String fileName, InputStream input) {
super(name);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new FloatValueTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ public void testForceEarlyReturnIntType() {
if(tref.isSuspended()) {
if(tref.isAtBreakpoint()) {
method = getMethod("printNumber", "(Ljava/io/OutputStream;I)I");
br = getBreakpointRequest(method.locationsOfLine(207).get(0));
br = getBreakpointRequest(method.locationsOfLine(196).get(0));
br.setSuspendPolicy(EventRequest.SUSPEND_EVENT_THREAD);
br.enable();
waiter = new EventWaiter(br, true);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(String[] args) {
new HotCodeReplacementTest().runSuite(args);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ public void localSetUp() {
}
/**
* Run all tests and output to standard output.
* @param args
*/
public static void main(java.lang.String[] args) {
new IntegerValueTest().runSuite(args);
Expand Down
Loading

0 comments on commit 52ba405

Please sign in to comment.