From 6478577899b2df4df7275b8d0b1429d924b34b2a Mon Sep 17 00:00:00 2001 From: Matthias Sohn Date: Mon, 18 Dec 2017 11:34:31 +0100 Subject: [PATCH] Fix javadoc in org.eclipse.jgit errors package Change-Id: I46aa5c3073b99a311a1a97fc57d8f29d32524482 Signed-off-by: Matthias Sohn --- .../jgit/errors/AmbiguousObjectException.java | 16 +++++++++++--- .../jgit/errors/CancelledException.java | 3 +++ .../errors/CheckoutConflictException.java | 4 ++++ .../jgit/errors/CommandFailedException.java | 6 ++++++ .../jgit/errors/CompoundException.java | 4 +++- .../jgit/errors/ConfigInvalidException.java | 4 +++- .../jgit/errors/CorruptObjectException.java | 8 ++++++- .../jgit/errors/DiffInterruptedException.java | 11 +++++++++- .../errors/DirCacheNameConflictException.java | 12 +++++++++-- .../errors/IllegalTodoFileModification.java | 3 +++ .../jgit/errors/InvalidObjectIdException.java | 4 +++- .../jgit/errors/InvalidPatternException.java | 5 ++++- .../jgit/errors/LargeObjectException.java | 21 +++++++++++++++---- .../jgit/errors/LockFailedException.java | 5 ++++- .../jgit/errors/MissingObjectException.java | 6 +++++- .../errors/NoClosingBracketException.java | 2 ++ .../jgit/errors/NoMergeBaseException.java | 2 ++ .../jgit/errors/NoWorkTreeException.java | 8 ++++--- .../jgit/errors/PackInvalidException.java | 4 +++- .../jgit/errors/PackMismatchException.java | 4 +++- .../errors/RepositoryNotFoundException.java | 4 +++- .../eclipse/jgit/errors/RevWalkException.java | 10 ++++----- .../jgit/errors/RevisionSyntaxException.java | 1 + ...ctRepresentationNotAvailableException.java | 4 +++- .../errors/TooLargeObjectInPackException.java | 6 +++++- .../errors/TranslationBundleException.java | 10 ++++++--- .../TranslationBundleLoadingException.java | 9 ++++---- .../TranslationStringMissingException.java | 10 +++++---- .../jgit/errors/UnmergedPathException.java | 6 +++++- .../eclipse/jgit/errors/UnpackException.java | 4 +++- .../errors/UnsupportedCredentialItem.java | 7 +++---- 31 files changed, 156 insertions(+), 47 deletions(-) diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/AmbiguousObjectException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/AmbiguousObjectException.java index 93d57f01a..389ec45d1 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/AmbiguousObjectException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/AmbiguousObjectException.java @@ -51,7 +51,9 @@ import org.eclipse.jgit.internal.JGitText; import org.eclipse.jgit.lib.AbbreviatedObjectId; import org.eclipse.jgit.lib.ObjectId; -/** An {@link AbbreviatedObjectId} cannot be extended. */ +/** + * An {@link org.eclipse.jgit.lib.AbbreviatedObjectId} cannot be extended. + */ public class AmbiguousObjectException extends IOException { private static final long serialVersionUID = 1L; @@ -76,12 +78,20 @@ public class AmbiguousObjectException extends IOException { this.candidates = candidates; } - /** @return the AbbreviatedObjectId that has more than one result. */ + /** + * Get the {@code AbbreviatedObjectId} that has more than one result + * + * @return the {@code AbbreviatedObjectId} that has more than one result + */ public AbbreviatedObjectId getAbbreviatedObjectId() { return missing; } - /** @return the matching candidates (or at least a subset of them). */ + /** + * Get the matching candidates (or at least a subset of them) + * + * @return the matching candidates (or at least a subset of them) + */ public Collection getCandidates() { return candidates; } diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/CancelledException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/CancelledException.java index c2833a161..d7c553cf6 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/CancelledException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/CancelledException.java @@ -54,7 +54,10 @@ public class CancelledException extends IOException { private static final long serialVersionUID = 1L; /** + * Constructor for CancelledException + * * @param message + * error message */ public CancelledException(String message) { super(message); diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/CheckoutConflictException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/CheckoutConflictException.java index b6010b698..9b7b618e4 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/CheckoutConflictException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/CheckoutConflictException.java @@ -62,6 +62,7 @@ public class CheckoutConflictException extends IOException { * Construct a CheckoutConflictException for the specified file * * @param file + * relative path of a file */ public CheckoutConflictException(String file) { super(MessageFormat.format(JGitText.get().checkoutConflictWithFile, file)); @@ -72,6 +73,7 @@ public class CheckoutConflictException extends IOException { * Construct a CheckoutConflictException for the specified set of files * * @param files + * an array of relative file paths */ public CheckoutConflictException(String[] files) { super(MessageFormat.format(JGitText.get().checkoutConflictWithFiles, buildList(files))); @@ -79,6 +81,8 @@ public class CheckoutConflictException extends IOException { } /** + * Get the relative paths of the conflicting files + * * @return the relative paths of the conflicting files (relative to the * working directory root). * @since 4.4 diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/CommandFailedException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/CommandFailedException.java index 93749f5e4..5df41c283 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/CommandFailedException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/CommandFailedException.java @@ -54,6 +54,8 @@ public class CommandFailedException extends Exception { private int returnCode; /** + * Constructor for CommandFailedException + * * @param returnCode * return code returned by the command * @param message @@ -65,6 +67,8 @@ public class CommandFailedException extends Exception { } /** + * Constructor for CommandFailedException + * * @param returnCode * return code returned by the command * @param message @@ -79,6 +83,8 @@ public class CommandFailedException extends Exception { } /** + * Get return code returned by the command + * * @return return code returned by the command */ public int getReturnCode() { diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/CompoundException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/CompoundException.java index 3a7b2c66d..62ff99088 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/CompoundException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/CompoundException.java @@ -50,7 +50,9 @@ import java.util.List; import org.eclipse.jgit.internal.JGitText; -/** An exception detailing multiple reasons for failure. */ +/** + * An exception detailing multiple reasons for failure. + */ public class CompoundException extends Exception { private static final long serialVersionUID = 1L; diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/ConfigInvalidException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/ConfigInvalidException.java index 43fb4bcf8..a7e1d02b4 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/ConfigInvalidException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/ConfigInvalidException.java @@ -43,7 +43,9 @@ package org.eclipse.jgit.errors; -/** Indicates a text string is not a valid Git style configuration. */ +/** + * Indicates a text string is not a valid Git style configuration. + */ public class ConfigInvalidException extends Exception { private static final long serialVersionUID = 1L; diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/CorruptObjectException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/CorruptObjectException.java index e4db40b88..4b503a302 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/CorruptObjectException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/CorruptObjectException.java @@ -86,7 +86,9 @@ public class CorruptObjectException extends IOException { * object id * * @param id + * a {@link org.eclipse.jgit.lib.AnyObjectId} * @param why + * error message */ public CorruptObjectException(AnyObjectId id, String why) { super(MessageFormat.format(JGitText.get().objectIsCorrupt, id.name(), why)); @@ -97,7 +99,9 @@ public class CorruptObjectException extends IOException { * object id * * @param id + * a {@link org.eclipse.jgit.lib.ObjectId} * @param why + * error message */ public CorruptObjectException(ObjectId id, String why) { super(MessageFormat.format(JGitText.get().objectIsCorrupt, id.name(), why)); @@ -108,6 +112,7 @@ public class CorruptObjectException extends IOException { * with a specific object id. * * @param why + * error message */ public CorruptObjectException(String why) { super(why); @@ -129,7 +134,8 @@ public class CorruptObjectException extends IOException { } /** - * Specific error condition identified by {@link ObjectChecker}. + * Specific error condition identified by + * {@link org.eclipse.jgit.lib.ObjectChecker}. * * @return error condition or null. * @since 4.2 diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/DiffInterruptedException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/DiffInterruptedException.java index 5f9ce351a..1df877313 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/DiffInterruptedException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/DiffInterruptedException.java @@ -53,8 +53,12 @@ public class DiffInterruptedException extends RuntimeException { private static final long serialVersionUID = 1L; /** + * Constructor for DiffInterruptedException + * * @param message + * error message * @param cause + * a {@link java.lang.Throwable} * @since 4.1 */ public DiffInterruptedException(String message, Throwable cause) { @@ -62,14 +66,19 @@ public class DiffInterruptedException extends RuntimeException { } /** + * Constructor for DiffInterruptedException + * * @param message + * error message * @since 4.1 */ public DiffInterruptedException(String message) { super(message); } - /** Indicates that the thread computing a diff was interrupted. */ + /** + * Indicates that the thread computing a diff was interrupted. + */ public DiffInterruptedException() { super(); } diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/DirCacheNameConflictException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/DirCacheNameConflictException.java index 5f67e3439..4d08dfd81 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/DirCacheNameConflictException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/DirCacheNameConflictException.java @@ -68,12 +68,20 @@ public class DirCacheNameConflictException extends IllegalStateException { this.path2 = path2; } - /** @return one of the paths that has a conflict. */ + /** + * Get one of the paths that has a conflict + * + * @return one of the paths that has a conflict + */ public String getPath1() { return path1; } - /** @return another path that has a conflict. */ + /** + * Get another path that has a conflict + * + * @return another path that has a conflict + */ public String getPath2() { return path2; } diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/IllegalTodoFileModification.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/IllegalTodoFileModification.java index dae150ce0..a6471217e 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/IllegalTodoFileModification.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/IllegalTodoFileModification.java @@ -51,7 +51,10 @@ public class IllegalTodoFileModification extends Exception { private static final long serialVersionUID = 1L; /** + * Constructor for IllegalTodoFileModification + * * @param msg + * error message */ public IllegalTodoFileModification(final String msg) { super(msg); diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/InvalidObjectIdException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/InvalidObjectIdException.java index 390545ffa..4abbf1e2c 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/InvalidObjectIdException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/InvalidObjectIdException.java @@ -69,8 +69,10 @@ public class InvalidObjectIdException extends IllegalArgumentException { } /** - * @param id the invalid id. + * Constructor for InvalidObjectIdException * + * @param id + * the invalid id. * @since 4.1 */ public InvalidObjectIdException(String id) { diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/InvalidPatternException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/InvalidPatternException.java index 18e78ffe7..a78a6d2ac 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/InvalidPatternException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/InvalidPatternException.java @@ -47,7 +47,6 @@ package org.eclipse.jgit.errors; /** * Thrown when a pattern passed in an argument was wrong. - * */ public class InvalidPatternException extends Exception { private static final long serialVersionUID = 1L; @@ -55,6 +54,8 @@ public class InvalidPatternException extends Exception { private final String pattern; /** + * Constructor for InvalidPatternException + * * @param message * explains what was wrong with the pattern. * @param pattern @@ -66,6 +67,8 @@ public class InvalidPatternException extends Exception { } /** + * Get the invalid pattern + * * @return the invalid pattern. */ public String getPattern() { diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/LargeObjectException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/LargeObjectException.java index a69bdc481..8873f7e68 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/LargeObjectException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/LargeObjectException.java @@ -49,13 +49,17 @@ import org.eclipse.jgit.internal.JGitText; import org.eclipse.jgit.lib.AnyObjectId; import org.eclipse.jgit.lib.ObjectId; -/** An object is too big to load into memory as a single byte array. */ +/** + * An object is too big to load into memory as a single byte array. + */ public class LargeObjectException extends RuntimeException { private static final long serialVersionUID = 1L; private ObjectId objectId; - /** Create a large object exception, where the object isn't known. */ + /** + * Create a large object exception, where the object isn't known. + */ public LargeObjectException() { // Do nothing. } @@ -71,12 +75,20 @@ public class LargeObjectException extends RuntimeException { setObjectId(id); } - /** @return identity of the object that is too large; may be null. */ + /** + * Get identity of the object that is too large; may be null + * + * @return identity of the object that is too large; may be null + */ public ObjectId getObjectId() { return objectId; } - /** @return either the hex encoded name of the object, or 'unknown object'. */ + /** + * Get the hex encoded name of the object, or 'unknown object' + * + * @return either the hex encoded name of the object, or 'unknown object' + */ protected String getObjectName() { if (getObjectId() != null) return getObjectId().name(); @@ -94,6 +106,7 @@ public class LargeObjectException extends RuntimeException { objectId = id.copy(); } + /** {@inheritDoc} */ @Override public String getMessage() { return MessageFormat.format(JGitText.get().largeObjectException, diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/LockFailedException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/LockFailedException.java index 0142e1763..bf958bd33 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/LockFailedException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/LockFailedException.java @@ -57,12 +57,15 @@ public class LockFailedException extends IOException { private File file; /** + * Constructor for LockFailedException + * * @param file * file that could not be locked * @param message * exception message * @param cause - * cause, for later retrieval by {@link Throwable#getCause()} + * cause, for later retrieval by + * {@link java.lang.Throwable#getCause()} * @since 4.1 */ public LockFailedException(File file, String message, Throwable cause) { diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/MissingObjectException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/MissingObjectException.java index d1157c4e3..f6aa092db 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/MissingObjectException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/MissingObjectException.java @@ -100,7 +100,11 @@ public class MissingObjectException extends IOException { missing = null; } - /** @return the ObjectId that was not found. */ + /** + * Get the ObjectId that was not found + * + * @return the ObjectId that was not found + */ public ObjectId getObjectId() { return missing; } diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoClosingBracketException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoClosingBracketException.java index 6601591f0..1f79c5d46 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoClosingBracketException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoClosingBracketException.java @@ -58,6 +58,8 @@ public class NoClosingBracketException extends InvalidPatternException { private static final long serialVersionUID = 1L; /** + * Constructor for NoClosingBracketException + * * @param indexOfOpeningBracket * the position of the [ character which has no ] character. * @param openingBracket diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoMergeBaseException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoMergeBaseException.java index 0c419d759..97214b0ed 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoMergeBaseException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoMergeBaseException.java @@ -118,6 +118,8 @@ public class NoMergeBaseException extends IOException { } /** + * Get the reason why no merge base could be found + * * @return the reason why no merge base could be found */ public MergeBaseFailureReason getReason() { diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoWorkTreeException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoWorkTreeException.java index 6f61806b2..82ed7efc8 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoWorkTreeException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/NoWorkTreeException.java @@ -44,15 +44,17 @@ package org.eclipse.jgit.errors; import org.eclipse.jgit.internal.JGitText; -import org.eclipse.jgit.lib.Repository; /** - * Indicates a {@link Repository} has no working directory, and is thus bare. + * Indicates a {@link org.eclipse.jgit.lib.Repository} has no working directory, + * and is thus bare. */ public class NoWorkTreeException extends IllegalStateException { private static final long serialVersionUID = 1L; - /** Creates an exception indicating there is no work tree for a repository. */ + /** + * Creates an exception indicating there is no work tree for a repository. + */ public NoWorkTreeException() { super(JGitText.get().bareRepositoryNoWorkdirAndIndex); } diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/PackInvalidException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/PackInvalidException.java index 8c216c3d4..9886e15dd 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/PackInvalidException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/PackInvalidException.java @@ -49,7 +49,9 @@ import java.text.MessageFormat; import org.eclipse.jgit.internal.JGitText; -/** Thrown when a PackFile previously failed and is known to be unusable */ +/** + * Thrown when a PackFile previously failed and is known to be unusable + */ public class PackInvalidException extends IOException { private static final long serialVersionUID = 1L; diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/PackMismatchException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/PackMismatchException.java index b82846530..5b9a4b93b 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/PackMismatchException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/PackMismatchException.java @@ -45,7 +45,9 @@ package org.eclipse.jgit.errors; import java.io.IOException; -/** Thrown when a PackFile no longer matches the PackIndex. */ +/** + * Thrown when a PackFile no longer matches the PackIndex. + */ public class PackMismatchException extends IOException { private static final long serialVersionUID = 1L; diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/RepositoryNotFoundException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/RepositoryNotFoundException.java index 33429d6e6..aabb46ad4 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/RepositoryNotFoundException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/RepositoryNotFoundException.java @@ -48,7 +48,9 @@ import java.text.MessageFormat; import org.eclipse.jgit.internal.JGitText; -/** Indicates a local repository does not exist. */ +/** + * Indicates a local repository does not exist. + */ public class RepositoryNotFoundException extends TransportException { private static final long serialVersionUID = 1L; diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/RevWalkException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/RevWalkException.java index 757a45b6d..82654e8bd 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/RevWalkException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/RevWalkException.java @@ -45,16 +45,16 @@ package org.eclipse.jgit.errors; import org.eclipse.jgit.internal.JGitText; -import org.eclipse.jgit.revwalk.RevWalk; /** - * Indicates a checked exception was thrown inside of {@link RevWalk}. + * Indicates a checked exception was thrown inside of + * {@link org.eclipse.jgit.revwalk.RevWalk}. *

* Usually this exception is thrown from the Iterator created around a RevWalk * instance, as the Iterator API does not allow checked exceptions to be thrown - * from hasNext() or next(). The {@link Exception#getCause()} of this exception - * is the original checked exception that we really wanted to throw back to the - * application for handling and recovery. + * from hasNext() or next(). The {@link java.lang.Exception#getCause()} of this + * exception is the original checked exception that we really wanted to throw + * back to the application for handling and recovery. */ public class RevWalkException extends RuntimeException { private static final long serialVersionUID = 1L; diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/RevisionSyntaxException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/RevisionSyntaxException.java index a039c7d14..be3ca1b1e 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/RevisionSyntaxException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/RevisionSyntaxException.java @@ -77,6 +77,7 @@ public class RevisionSyntaxException extends IllegalArgumentException { this.revstr = revstr; } + /** {@inheritDoc} */ @Override public String toString() { return super.toString() + ":" + revstr; //$NON-NLS-1$ diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/StoredObjectRepresentationNotAvailableException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/StoredObjectRepresentationNotAvailableException.java index 0bd035b5d..bb11c9623 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/StoredObjectRepresentationNotAvailableException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/StoredObjectRepresentationNotAvailableException.java @@ -45,7 +45,9 @@ package org.eclipse.jgit.errors; import org.eclipse.jgit.internal.storage.pack.ObjectToPack; -/** A previously selected representation is no longer available. */ +/** + * A previously selected representation is no longer available. + */ public class StoredObjectRepresentationNotAvailableException extends Exception { private static final long serialVersionUID = 1L; diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/TooLargeObjectInPackException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/TooLargeObjectInPackException.java index ece76ed28..fb413d82d 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/TooLargeObjectInPackException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/TooLargeObjectInPackException.java @@ -48,7 +48,9 @@ import java.text.MessageFormat; import org.eclipse.jgit.internal.JGitText; import org.eclipse.jgit.transport.URIish; -/** Thrown when PackParser finds an object larger than a predefined limit */ +/** + * Thrown when PackParser finds an object larger than a predefined limit + */ public class TooLargeObjectInPackException extends TransportException { private static final long serialVersionUID = 1L; @@ -72,7 +74,9 @@ public class TooLargeObjectInPackException extends TransportException { * too large object is known. * * @param objectSize + * a long. * @param maxObjectSizeLimit + * a long. */ public TooLargeObjectInPackException(long objectSize, long maxObjectSizeLimit) { diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationBundleException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationBundleException.java index dc5f7a43c..70760f36b 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationBundleException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationBundleException.java @@ -43,7 +43,6 @@ package org.eclipse.jgit.errors; import java.util.Locale; -import java.util.ResourceBundle; /** * Common base class for all translation bundle related exceptions. @@ -55,7 +54,8 @@ public abstract class TranslationBundleException extends RuntimeException { private final Locale locale; /** - * To construct an instance of {@link TranslationBundleException} + * Construct an instance of + * {@link org.eclipse.jgit.errors.TranslationBundleException} * * @param message * exception message @@ -65,7 +65,7 @@ public abstract class TranslationBundleException extends RuntimeException { * locale for which the exception occurred * @param cause * original exception that caused this exception. Usually thrown - * from the {@link ResourceBundle} class. + * from the {@link java.util.ResourceBundle} class. */ protected TranslationBundleException(String message, Class bundleClass, Locale locale, Exception cause) { super(message, cause); @@ -74,6 +74,8 @@ public abstract class TranslationBundleException extends RuntimeException { } /** + * Get bundle class + * * @return bundle class for which the exception occurred */ final public Class getBundleClass() { @@ -81,6 +83,8 @@ public abstract class TranslationBundleException extends RuntimeException { } /** + * Get locale for which the exception occurred + * * @return locale for which the exception occurred */ final public Locale getLocale() { diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationBundleLoadingException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationBundleLoadingException.java index 6cb332d48..4033ee17d 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationBundleLoadingException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationBundleLoadingException.java @@ -43,7 +43,6 @@ package org.eclipse.jgit.errors; import java.util.Locale; -import java.util.ResourceBundle; /** * This exception will be thrown when a translation bundle loading @@ -53,8 +52,9 @@ public class TranslationBundleLoadingException extends TranslationBundleExceptio private static final long serialVersionUID = 1L; /** - * Construct a {@link TranslationBundleLoadingException} for the specified - * bundle class and locale. + * Construct a + * {@link org.eclipse.jgit.errors.TranslationBundleLoadingException} for the + * specified bundle class and locale. * * @param bundleClass * the bundle class for which the loading failed @@ -62,7 +62,8 @@ public class TranslationBundleLoadingException extends TranslationBundleExceptio * the locale for which the loading failed * @param cause * the original exception thrown from the - * {@link ResourceBundle#getBundle(String, Locale)} method. + * {@link java.util.ResourceBundle#getBundle(String, Locale)} + * method. */ public TranslationBundleLoadingException(Class bundleClass, Locale locale, Exception cause) { super("Loading of translation bundle failed for [" //$NON-NLS-1$ diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationStringMissingException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationStringMissingException.java index 05c38424e..d30c1be08 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationStringMissingException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/TranslationStringMissingException.java @@ -43,7 +43,6 @@ package org.eclipse.jgit.errors; import java.util.Locale; -import java.util.ResourceBundle; /** * This exception will be thrown when a translation string for a translation @@ -55,8 +54,9 @@ public class TranslationStringMissingException extends TranslationBundleExceptio private final String key; /** - * Construct a {@link TranslationStringMissingException} for the specified - * bundle class, locale and translation key + * Construct a + * {@link org.eclipse.jgit.errors.TranslationStringMissingException} for the + * specified bundle class, locale and translation key * * @param bundleClass * the bundle class for which a translation string was missing @@ -66,7 +66,7 @@ public class TranslationStringMissingException extends TranslationBundleExceptio * the key of the missing translation string * @param cause * the original exception thrown from the - * {@link ResourceBundle#getString(String)} method. + * {@link java.util.ResourceBundle#getString(String)} method. */ public TranslationStringMissingException(Class bundleClass, Locale locale, String key, Exception cause) { super("Translation missing for [" + bundleClass.getName() + ", " //$NON-NLS-1$ //$NON-NLS-2$ @@ -76,6 +76,8 @@ public class TranslationStringMissingException extends TranslationBundleExceptio } /** + * Get the key of the missing translation string + * * @return the key of the missing translation string */ public String getKey() { diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnmergedPathException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnmergedPathException.java index 3dbfb5f95..4fc534b94 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnmergedPathException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnmergedPathException.java @@ -68,7 +68,11 @@ public class UnmergedPathException extends IOException { entry = dce; } - /** @return the first non-zero stage of the unmerged path */ + /** + * Get the first non-zero stage of the unmerged path + * + * @return the first non-zero stage of the unmerged path + */ public DirCacheEntry getDirCacheEntry() { return entry; } diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnpackException.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnpackException.java index a9b01138c..0e0ff580c 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnpackException.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnpackException.java @@ -47,7 +47,9 @@ import java.io.IOException; import org.eclipse.jgit.internal.JGitText; -/** Indicates a ReceivePack failure while scanning the pack stream. */ +/** + * Indicates a ReceivePack failure while scanning the pack stream. + */ public class UnpackException extends IOException { private static final long serialVersionUID = 1L; diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnsupportedCredentialItem.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnsupportedCredentialItem.java index daba576ca..88c2ef623 100644 --- a/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnsupportedCredentialItem.java +++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/UnsupportedCredentialItem.java @@ -43,13 +43,12 @@ */ package org.eclipse.jgit.errors; -import org.eclipse.jgit.transport.CredentialItem; -import org.eclipse.jgit.transport.CredentialsProvider; import org.eclipse.jgit.transport.URIish; /** - * An exception thrown when a {@link CredentialItem} is requested from a - * {@link CredentialsProvider} which is not supported by this provider. + * An exception thrown when a {@link org.eclipse.jgit.transport.CredentialItem} + * is requested from a {@link org.eclipse.jgit.transport.CredentialsProvider} + * which is not supported by this provider. */ public class UnsupportedCredentialItem extends RuntimeException { private static final long serialVersionUID = 1L;