Index: trunk/src/org/openstreetmap/josm/io/CachedFile.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/CachedFile.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/CachedFile.java (revision 8470) @@ -136,5 +136,5 @@ /** * Set the caching strategy. Only applies to URLs. - * @param cachingStrategy + * @param cachingStrategy caching strategy * @return this object */ Index: trunk/src/org/openstreetmap/josm/io/Compression.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/Compression.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/Compression.java (revision 8470) @@ -55,5 +55,5 @@ * Returns an un-compressing {@link InputStream} for {@code in}. * - * @throws IOException + * @throws IOException if any I/O error occurs */ public InputStream getUncompressedInputStream(InputStream in) throws IOException { @@ -74,5 +74,5 @@ * Returns an un-compressing {@link InputStream} for the {@link File} {@code file}. * - * @throws IOException + * @throws IOException if any I/O error occurs */ @SuppressWarnings("resource") @@ -84,5 +84,5 @@ * Returns an un-compressing {@link InputStream} for the {@link URL} {@code url}. * - * @throws IOException + * @throws IOException if any I/O error occurs */ public static InputStream getUncompressedURLInputStream(URL url) throws IOException { @@ -93,5 +93,5 @@ * Returns a compressing {@link OutputStream} for {@code out}. * - * @throws IOException + * @throws IOException if any I/O error occurs */ public OutputStream getCompressedOutputStream(OutputStream out) throws IOException { @@ -112,5 +112,5 @@ * Returns a compressing {@link OutputStream} for the {@link File} {@code file}. * - * @throws IOException + * @throws IOException if any I/O error occurs */ @SuppressWarnings("resource") Index: trunk/src/org/openstreetmap/josm/io/GpxReader.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/GpxReader.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/GpxReader.java (revision 8470) @@ -534,6 +534,6 @@ * @return true if file was properly parsed, false if there was error during * parsing but some data were parsed anyway - * @throws SAXException - * @throws IOException + * @throws SAXException if any SAX parsing error occurs + * @throws IOException if any I/O error occurs */ public boolean parse(boolean tryToFinish) throws SAXException, IOException { Index: trunk/src/org/openstreetmap/josm/io/NoteReader.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/NoteReader.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/NoteReader.java (revision 8470) @@ -197,5 +197,5 @@ * Initializes the reader with a given InputStream * @param source - InputStream containing Notes XML - * @throws IOException + * @throws IOException if any I/O error occurs */ public NoteReader(InputStream source) throws IOException { @@ -206,5 +206,5 @@ * Initializes the reader with a string as a source * @param source UTF-8 string containing Notes XML to parse - * @throws IOException + * @throws IOException if any I/O error occurs */ public NoteReader(String source) throws IOException { @@ -216,6 +216,6 @@ * the resulting Note objects * @return List of Notes parsed from the input data - * @throws SAXException - * @throws IOException + * @throws SAXException if any SAX parsing error occurs + * @throws IOException if any I/O error occurs */ public List parse() throws SAXException, IOException { Index: trunk/src/org/openstreetmap/josm/io/OsmApi.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/OsmApi.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/OsmApi.java (revision 8470) @@ -802,5 +802,5 @@ * @param monitor Progress monitor * @return Note as it exists on the server after creation (ID assigned) - * @throws OsmTransferException + * @throws OsmTransferException if any error occurs during dialog with OSM API */ public Note createNote(LatLon latlon, String text, ProgressMonitor monitor) throws OsmTransferException { @@ -824,5 +824,5 @@ * @param monitor Progress monitor * @return Note returned by the API after the comment was added - * @throws OsmTransferException + * @throws OsmTransferException if any error occurs during dialog with OSM API */ public Note addCommentToNote(Note note, String comment, ProgressMonitor monitor) throws OsmTransferException { @@ -842,5 +842,5 @@ * @param monitor Progress monitor * @return Note returned by the API after the close operation - * @throws OsmTransferException + * @throws OsmTransferException if any error occurs during dialog with OSM API */ public Note closeNote(Note note, String closeMessage, ProgressMonitor monitor) throws OsmTransferException { @@ -864,5 +864,5 @@ * @param monitor Progress monitor * @return Note returned by the API after the reopen operation - * @throws OsmTransferException + * @throws OsmTransferException if any error occurs during dialog with OSM API */ public Note reopenNote(Note note, String reactivateMessage, ProgressMonitor monitor) throws OsmTransferException { Index: trunk/src/org/openstreetmap/josm/io/OsmServerBackreferenceReader.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/OsmServerBackreferenceReader.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/OsmServerBackreferenceReader.java (revision 8470) @@ -149,5 +149,5 @@ * * @return the data set - * @throws OsmTransferException + * @throws OsmTransferException if any error occurs during dialog with OSM API */ protected DataSet getReferringWays(ProgressMonitor progressMonitor) throws OsmTransferException { @@ -160,5 +160,5 @@ * @param progressMonitor the progress monitor * @return the data set - * @throws OsmTransferException + * @throws OsmTransferException if any error occurs during dialog with OSM API */ protected DataSet getReferringRelations(ProgressMonitor progressMonitor) throws OsmTransferException { Index: trunk/src/org/openstreetmap/josm/io/OsmServerObjectReader.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/OsmServerObjectReader.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/OsmServerObjectReader.java (revision 8470) @@ -106,5 +106,5 @@ * @param progressMonitor the progress monitor. Set to {@link NullProgressMonitor#INSTANCE} if null * @return the downloaded data - * @throws OsmTransferException + * @throws OsmTransferException if any error occurs during dialog with OSM API */ @Override Index: trunk/src/org/openstreetmap/josm/io/OsmServerReader.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/OsmServerReader.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/OsmServerReader.java (revision 8470) @@ -366,7 +366,7 @@ * Downloads notes from a given raw URL. The URL is assumed to be complete and no API limits are added * - * @param progressMonitor + * @param progressMonitor progress monitor * @return A list of notes parsed from the URL - * @throws OsmTransferException + * @throws OsmTransferException if any error occurs during dialog with OSM API */ public List parseRawNotes(final ProgressMonitor progressMonitor) throws OsmTransferException { @@ -376,7 +376,7 @@ /** * Download notes from a URL that contains a bzip2 compressed notes dump file - * @param progressMonitor + * @param progressMonitor progress monitor * @return A list of notes parsed from the URL - * @throws OsmTransferException + * @throws OsmTransferException if any error occurs during dialog with OSM API */ public List parseRawNotesBzip2(final ProgressMonitor progressMonitor) throws OsmTransferException { Index: trunk/src/org/openstreetmap/josm/io/ProgressInputStream.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/ProgressInputStream.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/ProgressInputStream.java (revision 8470) @@ -78,5 +78,5 @@ /** * Increase ticker (progress counter and displayed text) by the given amount. - * @param amount + * @param amount number of ticks */ private void advanceTicker(int amount) { Index: trunk/src/org/openstreetmap/josm/io/remotecontrol/RemoteControlHttpServer.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/remotecontrol/RemoteControlHttpServer.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/remotecontrol/RemoteControlHttpServer.java (revision 8470) @@ -113,5 +113,5 @@ * Stops the HTTP server * - * @throws IOException + * @throws IOException if any I/O error occurs */ public void stopServer() throws IOException { Index: trunk/src/org/openstreetmap/josm/io/remotecontrol/RemoteControlHttpsServer.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/remotecontrol/RemoteControlHttpsServer.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/remotecontrol/RemoteControlHttpsServer.java (revision 8470) @@ -114,5 +114,5 @@ * @param v value * @return which one - * @throws IOException + * @throws IOException if any I/O error occurs */ private static GeneralName createGeneralName(String t, String v) throws IOException { Index: trunk/src/org/openstreetmap/josm/io/remotecontrol/handler/AddNodeHandler.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/remotecontrol/handler/AddNodeHandler.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/remotecontrol/handler/AddNodeHandler.java (revision 8470) @@ -76,5 +76,5 @@ /** * Adds a node, implements the GET /add_node?lon=...&lat=... request. - * @param args + * @param args request arguments */ private void addNode(Map args){ Index: trunk/src/org/openstreetmap/josm/io/remotecontrol/handler/RequestHandler.java =================================================================== --- trunk/src/org/openstreetmap/josm/io/remotecontrol/handler/RequestHandler.java (revision 8465) +++ trunk/src/org/openstreetmap/josm/io/remotecontrol/handler/RequestHandler.java (revision 8470) @@ -57,7 +57,7 @@ * Check permission and parameters and handle request. * - * @throws RequestHandlerForbiddenException - * @throws RequestHandlerBadRequestException - * @throws RequestHandlerErrorException + * @throws RequestHandlerForbiddenException if request is forbidden by preferences + * @throws RequestHandlerBadRequestException if request is invalid + * @throws RequestHandlerErrorException if an error occurs while processing request */ public final void handle() throws RequestHandlerForbiddenException, RequestHandlerBadRequestException, RequestHandlerErrorException { @@ -70,5 +70,5 @@ /** * Validates the request before attempting to perform it. - * @throws RequestHandlerBadRequestException + * @throws RequestHandlerBadRequestException if request is invalid * @since 5678 */ @@ -80,6 +80,6 @@ * This method of the subclass will do the real work. * - * @throws RequestHandlerErrorException - * @throws RequestHandlerBadRequestException + * @throws RequestHandlerErrorException if an error occurs while processing request + * @throws RequestHandlerBadRequestException if request is invalid */ protected abstract void handleRequest() throws RequestHandlerErrorException, RequestHandlerBadRequestException; @@ -133,8 +133,7 @@ /** - * Check permissions in preferences and display error message - * or ask for permission. - * - * @throws RequestHandlerForbiddenException + * Check permissions in preferences and display error message or ask for permission. + * + * @throws RequestHandlerForbiddenException if request is forbidden by preferences */ public final void checkPermission() throws RequestHandlerForbiddenException {