diff options
| author | Marc R. Hoffmann <hoffmann@mountainminds.com> | 2019-10-10 23:35:02 +0200 |
|---|---|---|
| committer | Evgeny Mandrikov <138671+Godin@users.noreply.github.com> | 2019-10-10 23:35:02 +0200 |
| commit | 71479220fc163c7d7c782ee9427d9cb3353f09ec (patch) | |
| tree | b0e876adfbf4d8ca13433ec54e58914e21d3d272 /org.jacoco.core/src/org | |
| parent | a90c4989a4feece9fa1b9101c08eb226b77d3030 (diff) | |
| download | jacoco-71479220fc163c7d7c782ee9427d9cb3353f09ec.tar.gz | |
Remove trailing whitespaces in Java source files (#959)
Diffstat (limited to 'org.jacoco.core/src/org')
97 files changed, 413 insertions, 413 deletions
diff --git a/org.jacoco.core/src/org/jacoco/core/JaCoCo.java b/org.jacoco.core/src/org/jacoco/core/JaCoCo.java index b3af4d37..fbb2c74d 100644 --- a/org.jacoco.core/src/org/jacoco/core/JaCoCo.java +++ b/org.jacoco.core/src/org/jacoco/core/JaCoCo.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core; diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/Analyzer.java b/org.jacoco.core/src/org/jacoco/core/analysis/Analyzer.java index 62c19e86..3d6e1d00 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/Analyzer.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/Analyzer.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -54,7 +54,7 @@ public class Analyzer { /** * Creates a new analyzer reporting to the given output. - * + * * @param executionData * execution data * @param coverageVisitor @@ -70,7 +70,7 @@ public class Analyzer { /** * Creates an ASM class visitor for analysis. - * + * * @param classid * id of the class calculated with {@link CRC64} * @param className @@ -118,7 +118,7 @@ public class Analyzer { /** * Analyzes the class definition from a given in-memory buffer. - * + * * @param buffer * class definitions * @param location @@ -138,7 +138,7 @@ public class Analyzer { /** * Analyzes the class definition from a given input stream. The provided * {@link InputStream} is not closed by this method. - * + * * @param input * stream to read class definition from * @param location @@ -171,7 +171,7 @@ public class Analyzer { * archive or a gzip stream that is searched recursively for class files. * All other content types are ignored. The provided {@link InputStream} is * not closed by this method. - * + * * @param input * input data * @param location @@ -207,7 +207,7 @@ public class Analyzer { * Analyzes all class files contained in the given file or folder. Class * files as well as ZIP files are considered. Folders are searched * recursively. - * + * * @param file * file or folder to look for class files * @return number of class files found @@ -234,7 +234,7 @@ public class Analyzer { /** * Analyzes all classes from the given class path. Directories containing * class files as well as archive files are considered. - * + * * @param path * path definition * @param basedir diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/CounterComparator.java b/org.jacoco.core/src/org/jacoco/core/analysis/CounterComparator.java index fc1d0437..608b3016 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/CounterComparator.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/CounterComparator.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -75,7 +75,7 @@ public class CounterComparator implements Comparator<ICounter>, Serializable { /** * Creates a new version of this comparator that sorts in reverse order. - * + * * @return reverse comparator */ public CounterComparator reverse() { @@ -85,7 +85,7 @@ public class CounterComparator implements Comparator<ICounter>, Serializable { /** * Creates a new comparator for {@link ICoverageNode} counters of the given * entity based on this counter sorting criteria. - * + * * @param entity * counter entity to sort on * @return comparator for {@link ICoverageNode} elements diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/CoverageBuilder.java b/org.jacoco.core/src/org/jacoco/core/analysis/CoverageBuilder.java index 4c55a32c..fccb2256 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/CoverageBuilder.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/CoverageBuilder.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -27,7 +27,7 @@ import org.jacoco.core.internal.analysis.SourceFileCoverageImpl; * {@link ICoverageVisitor} interface. Afterwards the aggregated data can be * obtained with {@link #getClasses()}, {@link #getSourceFiles()} or * {@link #getBundle(String)} in the following hierarchy: - * + * * <pre> * {@link IBundleCoverage} * +-- {@link IPackageCoverage}* @@ -43,7 +43,7 @@ public class CoverageBuilder implements ICoverageVisitor { /** * Create a new builder. - * + * */ public CoverageBuilder() { this.classes = new HashMap<String, IClassCoverage>(); @@ -52,7 +52,7 @@ public class CoverageBuilder implements ICoverageVisitor { /** * Returns all class nodes currently contained in this builder. - * + * * @return all class nodes */ public Collection<IClassCoverage> getClasses() { @@ -61,7 +61,7 @@ public class CoverageBuilder implements ICoverageVisitor { /** * Returns all source file nodes currently contained in this builder. - * + * * @return all source file nodes */ public Collection<ISourceFileCoverage> getSourceFiles() { @@ -70,7 +70,7 @@ public class CoverageBuilder implements ICoverageVisitor { /** * Creates a bundle from all nodes currently contained in this bundle. - * + * * @param name * Name of the bundle * @return bundle containing all classes and source files @@ -82,7 +82,7 @@ public class CoverageBuilder implements ICoverageVisitor { /** * Returns all classes for which execution data does not match. - * + * * @see IClassCoverage#isNoMatch() * @return collection of classes with non-matching execution data */ diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/CoverageNodeImpl.java b/org.jacoco.core/src/org/jacoco/core/analysis/CoverageNodeImpl.java index e04e23fe..a44cb8cc 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/CoverageNodeImpl.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/CoverageNodeImpl.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -45,7 +45,7 @@ public class CoverageNodeImpl implements ICoverageNode { /** * Creates a new coverage data node. - * + * * @param elementType * type of the element represented by this instance * @param name @@ -64,7 +64,7 @@ public class CoverageNodeImpl implements ICoverageNode { /** * Increments the counters by the values given by another element. - * + * * @param child * counters to add */ @@ -82,7 +82,7 @@ public class CoverageNodeImpl implements ICoverageNode { /** * Increments the counters by the values given by the collection of * elements. - * + * * @param children * list of nodes, which counters will be added to this node */ diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/IBundleCoverage.java b/org.jacoco.core/src/org/jacoco/core/analysis/IBundleCoverage.java index 80129185..aef3ed10 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/IBundleCoverage.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/IBundleCoverage.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -16,14 +16,14 @@ import java.util.Collection; /** * Coverage data of a bundle. A bundle groups a collection of packages. - * + * * @see IPackageCoverage */ public interface IBundleCoverage extends ICoverageNode { /** * Returns all packages contained in this bundle. - * + * * @return all packages */ Collection<IPackageCoverage> getPackages(); diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/IClassCoverage.java b/org.jacoco.core/src/org/jacoco/core/analysis/IClassCoverage.java index 1373c84d..f6c5cde7 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/IClassCoverage.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/IClassCoverage.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -17,7 +17,7 @@ import java.util.Collection; /** * Coverage data of a single class containing methods. The name of this node is * the fully qualified class name in VM notation (slash separated). - * + * * @see IMethodCoverage */ public interface IClassCoverage extends ISourceNode { @@ -25,7 +25,7 @@ public interface IClassCoverage extends ISourceNode { /** * Returns the identifier for this class which is the CRC64 signature of the * class definition. - * + * * @return class identifier */ long getId(); @@ -34,7 +34,7 @@ public interface IClassCoverage extends ISourceNode { * Returns if the the analyzed class does match the execution data provided. * More precisely if execution data is available for a class with the same * qualified name but with a different class id. - * + * * @return <code>true</code> if this class does not match to the provided * execution data. */ @@ -42,14 +42,14 @@ public interface IClassCoverage extends ISourceNode { /** * Returns the VM signature of the class. - * + * * @return VM signature of the class (may be <code>null</code>) */ String getSignature(); /** * Returns the VM name of the superclass. - * + * * @return VM name of the super class (may be <code>null</code>, i.e. * <code>java/lang/Object</code>) */ @@ -57,28 +57,28 @@ public interface IClassCoverage extends ISourceNode { /** * Returns the VM names of implemented/extended interfaces. - * + * * @return VM names of implemented/extended interfaces */ String[] getInterfaceNames(); /** * Returns the VM name of the package this class belongs to. - * + * * @return VM name of the package */ String getPackageName(); /** * Returns the optional name of the corresponding source file. - * + * * @return name of the corresponding source file */ String getSourceFileName(); /** * Returns the methods included in this class. - * + * * @return methods of this class */ Collection<IMethodCoverage> getMethods(); diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/ICounter.java b/org.jacoco.core/src/org/jacoco/core/analysis/ICounter.java index 4fedd30e..63520c34 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/ICounter.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/ICounter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -61,7 +61,7 @@ public interface ICounter { /** * Returns the counter value of the given type. - * + * * @param value * value type to return * @return counter value @@ -70,21 +70,21 @@ public interface ICounter { /** * Returns the total count of items. - * + * * @return total count of items */ int getTotalCount(); /** * Returns the count of covered items. - * + * * @return count of covered items */ int getCoveredCount(); /** * Returns the count of missed items. - * + * * @return count of missed items */ int getMissedCount(); @@ -92,7 +92,7 @@ public interface ICounter { /** * Calculates the ratio of covered to total count items. If total count * items is 0 this method returns NaN. - * + * * @return ratio of covered to total count items */ double getCoveredRatio(); @@ -100,19 +100,19 @@ public interface ICounter { /** * Calculates the ratio of missed to total count items. If total count items * is 0 this method returns NaN. - * + * * @return ratio of missed to total count items */ double getMissedRatio(); /** * Returns the coverage status of this counter. - * + * * @see ICounter#EMPTY * @see ICounter#NOT_COVERED * @see ICounter#PARTLY_COVERED * @see ICounter#FULLY_COVERED - * + * * @return status of this line */ int getStatus(); diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/ICoverageNode.java b/org.jacoco.core/src/org/jacoco/core/analysis/ICoverageNode.java index d1a5f52c..58d7dc09 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/ICoverageNode.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/ICoverageNode.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -69,63 +69,63 @@ public interface ICoverageNode { /** * Returns the type of element represented by this node. - * + * * @return type of this node */ ElementType getElementType(); /** * Returns the name of this node. - * + * * @return name of this node */ String getName(); /** * Returns the counter for byte code instructions. - * + * * @return counter for instructions */ ICounter getInstructionCounter(); /** * Returns the counter for branches. - * + * * @return counter for branches */ ICounter getBranchCounter(); /** * Returns the counter for lines. - * + * * @return counter for lines */ ICounter getLineCounter(); /** * Returns the counter for cyclomatic complexity. - * + * * @return counter for complexity */ ICounter getComplexityCounter(); /** * Returns the counter for methods. - * + * * @return counter for methods */ ICounter getMethodCounter(); /** * Returns the counter for classes. - * + * * @return counter for classes */ ICounter getClassCounter(); /** * Generic access to the the counters. - * + * * @param entity * entity we're we want to have the counter for * @return counter for the given entity @@ -145,7 +145,7 @@ public interface ICoverageNode { * implementations may contain heavy data structures, the copy returned by * this method is reduced to the counters only. This helps to save memory * while processing huge structures. - * + * * @return copy with counters only */ ICoverageNode getPlainCopy(); diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/ICoverageVisitor.java b/org.jacoco.core/src/org/jacoco/core/analysis/ICoverageVisitor.java index 4dc3b4ee..55ee73ec 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/ICoverageVisitor.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/ICoverageVisitor.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -20,7 +20,7 @@ public interface ICoverageVisitor { /** * For analyzed class coverage data is emitted to this method. - * + * * @param coverage * coverage data for a class */ diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/ILine.java b/org.jacoco.core/src/org/jacoco/core/analysis/ILine.java index f690b38e..84067dfb 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/ILine.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/ILine.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -20,14 +20,14 @@ public interface ILine { /** * Returns the instruction counter for this line. - * + * * @return instruction counter */ ICounter getInstructionCounter(); /** * Returns the branches counter for this line. - * + * * @return branches counter */ ICounter getBranchCounter(); @@ -35,12 +35,12 @@ public interface ILine { /** * Returns the coverage status of this line, calculated from the * instructions counter and branch counter. - * + * * @see ICounter#EMPTY * @see ICounter#NOT_COVERED * @see ICounter#PARTLY_COVERED * @see ICounter#FULLY_COVERED - * + * * @return status of this line */ int getStatus(); diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/IMethodCoverage.java b/org.jacoco.core/src/org/jacoco/core/analysis/IMethodCoverage.java index 877ddc4b..5de178e8 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/IMethodCoverage.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/IMethodCoverage.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -20,14 +20,14 @@ public interface IMethodCoverage extends ISourceNode { /** * Returns the descriptor of the method. - * + * * @return descriptor */ String getDesc(); /** * Returns the generic signature of the method if defined. - * + * * @return generic signature or <code>null</code> */ String getSignature(); diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/IPackageCoverage.java b/org.jacoco.core/src/org/jacoco/core/analysis/IPackageCoverage.java index 19831cf4..66c8d504 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/IPackageCoverage.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/IPackageCoverage.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -18,7 +18,7 @@ import java.util.Collection; * Coverage data of a Java package containing classes and source files. The name * of this node is the package name in VM notation (slash separated). The name * of the default package is the empty string. - * + * * @see IClassCoverage * @see ISourceFileCoverage */ @@ -26,14 +26,14 @@ public interface IPackageCoverage extends ICoverageNode { /** * Returns all classes contained in this package. - * + * * @return all classes */ Collection<IClassCoverage> getClasses(); /** * Returns all source files in this package. - * + * * @return all source files */ Collection<ISourceFileCoverage> getSourceFiles(); diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/ISourceFileCoverage.java b/org.jacoco.core/src/org/jacoco/core/analysis/ISourceFileCoverage.java index a4e39ae4..be5df9b2 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/ISourceFileCoverage.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/ISourceFileCoverage.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -20,7 +20,7 @@ public interface ISourceFileCoverage extends ISourceNode { /** * Returns the VM name of the package the source file belongs to. - * + * * @return package name */ String getPackageName(); diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/ISourceNode.java b/org.jacoco.core/src/org/jacoco/core/analysis/ISourceNode.java index a7830554..f5a130d1 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/ISourceNode.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/ISourceNode.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -24,7 +24,7 @@ public interface ISourceNode extends ICoverageNode { /** * The number of the first line coverage information is available for. If no * line is contained, the method returns -1. - * + * * @return number of the first line or {@link #UNKNOWN_LINE} */ int getFirstLine(); @@ -32,14 +32,14 @@ public interface ISourceNode extends ICoverageNode { /** * The number of the last line coverage information is available for. If no * line is contained, the method returns -1. - * + * * @return number of the last line or {@link #UNKNOWN_LINE} */ int getLastLine(); /** * Returns the line information for given line. - * + * * @param nr * line number of interest * @return line information diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/NodeComparator.java b/org.jacoco.core/src/org/jacoco/core/analysis/NodeComparator.java index dd82fe65..5daab64d 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/NodeComparator.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/NodeComparator.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.analysis; @@ -24,7 +24,7 @@ import org.jacoco.core.analysis.ICoverageNode.CounterEntity; /** * Comparator to compare {@link ICoverageNode} objects by different counter * criteria. - * + * * @see CounterComparator#on(ICoverageNode.CounterEntity) */ public class NodeComparator implements Comparator<ICoverageNode>, Serializable { @@ -43,10 +43,10 @@ public class NodeComparator implements Comparator<ICoverageNode>, Serializable { /** * Creates a new composite comparator with a second search criterion. - * + * * @param second * second criterion comparator - * + * * @return composite comparator */ public NodeComparator second(final Comparator<ICoverageNode> second) { @@ -66,7 +66,7 @@ public class NodeComparator implements Comparator<ICoverageNode>, Serializable { /** * Returns a sorted copy of the given collection of {@link ICoverageNode} * elements. - * + * * @param <T> * actual type of the elements * @param summaries diff --git a/org.jacoco.core/src/org/jacoco/core/analysis/package-info.java b/org.jacoco.core/src/org/jacoco/core/analysis/package-info.java index f1989e80..80a96a04 100644 --- a/org.jacoco.core/src/org/jacoco/core/analysis/package-info.java +++ b/org.jacoco.core/src/org/jacoco/core/analysis/package-info.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ /** diff --git a/org.jacoco.core/src/org/jacoco/core/data/ExecutionData.java b/org.jacoco.core/src/org/jacoco/core/data/ExecutionData.java index c3b1f6c0..49d0a4b4 100644 --- a/org.jacoco.core/src/org/jacoco/core/data/ExecutionData.java +++ b/org.jacoco.core/src/org/jacoco/core/data/ExecutionData.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.data; @@ -31,7 +31,7 @@ public final class ExecutionData { /** * Creates a new {@link ExecutionData} object with the given probe data. - * + * * @param id * class identifier * @param name @@ -49,7 +49,7 @@ public final class ExecutionData { /** * Creates a new {@link ExecutionData} object with the given probe data * length. All probes are set to <code>false</code>. - * + * * @param id * class identifier * @param name @@ -67,7 +67,7 @@ public final class ExecutionData { /** * Return the unique identifier for this class. The identifier is the CRC64 * checksum of the raw class file definition. - * + * * @return class identifier */ public long getId() { @@ -76,7 +76,7 @@ public final class ExecutionData { /** * The VM name of the class. - * + * * @return VM name */ public String getName() { @@ -86,7 +86,7 @@ public final class ExecutionData { /** * Returns the execution data probes. A value of <code>true</code> indicates * that the corresponding probe was executed. - * + * * @return probe data */ public boolean[] getProbes() { @@ -102,7 +102,7 @@ public final class ExecutionData { /** * Checks whether any probe has been hit. - * + * * @return <code>true</code>, if at least one probe has been hit */ public boolean hasHits() { @@ -119,13 +119,13 @@ public final class ExecutionData { * a probe entry in this object is marked as executed (<code>true</code>) if * this probe or the corresponding other probe was executed. So the result * is - * + * * <pre> * A or B * </pre> - * + * * The probe array of the other object is not modified. - * + * * @param other * execution data to merge */ @@ -138,19 +138,19 @@ public final class ExecutionData { * probe in this object is set to the value of <code>flag</code> if the * corresponding other probe was executed. For <code>flag==true</code> this * corresponds to - * + * * <pre> * A or B * </pre> - * + * * For <code>flag==false</code> this can be considered as a subtraction - * + * * <pre> * A and not B * </pre> - * + * * The probe array of the other object is not modified. - * + * * @param other * execution data to merge * @param flag @@ -171,7 +171,7 @@ public final class ExecutionData { * Asserts that this execution data object is compatible with the given * parameters. The purpose of this check is to detect a very unlikely class * id collision. - * + * * @param id * other class id, must be the same * @param name diff --git a/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataReader.java b/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataReader.java index b67b106f..73f7b8b0 100644 --- a/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataReader.java +++ b/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataReader.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.data; @@ -37,7 +37,7 @@ public class ExecutionDataReader { * Creates a new reader based on the given input stream input. Depending on * the nature of the underlying stream input should be buffered as most data * is read in single bytes. - * + * * @param input * input stream to read execution data from */ @@ -47,7 +47,7 @@ public class ExecutionDataReader { /** * Sets an listener for session information. - * + * * @param visitor * visitor to retrieve session info events */ @@ -57,7 +57,7 @@ public class ExecutionDataReader { /** * Sets an listener for execution data. - * + * * @param visitor * visitor to retrieve execution data events */ @@ -68,7 +68,7 @@ public class ExecutionDataReader { /** * Reads all data and reports it to the corresponding visitors. The stream * is read until its end or a command confirmation has been sent. - * + * * @return <code>true</code> if additional data can be expected after a * command has been executed. <code>false</code> if the end of the * stream has been reached. @@ -97,7 +97,7 @@ public class ExecutionDataReader { /** * Reads a block of data identified by the given id. Subclasses may * overwrite this method to support additional block types. - * + * * @param blocktype * block type * @return <code>true</code> if there are more blocks to read diff --git a/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataStore.java b/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataStore.java index eed4d74f..c8b00ff9 100644 --- a/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataStore.java +++ b/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataStore.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.data; @@ -37,7 +37,7 @@ public final class ExecutionDataStore implements IExecutionDataVisitor { * Adds the given {@link ExecutionData} object into the store. If there is * already execution data with this same class id, this structure is merged * with the given one. - * + * * @param data * execution data to add or merge * @throws IllegalStateException @@ -61,7 +61,7 @@ public final class ExecutionDataStore implements IExecutionDataVisitor { * store. I.e. for all set probes in the given data object the corresponding * probes in this store will be unset. If there is no execution data with id * of the given data object this operation will have no effect. - * + * * @param data * execution data to subtract * @throws IllegalStateException @@ -80,7 +80,7 @@ public final class ExecutionDataStore implements IExecutionDataVisitor { /** * Subtracts all probes in the given execution data store from this store. - * + * * @param store * execution data store to subtract * @see #subtract(ExecutionData) @@ -94,7 +94,7 @@ public final class ExecutionDataStore implements IExecutionDataVisitor { /** * Returns the {@link ExecutionData} entry with the given id if it exists in * this store. - * + * * @param id * class id * @return execution data or <code>null</code> @@ -106,7 +106,7 @@ public final class ExecutionDataStore implements IExecutionDataVisitor { /** * Checks whether execution data for classes with the given name are * contained in the store. - * + * * @param name * VM name * @return <code>true</code> if at least one class with the name is @@ -119,7 +119,7 @@ public final class ExecutionDataStore implements IExecutionDataVisitor { /** * Returns the coverage data for the class with the given identifier. If * there is no data available under the given id a new entry is created. - * + * * @param id * class identifier * @param name @@ -153,7 +153,7 @@ public final class ExecutionDataStore implements IExecutionDataVisitor { /** * Returns a collection that represents current contents of the store. - * + * * @return current contents */ public Collection<ExecutionData> getContents() { @@ -162,7 +162,7 @@ public final class ExecutionDataStore implements IExecutionDataVisitor { /** * Writes the content of the store to the given visitor interface. - * + * * @param visitor * interface to write content to */ diff --git a/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataWriter.java b/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataWriter.java index bd74ddf5..926d5b67 100644 --- a/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataWriter.java +++ b/org.jacoco.core/src/org/jacoco/core/data/ExecutionDataWriter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.data; @@ -53,7 +53,7 @@ public class ExecutionDataWriter * Creates a new writer based on the given output stream. Depending on the * nature of the underlying stream output should be buffered as most data is * written in single bytes. - * + * * @param output * binary stream to write execution data to * @throws IOException @@ -66,7 +66,7 @@ public class ExecutionDataWriter /** * Writes an file header to identify the stream and its protocol version. - * + * * @throws IOException * if the header can't be written */ @@ -78,7 +78,7 @@ public class ExecutionDataWriter /** * Flushes the underlying stream. - * + * * @throws IOException * if the underlying stream can't be flushed */ @@ -114,7 +114,7 @@ public class ExecutionDataWriter * Returns the first bytes of a file that represents a valid execution data * file. In any case every execution data file starts with the three bytes * <code>0x01 0xC0 0xC0</code>. - * + * * @return first bytes of a execution data file */ public static final byte[] getFileHeader() { diff --git a/org.jacoco.core/src/org/jacoco/core/data/IExecutionDataVisitor.java b/org.jacoco.core/src/org/jacoco/core/data/IExecutionDataVisitor.java index 1a23d959..99940a41 100644 --- a/org.jacoco.core/src/org/jacoco/core/data/IExecutionDataVisitor.java +++ b/org.jacoco.core/src/org/jacoco/core/data/IExecutionDataVisitor.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.data; @@ -21,7 +21,7 @@ public interface IExecutionDataVisitor { /** * Provides execution data for a class. - * + * * @param data * execution data for a class */ diff --git a/org.jacoco.core/src/org/jacoco/core/data/ISessionInfoVisitor.java b/org.jacoco.core/src/org/jacoco/core/data/ISessionInfoVisitor.java index b234b256..4ca318ce 100644 --- a/org.jacoco.core/src/org/jacoco/core/data/ISessionInfoVisitor.java +++ b/org.jacoco.core/src/org/jacoco/core/data/ISessionInfoVisitor.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.data; @@ -22,7 +22,7 @@ public interface ISessionInfoVisitor { /** * Provides session information for the subsequent execution data calls. In * case of merged sessions this method might be called multiple times. - * + * * @param info * session information */ diff --git a/org.jacoco.core/src/org/jacoco/core/data/IncompatibleExecDataVersionException.java b/org.jacoco.core/src/org/jacoco/core/data/IncompatibleExecDataVersionException.java index c6665964..c57f01d9 100644 --- a/org.jacoco.core/src/org/jacoco/core/data/IncompatibleExecDataVersionException.java +++ b/org.jacoco.core/src/org/jacoco/core/data/IncompatibleExecDataVersionException.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann, somechris - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.data; @@ -25,7 +25,7 @@ public class IncompatibleExecDataVersionException extends IOException { /** * Creates a new exception to flag version mismatches in execution data. - * + * * @param actualVersion * version found in the exec data */ @@ -40,7 +40,7 @@ public class IncompatibleExecDataVersionException extends IOException { /** * Gets the version expected in the execution data which can be read by this * version of JaCoCo. - * + * * @return expected version in execution data */ public int getExpectedVersion() { @@ -49,7 +49,7 @@ public class IncompatibleExecDataVersionException extends IOException { /** * Gets the actual version found in the execution data. - * + * * @return actual version in execution data */ public int getActualVersion() { diff --git a/org.jacoco.core/src/org/jacoco/core/data/SessionInfo.java b/org.jacoco.core/src/org/jacoco/core/data/SessionInfo.java index 9696dce1..7f50600b 100644 --- a/org.jacoco.core/src/org/jacoco/core/data/SessionInfo.java +++ b/org.jacoco.core/src/org/jacoco/core/data/SessionInfo.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.data; @@ -27,7 +27,7 @@ public class SessionInfo implements Comparable<SessionInfo> { /** * Create a immutable session info with the given data. - * + * * @param id * arbitrary session identifier, must not be <code>null</code> * @param start diff --git a/org.jacoco.core/src/org/jacoco/core/data/SessionInfoStore.java b/org.jacoco.core/src/org/jacoco/core/data/SessionInfoStore.java index 295a7e7c..f0fffba3 100644 --- a/org.jacoco.core/src/org/jacoco/core/data/SessionInfoStore.java +++ b/org.jacoco.core/src/org/jacoco/core/data/SessionInfoStore.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.data; @@ -29,7 +29,7 @@ public class SessionInfoStore implements ISessionInfoVisitor { /** * Tests whether the store is empty. - * + * * @return <code>true</code> if the store is empty */ public boolean isEmpty() { @@ -40,7 +40,7 @@ public class SessionInfoStore implements ISessionInfoVisitor { * Returns all {@link SessionInfo} objects currently contained in the store. * The info objects are ordered by its natural ordering (i.e. by the dump * time stamp). - * + * * @return list of stored {@link SessionInfo} objects */ public List<SessionInfo> getInfos() { @@ -55,11 +55,11 @@ public class SessionInfoStore implements ISessionInfoVisitor { * all contained sessions, the dump timestamp the maximum of all contained * sessions. If no session is currently contained both timestamps are set to * <code>0</code>. - * + * * @param id * identifier for the merged session info * @return new {@link SessionInfo} object - * + * */ public SessionInfo getMerged(final String id) { if (infos.isEmpty()) { @@ -77,7 +77,7 @@ public class SessionInfoStore implements ISessionInfoVisitor { /** * Writes all contained {@link SessionInfo} objects into the given visitor. * The info objects are emitted in chronological order by dump timestamp. - * + * * @param visitor * visitor to emit {@link SessionInfo} objects to */ diff --git a/org.jacoco.core/src/org/jacoco/core/data/package-info.java b/org.jacoco.core/src/org/jacoco/core/data/package-info.java index 7c4b0066..dd318fb4 100644 --- a/org.jacoco.core/src/org/jacoco/core/data/package-info.java +++ b/org.jacoco.core/src/org/jacoco/core/data/package-info.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ /** diff --git a/org.jacoco.core/src/org/jacoco/core/instr/Instrumenter.java b/org.jacoco.core/src/org/jacoco/core/instr/Instrumenter.java index 20647910..6cc55b9f 100644 --- a/org.jacoco.core/src/org/jacoco/core/instr/Instrumenter.java +++ b/org.jacoco.core/src/org/jacoco/core/instr/Instrumenter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.instr; @@ -48,7 +48,7 @@ public class Instrumenter { /** * Creates a new instance based on the given runtime. - * + * * @param runtime * runtime used by the instrumented classes */ @@ -62,7 +62,7 @@ public class Instrumenter { * typically necessary as instrumentation modifies the class files and * therefore invalidates existing JAR signatures. Default is * <code>true</code>. - * + * * @param flag * <code>true</code> if signatures should be removed */ @@ -92,7 +92,7 @@ public class Instrumenter { /** * Creates a instrumented version of the given class if possible. - * + * * @param buffer * definition of the class * @param name @@ -113,7 +113,7 @@ public class Instrumenter { /** * Creates a instrumented version of the given class if possible. The * provided {@link InputStream} is not closed by this method. - * + * * @param input * stream to read class definition from * @param name @@ -138,7 +138,7 @@ public class Instrumenter { * Creates a instrumented version of the given class file. The provided * {@link InputStream} and {@link OutputStream} instances are not closed by * this method. - * + * * @param input * stream to read class definition from * @param output @@ -168,7 +168,7 @@ public class Instrumenter { * other files are copied without modification. The provided * {@link InputStream} and {@link OutputStream} instances are not closed by * this method. - * + * * @param input * stream to contents from * @param output diff --git a/org.jacoco.core/src/org/jacoco/core/instr/package-info.java b/org.jacoco.core/src/org/jacoco/core/instr/package-info.java index 4ff5ba2d..876bb0ad 100644 --- a/org.jacoco.core/src/org/jacoco/core/instr/package-info.java +++ b/org.jacoco.core/src/org/jacoco/core/instr/package-info.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ /** diff --git a/org.jacoco.core/src/org/jacoco/core/internal/ContentTypeDetector.java b/org.jacoco.core/src/org/jacoco/core/internal/ContentTypeDetector.java index eefb9ef0..d3ec279a 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/ContentTypeDetector.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/ContentTypeDetector.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal; @@ -46,7 +46,7 @@ public class ContentTypeDetector { * Creates a new detector based on the given input. To process the complete * original input afterwards use the stream returned by * {@link #getInputStream()}. - * + * * @param in * input to read the header from * @throws IOException @@ -95,7 +95,7 @@ public class ContentTypeDetector { /** * Returns an input stream instance to read the complete content (including * the header) of the underlying stream. - * + * * @return input stream containing the complete content */ public InputStream getInputStream() { @@ -104,7 +104,7 @@ public class ContentTypeDetector { /** * Returns the detected file type. - * + * * @return file type */ public int getType() { diff --git a/org.jacoco.core/src/org/jacoco/core/internal/Pack200Streams.java b/org.jacoco.core/src/org/jacoco/core/internal/Pack200Streams.java index d9dda737..96b05960 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/Pack200Streams.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/Pack200Streams.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal; @@ -29,7 +29,7 @@ public final class Pack200Streams { /** * Unpack a stream in Pack200 format into a stream in JAR/ZIP format. - * + * * @param input * stream in Pack200 format * @return stream in JAR/ZIP format @@ -47,7 +47,7 @@ public final class Pack200Streams { /** * Packs a buffer in JAR/ZIP format into a stream in Pack200 format. - * + * * @param source * source in JAR/ZIP format * @param output diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/BundleCoverageImpl.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/BundleCoverageImpl.java index 7e0a086a..1cf5f068 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/BundleCoverageImpl.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/BundleCoverageImpl.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -36,7 +36,7 @@ public class BundleCoverageImpl extends CoverageNodeImpl /** * Creates a new instance of a bundle with the given name. - * + * * @param name * name of this bundle * @param packages @@ -52,7 +52,7 @@ public class BundleCoverageImpl extends CoverageNodeImpl /** * Creates a new instance of a bundle with the given name. The packages are * calculated from the given classes and source files. - * + * * @param name * name of this bundle * @param classes diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/ClassAnalyzer.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/ClassAnalyzer.java index 8df1aa13..9c0cfb19 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/ClassAnalyzer.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/ClassAnalyzer.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -47,7 +47,7 @@ public class ClassAnalyzer extends ClassProbesVisitor /** * Creates a new analyzer that builds coverage data for a class. - * + * * @param coverage * coverage node for the analyzed class data * @param probes diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/ClassCoverageImpl.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/ClassCoverageImpl.java index a8ba0cb2..6613d9b9 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/ClassCoverageImpl.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/ClassCoverageImpl.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -34,7 +34,7 @@ public class ClassCoverageImpl extends SourceNodeImpl /** * Creates a class coverage data object with the given parameters. - * + * * @param name * VM name of the class * @param id @@ -53,7 +53,7 @@ public class ClassCoverageImpl extends SourceNodeImpl /** * Add a method to this class. - * + * * @param method * method data to add */ @@ -70,7 +70,7 @@ public class ClassCoverageImpl extends SourceNodeImpl /** * Sets the VM signature of the class. - * + * * @param signature * VM signature of the class (may be <code>null</code>) */ @@ -80,7 +80,7 @@ public class ClassCoverageImpl extends SourceNodeImpl /** * Sets the VM name of the superclass. - * + * * @param superName * VM name of the super class (may be <code>null</code>, i.e. * <code>java/lang/Object</code>) @@ -91,7 +91,7 @@ public class ClassCoverageImpl extends SourceNodeImpl /** * Sets the VM names of implemented/extended interfaces. - * + * * @param interfaces * VM names of implemented/extended interfaces */ @@ -101,7 +101,7 @@ public class ClassCoverageImpl extends SourceNodeImpl /** * Sets the name of the corresponding source file for this class. - * + * * @param sourceFileName * name of the source file */ diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/CounterImpl.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/CounterImpl.java index 1cab3ab0..4755e644 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/CounterImpl.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/CounterImpl.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -76,7 +76,7 @@ public abstract class CounterImpl implements ICounter { /** * Factory method to retrieve a counter with the given number of items. - * + * * @param missed * number of missed items * @param covered @@ -93,7 +93,7 @@ public abstract class CounterImpl implements ICounter { /** * Factory method to retrieve a clone of the given counter. - * + * * @param counter * counter to copy * @return counter instance @@ -110,7 +110,7 @@ public abstract class CounterImpl implements ICounter { /** * Creates a new instance with the given numbers. - * + * * @param missed * number of missed items * @param covered @@ -125,7 +125,7 @@ public abstract class CounterImpl implements ICounter { * Returns a counter with values incremented by the numbers of the given * counter. It is up to the implementation whether this counter instance is * modified or a new instance is returned. - * + * * @param counter * number of additional total and covered items * @return counter instance with incremented values @@ -138,7 +138,7 @@ public abstract class CounterImpl implements ICounter { * Returns a counter with values incremented by the given numbers. It is up * to the implementation whether this counter instance is modified or a new * instance is returned. - * + * * @param missed * number of missed items * @param covered diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/Instruction.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/Instruction.java index e40bbca0..9b7f44d8 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/Instruction.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/Instruction.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -23,31 +23,31 @@ import org.jacoco.core.analysis.ICounter; * outgoing branch. Each instruction has at least one branch, for example in * case of a simple sequence of instructions (by convention branch 0). Instances * of this class are used in two steps: - * + * * <h2>Step 1: Building the CFG</h2> - * + * * For each bytecode instruction of a method a {@link Instruction} instance is * created. In correspondence with the CFG these instances are linked with each * other with the <code>addBranch()</code> methods. The executions status is * either directly derived from a probe which has been inserted in the execution * flow ({@link #addBranch(boolean, int)}) or indirectly propagated along the * CFG edges ({@link #addBranch(Instruction, int)}). - * + * * <h2>Step 2: Querying the Coverage Status</h2> - * + * * After all instructions have been created and linked each instruction knows * its execution status and can be queried with: - * + * * <ul> * <li>{@link #getLine()}</li> * <li>{@link #getInstructionCounter()}</li> * <li>{@link #getBranchCounter()}</li> * </ul> - * + * * For the purpose of filtering instructions can be combined to new * instructions. Note that these methods create new {@link Instruction} * instances and do not modify the existing ones. - * + * * <ul> * <li>{@link #merge(Instruction)}</li> * <li>{@link #replaceBranches(Collection)}</li> @@ -67,7 +67,7 @@ public class Instruction { /** * New instruction at the given line. - * + * * @param line * source line this instruction belongs to */ @@ -82,10 +82,10 @@ public class Instruction { * derived from the execution status of the target instruction. In case the * branch is covered the status is propagated also to the predecessors of * this instruction. - * + * * Note: This method is not idempotent and must be called exactly once for * every branch. - * + * * @param target * target instruction of this branch * @param branch @@ -104,10 +104,10 @@ public class Instruction { * Adds a branch to this instruction which execution status is directly * derived from a probe. In case the branch is covered the status is * propagated also to the predecessors of this instruction. - * + * * Note: This method is not idempotent and must be called exactly once for * every branch. - * + * * @param executed * whether the corresponding probe has been executed * @param branch @@ -135,7 +135,7 @@ public class Instruction { /** * Returns the source line this instruction belongs to. - * + * * @return corresponding source line */ public int getLine() { @@ -145,7 +145,7 @@ public class Instruction { /** * Merges information about covered branches of this instruction with * another instruction. - * + * * @param other * instruction to merge with * @return new instance with merged branches @@ -162,7 +162,7 @@ public class Instruction { * Creates a copy of this instruction where all outgoing branches are * replaced with the given instructions. The coverage status of the new * instruction is derived from the status of the given instructions. - * + * * @param newBranches * new branches to consider * @return new instance with replaced branches @@ -183,7 +183,7 @@ public class Instruction { /** * Returns the instruction coverage counter of this instruction. It is * always 1 instruction which is covered or not. - * + * * @return the instruction coverage counter */ public ICounter getInstructionCounter() { @@ -194,7 +194,7 @@ public class Instruction { /** * Returns the branch coverage counter of this instruction. Only * instructions with at least 2 outgoing edges report branches. - * + * * @return the branch coverage counter */ public ICounter getBranchCounter() { diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/InstructionsBuilder.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/InstructionsBuilder.java index b155baac..832e03fa 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/InstructionsBuilder.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/InstructionsBuilder.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -47,7 +47,7 @@ class InstructionsBuilder { /** * The labels which mark the subsequent instructions. - * + * * Due to ASM issue #315745 there can be more than one label per instruction */ private final List<Label> currentLabel; @@ -61,7 +61,7 @@ class InstructionsBuilder { /** * Creates a new builder instance which can be used to analyze a single * method. - * + * * @param probes * probe array of the corresponding class used to determine the * coverage status of every instruction. @@ -127,7 +127,7 @@ class InstructionsBuilder { /** * Adds a jump from the last added instruction. - * + * * @param target * jump target * @param branch @@ -139,7 +139,7 @@ class InstructionsBuilder { /** * Adds a new probe for the last instruction. - * + * * @param probeId * index in the probe array * @param branch @@ -153,7 +153,7 @@ class InstructionsBuilder { /** * Returns the status for all instructions of this method. This method must * be called exactly once after the instructions have been added. - * + * * @return map of ASM instruction nodes to corresponding {@link Instruction} * instances */ diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/LineImpl.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/LineImpl.java index 6d982084..73aca7f6 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/LineImpl.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/LineImpl.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -110,7 +110,7 @@ public abstract class LineImpl implements ILine { /** * Adds the given counters to this line. - * + * * @param instructions * instructions to add * @param branches diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodAnalyzer.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodAnalyzer.java index be02a3e3..19c518b5 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodAnalyzer.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodAnalyzer.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodCoverageCalculator.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodCoverageCalculator.java index c6182d6b..ee8b7c6f 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodCoverageCalculator.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodCoverageCalculator.java @@ -8,7 +8,7 @@ * * Contributors: * Evgeny Mandrikov - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -40,11 +40,11 @@ class MethodCoverageCalculator implements IFilterOutput { * Instructions that should be merged form disjoint sets. Coverage * information from instructions of one set will be merged into * representative instruction of set. - * + * * Each such set is represented as a singly linked list: each element except * one references another element from the same set, element without * reference - is a representative of this set. - * + * * This map stores reference (value) for elements of sets (key). */ private final Map<AbstractInsnNode, AbstractInsnNode> merged; @@ -62,7 +62,7 @@ class MethodCoverageCalculator implements IFilterOutput { /** * Applies all specified filtering commands and calculates the resulting * coverage. - * + * * @param coverage * the result is added to this coverage node */ diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodCoverageImpl.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodCoverageImpl.java index f86a559f..05376d2b 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodCoverageImpl.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/MethodCoverageImpl.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -27,7 +27,7 @@ public class MethodCoverageImpl extends SourceNodeImpl /** * Creates a method coverage data object with the given parameters. - * + * * @param name * name of the method * @param desc diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/PackageCoverageImpl.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/PackageCoverageImpl.java index fa5eb00a..611a2891 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/PackageCoverageImpl.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/PackageCoverageImpl.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -31,7 +31,7 @@ public class PackageCoverageImpl extends CoverageNodeImpl /** * Creates package node instance for a package with the given name. - * + * * @param name * vm name of the package * @param classes diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/SourceFileCoverageImpl.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/SourceFileCoverageImpl.java index b0aa25c2..10ff0296 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/SourceFileCoverageImpl.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/SourceFileCoverageImpl.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -24,7 +24,7 @@ public class SourceFileCoverageImpl extends SourceNodeImpl /** * Creates a source file data object with the given parameters. - * + * * @param name * name of the source file * @param packagename diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/SourceNodeImpl.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/SourceNodeImpl.java index 8351582d..97d2fc5b 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/SourceNodeImpl.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/SourceNodeImpl.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -29,7 +29,7 @@ public class SourceNodeImpl extends CoverageNodeImpl implements ISourceNode { /** * Create a new source node implementation instance. - * + * * @param elementType * element type * @param name @@ -45,7 +45,7 @@ public class SourceNodeImpl extends CoverageNodeImpl implements ISourceNode { * Make sure that the internal buffer can keep lines from first to last. * While the buffer is also incremented automatically, this method allows * optimization in case the total range is known in advance. - * + * * @param first * first line number or {@link ISourceNode#UNKNOWN_LINE} * @param last @@ -76,7 +76,7 @@ public class SourceNodeImpl extends CoverageNodeImpl implements ISourceNode { * Increments all counters by the values of the given child. When * incrementing the line counter it is assumed that the child refers to the * same source file. - * + * * @param child * child node to add */ @@ -104,7 +104,7 @@ public class SourceNodeImpl extends CoverageNodeImpl implements ISourceNode { * Increments instructions and branches by the given counter values. If a * optional line number is specified the instructions and branches are added * to the given line. The line counter is incremented accordingly. - * + * * @param instructions * instructions to add * @param branches diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/StringPool.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/StringPool.java index a57b90db..f2b72822 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/StringPool.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/StringPool.java @@ -7,9 +7,9 @@ * SPDX-License-Identifier: EPL-2.0 * * Contributors: - * Brock Janiczak - analysis and concept + * Brock Janiczak - analysis and concept * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.analysis; @@ -32,7 +32,7 @@ public final class StringPool { /** * Returns a normalized instance that is equal to the given {@link String} . - * + * * @param s * any string or <code>null</code> * @return normalized instance or <code>null</code> @@ -53,7 +53,7 @@ public final class StringPool { * Returns a modified version of the array with all string slots normalized. * It is up to the implementation to replace strings in the array instance * or return a new array instance. - * + * * @param arr * String array or <code>null</code> * @return normalized instance or <code>null</code> diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/Filters.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/Filters.java index 140a7e10..fe92f381 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/Filters.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/Filters.java @@ -28,7 +28,7 @@ public final class Filters implements IFilter { /** * Creates filter that combines all other filters. - * + * * @return filter that combines all other filters */ public static IFilter all() { diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/FinallyFilter.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/FinallyFilter.java index 5ccc4283..fbf7f833 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/FinallyFilter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/FinallyFilter.java @@ -27,7 +27,7 @@ import org.objectweb.asm.tree.VarInsnNode; * Filters duplicates of finally blocks that compiler generates. * * To understand algorithm of filtering, consider following example: - * + * * <pre> * try { * if (x) { @@ -45,7 +45,7 @@ import org.objectweb.asm.tree.VarInsnNode; * There are 4 <b>distinct</b> points of exit out of these "try/catch/finally" * blocks - three without exception, and one with Throwable if it is thrown * prior to reaching first three points of exit. - * + * * "finally" block must be executed just before these points, so there must be 4 * copies of its bytecode instructions. * diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/IFilterOutput.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/IFilterOutput.java index 5399ba44..231feb7d 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/IFilterOutput.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/IFilterOutput.java @@ -36,7 +36,7 @@ public interface IFilterOutput { /** * Marks two instructions that should be merged during computation of * coverage. - * + * * @param i1 * first instruction * @param i2 diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/KotlinDefaultArgumentsFilter.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/KotlinDefaultArgumentsFilter.java index 04bdf1b3..730b5969 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/KotlinDefaultArgumentsFilter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/KotlinDefaultArgumentsFilter.java @@ -25,10 +25,10 @@ import org.objectweb.asm.tree.VarInsnNode; /** * Filters branches that Kotlin compiler generates for default arguments. - * + * * For each default argument Kotlin compiler generates following bytecode to * determine if it should be used or not: - * + * * <pre> * ILOAD maskVar * ICONST_x, BIPUSH, SIPUSH, LDC or LDC_W @@ -37,7 +37,7 @@ import org.objectweb.asm.tree.VarInsnNode; * default argument * label: * </pre> - * + * * Where <code>maskVar</code> is penultimate argument of synthetic method with * suffix "$default" or of synthetic constructor with last argument * "kotlin.jvm.internal.DefaultConstructorMarker". And its value can't be zero - diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/TryWithResourcesJavac11Filter.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/TryWithResourcesJavac11Filter.java index 539fb110..9b182dbc 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/TryWithResourcesJavac11Filter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/TryWithResourcesJavac11Filter.java @@ -56,7 +56,7 @@ public final class TryWithResourcesJavac11Filter implements IFilter { * throw primaryExc; * } * </pre> - * + * * <code>null</code> check for resource is omitted when it is initialized * using <code>new</code> */ diff --git a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/TryWithResourcesJavacFilter.java b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/TryWithResourcesJavacFilter.java index fa35cb79..da4a294a 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/TryWithResourcesJavacFilter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/analysis/filter/TryWithResourcesJavacFilter.java @@ -48,7 +48,7 @@ public final class TryWithResourcesJavacFilter implements IFilter { * compilation of source code that is described in <a href= * "http://docs.oracle.com/javase/specs/jls/se8/html/jls-14.html#jls-14.20.3.1">JLS * 14.20.3. try-with-resources</a>: - * + * * <pre> * Resource r = ...; * Throwable primaryExc = null; diff --git a/org.jacoco.core/src/org/jacoco/core/internal/data/CRC64.java b/org.jacoco.core/src/org/jacoco/core/internal/data/CRC64.java index d9beadf2..4244f2b8 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/data/CRC64.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/data/CRC64.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.data; @@ -17,7 +17,7 @@ import org.objectweb.asm.Opcodes; /** * CRC64 checksum calculator based on the polynom specified in ISO 3309. The * implementation is based on the following publications: - * + * * <ul> * <li>http://en.wikipedia.org/wiki/Cyclic_redundancy_check</li> * <li>http://www.geocities.com/SiliconValley/Pines/8659/crc.htm</li> diff --git a/org.jacoco.core/src/org/jacoco/core/internal/data/CompactDataInput.java b/org.jacoco.core/src/org/jacoco/core/internal/data/CompactDataInput.java index 989db602..6c5282d7 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/data/CompactDataInput.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/data/CompactDataInput.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.data; @@ -18,7 +18,7 @@ import java.io.InputStream; /** * Additional data input methods for compact storage of data structures. - * + * * @see CompactDataOutput */ public class CompactDataInput extends DataInputStream { @@ -26,7 +26,7 @@ public class CompactDataInput extends DataInputStream { /** * Creates a new {@link CompactDataInput} that uses the specified underlying * input stream. - * + * * @param in * underlying input stream */ @@ -36,7 +36,7 @@ public class CompactDataInput extends DataInputStream { /** * Reads a variable length representation of an integer value. - * + * * @return read value * @throws IOException * if thrown by the underlying stream @@ -51,7 +51,7 @@ public class CompactDataInput extends DataInputStream { /** * Reads a boolean array. - * + * * @return boolean array * @throws IOException * if thrown by the underlying stream diff --git a/org.jacoco.core/src/org/jacoco/core/internal/data/CompactDataOutput.java b/org.jacoco.core/src/org/jacoco/core/internal/data/CompactDataOutput.java index f2b34b4a..f2d32287 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/data/CompactDataOutput.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/data/CompactDataOutput.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.data; @@ -18,7 +18,7 @@ import java.io.OutputStream; /** * Additional data output methods for compact storage of data structures. - * + * * @see CompactDataInput */ public class CompactDataOutput extends DataOutputStream { @@ -26,7 +26,7 @@ public class CompactDataOutput extends DataOutputStream { /** * Creates a new {@link CompactDataOutput} instance that writes data to the * specified underlying output stream - * + * * @param out * underlying output stream */ @@ -38,7 +38,7 @@ public class CompactDataOutput extends DataOutputStream { * Writes a variable length representation of an integer value that reduces * the number of written bytes for small positive values. Depending on the * given value 1 to 5 bytes will be written to the underlying stream. - * + * * @param value * value to write * @throws IOException @@ -56,7 +56,7 @@ public class CompactDataOutput extends DataOutputStream { /** * Writes a boolean array. Internally a sequence of boolean values is packed * into single bits. - * + * * @param value * boolean array * @throws IOException diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/ClassProbesAdapter.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/ClassProbesAdapter.java index e80d041b..b845bce4 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/flow/ClassProbesAdapter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/flow/ClassProbesAdapter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.flow; @@ -37,7 +37,7 @@ public class ClassProbesAdapter extends ClassVisitor /** * Creates a new adapter that delegates to the given visitor. - * + * * @param cv * instance to delegate to * @param trackFrames diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/ClassProbesVisitor.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/ClassProbesVisitor.java index 3a90e01b..0fbff020 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/flow/ClassProbesVisitor.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/flow/ClassProbesVisitor.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.flow; @@ -30,7 +30,7 @@ public abstract class ClassProbesVisitor extends ClassVisitor { /** * New visitor instance that delegates to the given visitor. - * + * * @param cv * optional next visitor in chain */ @@ -51,7 +51,7 @@ public abstract class ClassProbesVisitor extends ClassVisitor { * is called just before {@link ClassVisitor#visitEnd()}. For interfaces * this method is called before the first method (the static initializer) is * emitted. - * + * * @param count * total number of probes */ diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/FrameSnapshot.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/FrameSnapshot.java index 259edff0..7e76ce0b 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/flow/FrameSnapshot.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/flow/FrameSnapshot.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.flow; @@ -37,7 +37,7 @@ class FrameSnapshot implements IFrame { /** * Create a IFrame instance based on the given analyzer. - * + * * @param analyzer * analyzer instance or <code>null</code> * @param popCount diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/IFrame.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/IFrame.java index 01bf4db6..1e93cd4b 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/flow/IFrame.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/flow/IFrame.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.flow; @@ -21,7 +21,7 @@ public interface IFrame { /** * Emits a frame event with the current content to the given visitor. - * + * * @param mv * method visitor to emit frame event to */ diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/IProbeIdGenerator.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/IProbeIdGenerator.java index 217387c9..53b73ad4 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/flow/IProbeIdGenerator.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/flow/IProbeIdGenerator.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.flow; @@ -19,7 +19,7 @@ public interface IProbeIdGenerator { /** * Returns the next unique probe id. - * + * * @return unique probe id */ int nextId(); diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/LabelFlowAnalyzer.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/LabelFlowAnalyzer.java index 99fa181b..0c7c342f 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/flow/LabelFlowAnalyzer.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/flow/LabelFlowAnalyzer.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.flow; @@ -28,7 +28,7 @@ public final class LabelFlowAnalyzer extends MethodVisitor { /** * Marks all labels of the method with control flow information. - * + * * @param method * Method to mark labels */ diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/LabelInfo.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/LabelInfo.java index 7164f9ef..a30a371a 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/flow/LabelInfo.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/flow/LabelInfo.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.flow; @@ -49,7 +49,7 @@ public final class LabelInfo { /** * Defines that the given label is a jump target. - * + * * @param label * label to define */ @@ -65,7 +65,7 @@ public final class LabelInfo { /** * Defines that the given label is the possible successor of the previous * instruction in the method. - * + * * @param label * label to define */ @@ -82,7 +82,7 @@ public final class LabelInfo { * to a certain label are: jump targets, exception handlers and normal * control flow from its predecessor instruction (unless this is an * unconditional jump or method exit). - * + * * @param label * label to check * @return <code>true</code> if the given multiple control paths lead to the @@ -97,7 +97,7 @@ public final class LabelInfo { * Checks whether this label is the possible successor of the previous * instruction in the method. This is the case if the predecessor isn't a * unconditional jump or method exit instruction. - * + * * @param label * label to check * @return <code>true</code> if the label is a possible instruction @@ -110,7 +110,7 @@ public final class LabelInfo { /** * Mark a given label as the beginning of a line with method invocations. - * + * * @param label * label to mark */ @@ -121,7 +121,7 @@ public final class LabelInfo { /** * Checks whether the a given label has been marked as a line with method * invocations. - * + * * @param label * label to check * @return <code>true</code> if the label represents a line with method @@ -134,7 +134,7 @@ public final class LabelInfo { /** * Determines whether the given label needs a probe to be inserted before. - * + * * @param label * label to test * @return <code>true</code> if a probe should be inserted before @@ -147,7 +147,7 @@ public final class LabelInfo { /** * Mark a given label as done. - * + * * @param label * label to mark */ @@ -157,7 +157,7 @@ public final class LabelInfo { /** * Resets the "done" status of a given label. - * + * * @param label * label to reset */ @@ -170,7 +170,7 @@ public final class LabelInfo { /** * Resets the "done" status of all given labels. - * + * * @param labels * labels to reset */ @@ -182,7 +182,7 @@ public final class LabelInfo { /** * Checks whether this label is marked as done. - * + * * @param label * label to check * @return <code>true</code> if this label is marked as done @@ -194,7 +194,7 @@ public final class LabelInfo { /** * Sets the given probe id to the given label. - * + * * @param label * label to assign a probe to * @param id @@ -206,7 +206,7 @@ public final class LabelInfo { /** * Returns the assigned probe id. - * + * * @param label * label to check * @return probe id or {@link #NO_PROBE} if no probe is assigned to the @@ -220,7 +220,7 @@ public final class LabelInfo { /** * Defines an intermediate label for the given label. Such intermediate * labels are required during instrumentation to add probes to jump targets. - * + * * @param label * label to define for * @param intermediate @@ -234,7 +234,7 @@ public final class LabelInfo { /** * Returns the intermediate label for the given label if one has been * defined. - * + * * @param label * label to look for * @return intermediate label or <code>null</code> @@ -246,7 +246,7 @@ public final class LabelInfo { /** * Sets the instruction corresponding to this label. - * + * * @param label * label to set the instruction for * @param instruction @@ -260,7 +260,7 @@ public final class LabelInfo { /** * Returns the corresponding instruction for the given label if one has been * defined. - * + * * @param label * label to look for * @return corresponding instruction or <code>null</code> diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodProbesAdapter.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodProbesAdapter.java index 667fe95d..7bce3ac9 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodProbesAdapter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodProbesAdapter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.flow; @@ -37,7 +37,7 @@ public final class MethodProbesAdapter extends MethodVisitor { /** * Create a new adapter instance. - * + * * @param probesVisitor * visitor to delegate to * @param idGenerator @@ -54,7 +54,7 @@ public final class MethodProbesAdapter extends MethodVisitor { /** * If an analyzer is set {@link IFrame} handles are calculated and emitted * to the probes methods. - * + * * @param analyzer * optional analyzer to set */ diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodProbesVisitor.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodProbesVisitor.java index 858b7a25..1c0dbdad 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodProbesVisitor.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodProbesVisitor.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.flow; @@ -32,7 +32,7 @@ public abstract class MethodProbesVisitor extends MethodVisitor { /** * New visitor instance that delegates to the given visitor. - * + * * @param mv * optional next visitor in chain */ @@ -43,7 +43,7 @@ public abstract class MethodProbesVisitor extends MethodVisitor { /** * Visits an unconditional probe that should be inserted at the current * position. - * + * * @param probeId * id of the probe to insert */ @@ -55,7 +55,7 @@ public abstract class MethodProbesVisitor extends MethodVisitor { * Visits a jump instruction. A probe with the given id should be inserted * in a way that it is executed only when the jump to the given label is * executed. - * + * * @param opcode * the opcode of the type instruction to be visited. This opcode * is either IFEQ, IFNE, IFLT, IFGE, IFGT, IFLE, IF_ICMPEQ, @@ -82,7 +82,7 @@ public abstract class MethodProbesVisitor extends MethodVisitor { * Visits a zero operand instruction with a probe. This event is used only * for instructions that terminate the method. Therefore the probe must be * inserted before the actual instruction. - * + * * @param opcode * the opcode of the instruction to be visited. This opcode is * either IRETURN, LRETURN, FRETURN, DRETURN, ARETURN, RETURN or @@ -101,7 +101,7 @@ public abstract class MethodProbesVisitor extends MethodVisitor { * target labels will always have the same probe id within a call to this * method. The probe id for each label can be obtained with * {@link LabelInfo#getProbeId(Label)}. - * + * * @param min * the minimum key value. * @param max @@ -129,7 +129,7 @@ public abstract class MethodProbesVisitor extends MethodVisitor { * target labels will always have the same probe id within a call to this * method. The probe id for each label can be obtained with * {@link LabelInfo#getProbeId(Label)}. - * + * * @param dflt * beginning of the default handler block. * @param keys diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodSanitizer.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodSanitizer.java index b7aa5b10..f8d2f631 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodSanitizer.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodSanitizer.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.flow; @@ -19,7 +19,7 @@ import org.objectweb.asm.commons.JSRInlinerAdapter; /** * This method visitor fixes two potential issues with Java byte code: - * + * * <ul> * <li>Remove JSR/RET instructions by inlining subroutines which are deprecated * since Java 6. The RET statement complicates control flow analysis as the jump diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/ClassFieldProbeArrayStrategy.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/ClassFieldProbeArrayStrategy.java index 35b536e5..ce7ac8a4 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/ClassFieldProbeArrayStrategy.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/ClassFieldProbeArrayStrategy.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; @@ -109,9 +109,9 @@ class ClassFieldProbeArrayStrategy implements IProbeArrayStrategy { /** * Generates the byte code to initialize the static coverage data field * within this class. - * + * * The code will push the [Z data array on the operand stack. - * + * * @param mv * generator to emit code to */ diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/ClassInstrumenter.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/ClassInstrumenter.java index dc511939..d4dfd665 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/ClassInstrumenter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/ClassInstrumenter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; @@ -29,7 +29,7 @@ public class ClassInstrumenter extends ClassProbesVisitor { /** * Emits a instrumented version of this class to the given class visitor. - * + * * @param probeArrayStrategy * this strategy will be used to access the probe array * @param cv diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/DuplicateFrameEliminator.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/DuplicateFrameEliminator.java index e71b9f65..5ca77c98 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/DuplicateFrameEliminator.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/DuplicateFrameEliminator.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/IProbeArrayStrategy.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/IProbeArrayStrategy.java index 6a23c24c..80c72dd0 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/IProbeArrayStrategy.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/IProbeArrayStrategy.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; @@ -24,7 +24,7 @@ public interface IProbeArrayStrategy { /** * Creates code that stores the probe array instance in the given variable. - * + * * @param mv * visitor to create code * @param clinit @@ -38,7 +38,7 @@ public interface IProbeArrayStrategy { /** * Adds additional class members required by this strategy. This method is * called after all original members of the class has been processed. - * + * * @param cv * visitor to create fields and methods * @param probeCount diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/IProbeInserter.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/IProbeInserter.java index 86db70cd..46b50341 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/IProbeInserter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/IProbeInserter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; @@ -20,7 +20,7 @@ interface IProbeInserter { /** * Inserts the probe with the given id. - * + * * @param id * id of the probe to insert */ diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/InstrSupport.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/InstrSupport.java index af241d2e..6b4fe3a7 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/InstrSupport.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/InstrSupport.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; @@ -209,7 +209,7 @@ public final class InstrSupport { /** * Determines whether the given class file version requires stackmap frames. - * + * * @param version * class file version * @return <code>true</code> if frames are required @@ -223,7 +223,7 @@ public final class InstrSupport { * Ensures that the given member does not correspond to a internal member * created by the instrumentation process. This would mean that the class is * already instrumented. - * + * * @param member * name of the member to check * @param owner @@ -245,7 +245,7 @@ public final class InstrSupport { * Generates the instruction to push the given int value on the stack. * Implementation taken from * {@link org.objectweb.asm.commons.GeneratorAdapter#push(int)}. - * + * * @param mv * visitor to emit the instruction * @param value diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/LocalProbeArrayStrategy.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/LocalProbeArrayStrategy.java index 8ee38c7e..25e41e9d 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/LocalProbeArrayStrategy.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/LocalProbeArrayStrategy.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/MethodInstrumenter.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/MethodInstrumenter.java index 06e34332..a4cf6bac 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/MethodInstrumenter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/MethodInstrumenter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; @@ -29,7 +29,7 @@ class MethodInstrumenter extends MethodProbesVisitor { /** * Create a new instrumenter instance for the given method. - * + * * @param mv * next method visitor in the chain * @param probeInserter diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/NoneProbeArrayStrategy.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/NoneProbeArrayStrategy.java index d6cf51b1..75ec8c09 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/NoneProbeArrayStrategy.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/NoneProbeArrayStrategy.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeArrayStrategyFactory.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeArrayStrategyFactory.java index 0758980d..271dfb38 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeArrayStrategyFactory.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeArrayStrategyFactory.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeCounter.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeCounter.java index a6474065..3f591ecc 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeCounter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeCounter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeInserter.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeInserter.java index 4c6f8d00..faeb4c01 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeInserter.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/ProbeInserter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; @@ -43,7 +43,7 @@ class ProbeInserter extends MethodVisitor implements IProbeInserter { /** * Creates a new {@link ProbeInserter}. - * + * * @param access * access flags of the adapted method * @param name diff --git a/org.jacoco.core/src/org/jacoco/core/internal/instr/SignatureRemover.java b/org.jacoco.core/src/org/jacoco/core/internal/instr/SignatureRemover.java index c2c62b7f..61c5eb49 100644 --- a/org.jacoco.core/src/org/jacoco/core/internal/instr/SignatureRemover.java +++ b/org.jacoco.core/src/org/jacoco/core/internal/instr/SignatureRemover.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.internal.instr; @@ -48,7 +48,7 @@ public class SignatureRemover { /** * Defines whether this remover should be active. If it is not active it * will not remove any entries. - * + * * @param active * <code>true</code> if it should remove signature related * entries. @@ -59,7 +59,7 @@ public class SignatureRemover { /** * Checks whether a entry with the provided name should be ignored at all. - * + * * @param name * path name of the entry in question * @return true is the entry should be ignored @@ -70,7 +70,7 @@ public class SignatureRemover { /** * Filters the content of the entry with the provided name if necessary. - * + * * @param name * path name of the entry in question * @param in diff --git a/org.jacoco.core/src/org/jacoco/core/package-info.java b/org.jacoco.core/src/org/jacoco/core/package-info.java index 8c57179b..9f7f395b 100644 --- a/org.jacoco.core/src/org/jacoco/core/package-info.java +++ b/org.jacoco.core/src/org/jacoco/core/package-info.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ /** diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/AbstractRuntime.java b/org.jacoco.core/src/org/jacoco/core/runtime/AbstractRuntime.java index 27007dc6..72857fff 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/AbstractRuntime.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/AbstractRuntime.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -33,7 +33,7 @@ public abstract class AbstractRuntime implements IRuntime { /** * Creates a random session identifier. - * + * * @return random session identifier */ public static String createRandomId() { diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/AgentOptions.java b/org.jacoco.core/src/org/jacoco/core/runtime/AgentOptions.java index 228a4b20..9358c57f 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/AgentOptions.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/AgentOptions.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -27,7 +27,7 @@ import java.util.regex.Pattern; /** * Utility to create and parse options for the runtime agent. Options are * represented as a string in the following format: - * + * * <pre> * key1=value1,key2=value2,key3=value3 * </pre> @@ -54,7 +54,7 @@ public final class AgentOptions { /** * Wildcard expression for class names that should be included for code * coverage. Default is <code>*</code> (all classes included). - * + * * @see WildcardMatcher */ public static final String INCLUDES = "includes"; @@ -62,7 +62,7 @@ public final class AgentOptions { /** * Wildcard expression for class names that should be excluded from code * coverage. Default is the empty string (no exclusions). - * + * * @see WildcardMatcher */ public static final String EXCLUDES = "excludes"; @@ -73,7 +73,7 @@ public final class AgentOptions { * loader which full qualified name matches this expression will be ignored * for code coverage regardless of all other filtering settings. Default is * <code>sun.reflect.DelegatingClassLoader</code>. - * + * * @see WildcardMatcher */ public static final String EXCLCLASSLOADER = "exclclassloader"; @@ -107,7 +107,7 @@ public final class AgentOptions { /** * Specifies the output mode. Default is {@link OutputMode#file}. - * + * * @see OutputMode#file * @see OutputMode#tcpserver * @see OutputMode#tcpclient @@ -205,7 +205,7 @@ public final class AgentOptions { /** * New instance parsed from the given option string. - * + * * @param optionstr * string to parse or <code>null</code> */ @@ -234,7 +234,7 @@ public final class AgentOptions { /** * New instance read from the given {@link Properties} object. - * + * * @param properties * {@link Properties} object to read configuration options from */ @@ -261,7 +261,7 @@ public final class AgentOptions { /** * Returns the output file location. - * + * * @return output file location */ public String getDestfile() { @@ -270,7 +270,7 @@ public final class AgentOptions { /** * Sets the output file location. - * + * * @param destfile * output file location */ @@ -280,7 +280,7 @@ public final class AgentOptions { /** * Returns whether the output should be appended to an existing file. - * + * * @return <code>true</code>, when the output should be appended */ public boolean getAppend() { @@ -289,7 +289,7 @@ public final class AgentOptions { /** * Sets whether the output should be appended to an existing file. - * + * * @param append * <code>true</code>, when the output should be appended */ @@ -299,7 +299,7 @@ public final class AgentOptions { /** * Returns the wildcard expression for classes to include. - * + * * @return wildcard expression for classes to include * @see WildcardMatcher */ @@ -309,7 +309,7 @@ public final class AgentOptions { /** * Sets the wildcard expression for classes to include. - * + * * @param includes * wildcard expression for classes to include * @see WildcardMatcher @@ -320,7 +320,7 @@ public final class AgentOptions { /** * Returns the wildcard expression for classes to exclude. - * + * * @return wildcard expression for classes to exclude * @see WildcardMatcher */ @@ -330,7 +330,7 @@ public final class AgentOptions { /** * Sets the wildcard expression for classes to exclude. - * + * * @param excludes * wildcard expression for classes to exclude * @see WildcardMatcher @@ -341,7 +341,7 @@ public final class AgentOptions { /** * Returns the wildcard expression for excluded class loaders. - * + * * @return expression for excluded class loaders * @see WildcardMatcher */ @@ -351,7 +351,7 @@ public final class AgentOptions { /** * Sets the wildcard expression for excluded class loaders. - * + * * @param expression * expression for excluded class loaders * @see WildcardMatcher @@ -363,7 +363,7 @@ public final class AgentOptions { /** * Returns whether classes from the bootstrap classloader should be * instrumented. - * + * * @return <code>true</code> if classes from the bootstrap classloader * should be instrumented */ @@ -374,7 +374,7 @@ public final class AgentOptions { /** * Sets whether classes from the bootstrap classloader should be * instrumented. - * + * * @param include * <code>true</code> if bootstrap classes should be instrumented */ @@ -384,7 +384,7 @@ public final class AgentOptions { /** * Returns whether classes without source location should be instrumented. - * + * * @return <code>true</code> if classes without source location should be * instrumented */ @@ -394,7 +394,7 @@ public final class AgentOptions { /** * Sets whether classes without source location should be instrumented. - * + * * @param include * <code>true</code> if classes without source location should be * instrumented @@ -405,7 +405,7 @@ public final class AgentOptions { /** * Returns the session identifier. - * + * * @return session identifier */ public String getSessionId() { @@ -414,7 +414,7 @@ public final class AgentOptions { /** * Sets the session identifier. - * + * * @param id * session identifier */ @@ -424,7 +424,7 @@ public final class AgentOptions { /** * Returns whether coverage data should be dumped on exit. - * + * * @return <code>true</code> if coverage data will be written on VM exit */ public boolean getDumpOnExit() { @@ -433,7 +433,7 @@ public final class AgentOptions { /** * Sets whether coverage data should be dumped on exit. - * + * * @param dumpOnExit * <code>true</code> if coverage data should be written on VM * exit @@ -446,7 +446,7 @@ public final class AgentOptions { * Returns the port on which to listen to when the output is * <code>tcpserver</code> or the port to connect to when output is * <code>tcpclient</code>. - * + * * @return port to listen on or connect to */ public int getPort() { @@ -456,7 +456,7 @@ public final class AgentOptions { /** * Sets the port on which to listen to when output is <code>tcpserver</code> * or the port to connect to when output is <code>tcpclient</code> - * + * * @param port * port to listen on or connect to */ @@ -469,7 +469,7 @@ public final class AgentOptions { * Gets the hostname or IP address to listen to when output is * <code>tcpserver</code> or connect to when output is * <code>tcpclient</code> - * + * * @return Hostname or IP address */ public String getAddress() { @@ -480,7 +480,7 @@ public final class AgentOptions { * Sets the hostname or IP address to listen to when output is * <code>tcpserver</code> or connect to when output is * <code>tcpclient</code> - * + * * @param address * Hostname or IP address */ @@ -490,7 +490,7 @@ public final class AgentOptions { /** * Returns the output mode - * + * * @return current output mode */ public OutputMode getOutput() { @@ -500,7 +500,7 @@ public final class AgentOptions { /** * Sets the output mode - * + * * @param output * Output mode */ @@ -510,7 +510,7 @@ public final class AgentOptions { /** * Sets the output mode - * + * * @param output * Output mode */ @@ -521,7 +521,7 @@ public final class AgentOptions { /** * Returns the location of the directory where class files should be dumped * to. - * + * * @return dump location or <code>null</code> (no dumps) */ public String getClassDumpDir() { @@ -530,7 +530,7 @@ public final class AgentOptions { /** * Sets the directory where class files should be dumped to. - * + * * @param location * dump location or <code>null</code> (no dumps) */ @@ -540,7 +540,7 @@ public final class AgentOptions { /** * Returns whether the agent exposes functionality via JMX. - * + * * @return <code>true</code>, when JMX is enabled */ public boolean getJmx() { @@ -549,7 +549,7 @@ public final class AgentOptions { /** * Sets whether the agent should expose functionality via JMX. - * + * * @param jmx * <code>true</code> if JMX should be enabled */ @@ -587,7 +587,7 @@ public final class AgentOptions { /** * Generate required JVM argument based on current configuration and * supplied agent jar location. - * + * * @param agentJarFile * location of the JaCoCo Agent Jar * @return Argument to pass to create new VM with coverage enabled @@ -599,7 +599,7 @@ public final class AgentOptions { /** * Generate required quoted JVM argument based on current configuration and * supplied agent jar location. - * + * * @param agentJarFile * location of the JaCoCo Agent Jar * @return Quoted argument to pass to create new VM with coverage enabled @@ -613,7 +613,7 @@ public final class AgentOptions { * prepends it to the given argument command line. If a agent with the same * JAR file is already specified this parameter is removed from the existing * command line. - * + * * @param arguments * existing command line arguments or <code>null</code> * @param agentJarFile diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/CommandLineSupport.java b/org.jacoco.core/src/org/jacoco/core/runtime/CommandLineSupport.java index 3d541299..8bb4b6b3 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/CommandLineSupport.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/CommandLineSupport.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -26,7 +26,7 @@ final class CommandLineSupport { /** * Quotes a single command line argument if necessary. - * + * * @param arg * command line argument * @return quoted argument @@ -48,7 +48,7 @@ final class CommandLineSupport { /** * Builds a single command line string from the given argument list. * Arguments are quoted when necessary. - * + * * @param args * command line arguments * @return combined command line @@ -69,7 +69,7 @@ final class CommandLineSupport { /** * Splits a command line into single arguments and removes quotes if * present. - * + * * @param commandline * combined command line * @return list of arguments diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/IExecutionDataAccessorGenerator.java b/org.jacoco.core/src/org/jacoco/core/runtime/IExecutionDataAccessorGenerator.java index 295db06a..6d75d8e4 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/IExecutionDataAccessorGenerator.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/IExecutionDataAccessorGenerator.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -29,12 +29,12 @@ public interface IExecutionDataAccessorGenerator { * process will embed this code into a method that is called on class * initialization. This method can be called at any time even outside the * target VM. - * + * * The generated code must push a <code>boolean[]</code> instance to the * operand stack. Except this result object the generated code must not make * any assumptions about the structure of the embedding method or class. The * generated code must not use or allocate local variables. - * + * * @param classid * identifier of the class * @param classname diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/IRemoteCommandVisitor.java b/org.jacoco.core/src/org/jacoco/core/runtime/IRemoteCommandVisitor.java index d81c7307..e4263acf 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/IRemoteCommandVisitor.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/IRemoteCommandVisitor.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -21,7 +21,7 @@ public interface IRemoteCommandVisitor { /** * Requests a execution data dump with an optional reset. - * + * * @param dump * <code>true</code> if the dump should be executed * @param reset diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/IRuntime.java b/org.jacoco.core/src/org/jacoco/core/runtime/IRuntime.java index 37b4ac79..d9038cf0 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/IRuntime.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/IRuntime.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -21,7 +21,7 @@ public interface IRuntime extends IExecutionDataAccessorGenerator { /** * Starts the coverage runtime. This method MUST be called before any class * instrumented for this runtime is loaded. - * + * * @param data * the execution data for this runtime * @throws Exception diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/LoggerRuntime.java b/org.jacoco.core/src/org/jacoco/core/runtime/LoggerRuntime.java index ad809a3e..6f1f4e3b 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/LoggerRuntime.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/LoggerRuntime.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -25,7 +25,7 @@ import org.objectweb.asm.Opcodes; * This {@link IRuntime} implementation uses the Java logging API to report * coverage data. * <p> - * + * * The implementation uses a dedicated log channel. Instrumented classes call * {@link Logger#log(Level, String, Object[])} with the class identifier in the * first slot of the parameter array. The runtime implements a {@link Handler} diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/ModifiedSystemClassRuntime.java b/org.jacoco.core/src/org/jacoco/core/runtime/ModifiedSystemClassRuntime.java index c601e5da..74d7ddf1 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/ModifiedSystemClassRuntime.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/ModifiedSystemClassRuntime.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -45,12 +45,12 @@ public class ModifiedSystemClassRuntime extends AbstractRuntime { /** * Creates a new runtime based on the given class and members. - * + * * @param systemClass * system class that contains the execution data * @param accessFieldName * name of the public static runtime access field - * + * */ public ModifiedSystemClassRuntime(final Class<?> systemClass, final String accessFieldName) { @@ -86,13 +86,13 @@ public class ModifiedSystemClassRuntime extends AbstractRuntime { * Creates a new {@link ModifiedSystemClassRuntime} using the given class as * the data container. Member is created with internal default name. The * given class must not have been loaded before by the agent. - * + * * @param inst * instrumentation interface * @param className * VM name of the class to use * @return new runtime instance - * + * * @throws ClassNotFoundException * id the given class can not be found */ @@ -105,7 +105,7 @@ public class ModifiedSystemClassRuntime extends AbstractRuntime { * Creates a new {@link ModifiedSystemClassRuntime} using the given class as * the data container. The given class must not have been loaded before by * the agent. - * + * * @param inst * instrumentation interface * @param className @@ -113,7 +113,7 @@ public class ModifiedSystemClassRuntime extends AbstractRuntime { * @param accessFieldName * name of the added runtime access field * @return new runtime instance - * + * * @throws ClassNotFoundException * if the given class can not be found */ @@ -146,7 +146,7 @@ public class ModifiedSystemClassRuntime extends AbstractRuntime { /** * Adds the static data field to the given class definition. - * + * * @param source * class definition source * @param accessFieldName diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/OfflineInstrumentationAccessGenerator.java b/org.jacoco.core/src/org/jacoco/core/runtime/OfflineInstrumentationAccessGenerator.java index b5ae437a..e72f00c7 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/OfflineInstrumentationAccessGenerator.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/OfflineInstrumentationAccessGenerator.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -38,7 +38,7 @@ public class OfflineInstrumentationAccessGenerator /** * Creates a new instance with the given runtime class name for testing * purposes - * + * * @param runtimeClassName * VM name of the runtime class */ diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/RemoteControlReader.java b/org.jacoco.core/src/org/jacoco/core/runtime/RemoteControlReader.java index f25e3fc7..07206c36 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/RemoteControlReader.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/RemoteControlReader.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -26,7 +26,7 @@ public class RemoteControlReader extends ExecutionDataReader { /** * Create a new read based on the given input stream. - * + * * @param input * input stream to read commands from * @throws IOException @@ -51,7 +51,7 @@ public class RemoteControlReader extends ExecutionDataReader { /** * Sets an listener for agent commands. - * + * * @param visitor * visitor to retrieve agent commands */ diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/RemoteControlWriter.java b/org.jacoco.core/src/org/jacoco/core/runtime/RemoteControlWriter.java index 3a5ada52..45521042 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/RemoteControlWriter.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/RemoteControlWriter.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -31,7 +31,7 @@ public class RemoteControlWriter extends ExecutionDataWriter /** * Creates a new writer based on the given output stream. - * + * * @param output * stream to write commands to * @throws IOException @@ -44,7 +44,7 @@ public class RemoteControlWriter extends ExecutionDataWriter /** * Sends a confirmation that a commands has been successfully executed and * the response is completed. - * + * * @throws IOException * in case of problems with the remote connection */ diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/RuntimeData.java b/org.jacoco.core/src/org/jacoco/core/runtime/RuntimeData.java index cfec2103..1900d9b5 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/RuntimeData.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/RuntimeData.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -48,7 +48,7 @@ public class RuntimeData { * execution data is collected. If no identifier is explicitly set a * identifier is generated from the host name and a random number. This * method can be called at any time. - * + * * @see #collect(IExecutionDataVisitor, ISessionInfoVisitor, boolean) * @param id * new session identifier @@ -59,7 +59,7 @@ public class RuntimeData { /** * Get the current a session identifier for this runtime. - * + * * @see #setSessionId(String) * @return current session identifier */ @@ -70,7 +70,7 @@ public class RuntimeData { /** * Collects the current execution data and writes it to the given * {@link IExecutionDataVisitor} object. - * + * * @param executionDataVisitor * handler to write coverage data to * @param sessionInfoVisitor @@ -106,7 +106,7 @@ public class RuntimeData { * Returns the coverage data for the class with the given identifier. If * there is no data available under the given id a new entry is created. * This is a synchronized access to the underlying store. - * + * * @param id * class identifier * @param name @@ -126,19 +126,19 @@ public class RuntimeData { * Retrieves the execution probe array for a given class. The passed * {@link Object} array instance is used for parameters and the return value * as follows. Call parameters: - * + * * <ul> * <li>args[0]: class id ({@link Long}) * <li>args[1]: vm class name ({@link String}) * <li>args[2]: probe count ({@link Integer}) * </ul> - * + * * Return value: - * + * * <ul> * <li>args[0]: probe array (<code>boolean[]</code>) * </ul> - * + * * @param args * parameter array of length 3 */ @@ -152,7 +152,7 @@ public class RuntimeData { /** * In violation of the regular semantic of {@link Object#equals(Object)} * this implementation is used as the interface to the execution data store. - * + * * @param args * the arguments as an {@link Object} array * @return has no meaning @@ -169,7 +169,7 @@ public class RuntimeData { * Generates code that creates the argument array for the * {@link #getProbes(Object[])} method. The array instance is left on the * operand stack. The generated code requires a stack size of 5. - * + * * @param classid * class identifier * @param classname @@ -214,7 +214,7 @@ public class RuntimeData { * {@link Object} instance from the stack and pushes the probe array of type * <code>boolean[]</code> on the operand stack. The generated code requires * a stack size of 6. - * + * * @param classid * class identifier * @param classname diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/SystemPropertiesRuntime.java b/org.jacoco.core/src/org/jacoco/core/runtime/SystemPropertiesRuntime.java index d8f27f3c..62ee19b3 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/SystemPropertiesRuntime.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/SystemPropertiesRuntime.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -20,7 +20,7 @@ import org.objectweb.asm.Opcodes; * through a special entry in the {@link System#getProperties()} hash table. The * advantage is, that the instrumented classes do not get dependencies to other * classes than the JRE library itself. - * + * * This runtime may cause problems in environments with security restrictions, * in applications that replace the system properties or in applications that * fail if non-String values are placed in the system properties. diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/URLStreamHandlerRuntime.java b/org.jacoco.core/src/org/jacoco/core/runtime/URLStreamHandlerRuntime.java index df951e36..588da33d 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/URLStreamHandlerRuntime.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/URLStreamHandlerRuntime.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/WildcardMatcher.java b/org.jacoco.core/src/org/jacoco/core/runtime/WildcardMatcher.java index 1355fbb9..95316403 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/WildcardMatcher.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/WildcardMatcher.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.runtime; @@ -26,7 +26,7 @@ public class WildcardMatcher { /** * Creates a new matcher with the given expression. - * + * * @param expression * wildcard expressions */ @@ -64,7 +64,7 @@ public class WildcardMatcher { /** * Matches the given string against the expressions of this matcher. - * + * * @param s * string to test * @return <code>true</code>, if the expression matches diff --git a/org.jacoco.core/src/org/jacoco/core/runtime/package-info.java b/org.jacoco.core/src/org/jacoco/core/runtime/package-info.java index 6265d8a0..a4817eda 100644 --- a/org.jacoco.core/src/org/jacoco/core/runtime/package-info.java +++ b/org.jacoco.core/src/org/jacoco/core/runtime/package-info.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ /** diff --git a/org.jacoco.core/src/org/jacoco/core/tools/ExecDumpClient.java b/org.jacoco.core/src/org/jacoco/core/tools/ExecDumpClient.java index 8ba4188b..097ff917 100644 --- a/org.jacoco.core/src/org/jacoco/core/tools/ExecDumpClient.java +++ b/org.jacoco.core/src/org/jacoco/core/tools/ExecDumpClient.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.tools; @@ -44,7 +44,7 @@ public class ExecDumpClient { /** * Specifies whether a dump should be requested - * + * * @param dump * <code>true</code> if a dump should be requested */ @@ -54,7 +54,7 @@ public class ExecDumpClient { /** * Specifies whether execution data should be reset. - * + * * @param reset * <code>true</code> if execution data should be reset */ @@ -65,7 +65,7 @@ public class ExecDumpClient { /** * Sets the number of retry attempts to connect to the target socket. This * allows to wait for a certain time until the target agent has initialized. - * + * * @param retryCount * number of retries */ @@ -75,7 +75,7 @@ public class ExecDumpClient { /** * Sets the delay time before between connection attempts. - * + * * @param retryDelay * delay in milliseconds */ @@ -85,7 +85,7 @@ public class ExecDumpClient { /** * Requests a dump from the given end-point. - * + * * @param address * IP-Address to connect to * @param port @@ -101,7 +101,7 @@ public class ExecDumpClient { /** * Requests a dump from the given end-point. - * + * * @param address * host name or IP-Address to connect to * @param port @@ -163,7 +163,7 @@ public class ExecDumpClient { /** * This method can be overwritten to get an event just before a connection * is made. - * + * * @param address * target address * @param port @@ -177,7 +177,7 @@ public class ExecDumpClient { /** * This method can be overwritten to get an event for connection failures * when another retry will be attempted. - * + * * @param exception * connection error */ diff --git a/org.jacoco.core/src/org/jacoco/core/tools/ExecFileLoader.java b/org.jacoco.core/src/org/jacoco/core/tools/ExecFileLoader.java index ba308e1d..add2dcb3 100644 --- a/org.jacoco.core/src/org/jacoco/core/tools/ExecFileLoader.java +++ b/org.jacoco.core/src/org/jacoco/core/tools/ExecFileLoader.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ package org.jacoco.core.tools; @@ -46,7 +46,7 @@ public class ExecFileLoader { /** * Reads all data from given input stream. - * + * * @param stream * Stream to read data from * @throws IOException @@ -62,7 +62,7 @@ public class ExecFileLoader { /** * Reads all data from given input stream. - * + * * @param file * file to read data from * @throws IOException @@ -79,7 +79,7 @@ public class ExecFileLoader { /** * Saves the current content into the given output stream. - * + * * @param stream * stream to save content to * @throws IOException @@ -95,7 +95,7 @@ public class ExecFileLoader { * Saves the current content into the given file. Parent directories are * created as needed. Also a files system lock is acquired to avoid * concurrent write access. - * + * * @param file * file to save content to * @param append @@ -123,7 +123,7 @@ public class ExecFileLoader { /** * Returns the session info store with all loaded sessions. - * + * * @return session info store */ public SessionInfoStore getSessionInfoStore() { @@ -132,7 +132,7 @@ public class ExecFileLoader { /** * Returns the execution data store with data for all loaded classes. - * + * * @return execution data store */ public ExecutionDataStore getExecutionDataStore() { diff --git a/org.jacoco.core/src/org/jacoco/core/tools/package-info.java b/org.jacoco.core/src/org/jacoco/core/tools/package-info.java index a4d0d925..2b4f87ac 100644 --- a/org.jacoco.core/src/org/jacoco/core/tools/package-info.java +++ b/org.jacoco.core/src/org/jacoco/core/tools/package-info.java @@ -8,7 +8,7 @@ * * Contributors: * Marc R. Hoffmann - initial API and implementation - * + * *******************************************************************************/ /** |