# HG changeset patch # User Artem Tikhomirov # Date 1332448601 -3600 # Node ID 7f136a3fa6717f2ceaa4d9a04bef271ba13ce1dd # Parent 528b6780a8bdcdf7a957c14635086d58b1204e3a Clean javadoc to fix obvious warnings diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/core/HgIncomingCommand.java --- a/src/org/tmatesoft/hg/core/HgIncomingCommand.java Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/core/HgIncomingCommand.java Thu Mar 22 21:36:41 2012 +0100 @@ -66,7 +66,7 @@ /** * Select specific branch to push. * Multiple branch specification possible (changeset from any of these would be included in result). - * Note, {@link #executeLite(Object)} does not respect this setting. + * Note, {@link #executeLite()} does not respect this setting. * * @param branch - branch name, case-sensitive, non-null. * @return this for convenience diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/core/HgLogCommand.java --- a/src/org/tmatesoft/hg/core/HgLogCommand.java Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/core/HgLogCommand.java Thu Mar 22 21:36:41 2012 +0100 @@ -184,7 +184,7 @@ } /** - * Similar to {@link #execute(org.tmatesoft.hg.repo.RawChangeset.Inspector)}, collects and return result as a list. + * Similar to {@link #execute(HgChangesetHandler)}, collects and return result as a list. */ public List execute() throws HgException { CollectHandler collector = new CollectHandler(); diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/core/HgOutgoingCommand.java --- a/src/org/tmatesoft/hg/core/HgOutgoingCommand.java Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/core/HgOutgoingCommand.java Thu Mar 22 21:36:41 2012 +0100 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011 TMate Software Ltd + * Copyright (c) 2011-2012 TMate Software Ltd * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by @@ -61,7 +61,7 @@ /** * Select specific branch to pull. * Multiple branch specification possible (changeset from any of these would be included in result). - * Note, {@link #executeLite(Object)} does not respect this setting. + * Note, {@link #executeLite()} does not respect this setting. * * @param branch - branch name, case-sensitive, non-null. * @return this for convenience diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/core/HgStatusCommand.java --- a/src/org/tmatesoft/hg/core/HgStatusCommand.java Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/core/HgStatusCommand.java Thu Mar 22 21:36:41 2012 +0100 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011 TMate Software Ltd + * Copyright (c) 2011-2012 TMate Software Ltd * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by @@ -145,7 +145,7 @@ /** * Limit status operation to certain sub-tree. * - * @param pathMatcher - matcher to use, pass null/ to reset + * @param scopeMatcher - matcher to use, pass null/ to reset * @return this for convenience */ public HgStatusCommand match(Path.Matcher scopeMatcher) { @@ -160,7 +160,7 @@ /** * Perform status operation according to parameters set. * - * @param handler callback to get status information + * @param statusHandler callback to get status information * @throws IOException if there are (further unspecified) errors while walking working copy * @throws IllegalArgumentException if handler is null * @throws ConcurrentModificationException if this command already runs (i.e. being used from another thread) diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/core/package.html --- a/src/org/tmatesoft/hg/core/package.html Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/core/package.html Thu Mar 22 21:36:41 2012 +0100 @@ -1,6 +1,6 @@

Hi-level API

-

Hi-level API to deal with Mercurial repositories using task-oriented commands. Start with {@link HgRepoFacade} class

+

Hi-level API to deal with Mercurial repositories using task-oriented commands. Start with {@link org.tmatesoft.hg.core.HgRepoFacade} class

\ No newline at end of file diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/internal/Internals.java --- a/src/org/tmatesoft/hg/internal/Internals.java Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/internal/Internals.java Thu Mar 22 21:36:41 2012 +0100 @@ -195,7 +195,7 @@ } /** - * @param hint optional hint pointing to filesystem of interest (generally, it's possible to mount + * @param fsHint optional hint pointing to filesystem of interest (generally, it's possible to mount * filesystems with different capabilities and repository's capabilities would depend on which fs it resides) * @return true if executable files deserve tailored handling */ @@ -205,7 +205,7 @@ } /** - * @param hint optional hint pointing to filesystem of interest (generally, it's possible to mount + * @param fsHint optional hint pointing to filesystem of interest (generally, it's possible to mount * filesystems with different capabilities and repository's capabilities would depend on which fs it resides) * @return true if filesystem knows what symbolic links are */ diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/internal/Patch.java --- a/src/org/tmatesoft/hg/internal/Patch.java Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/internal/Patch.java Thu Mar 22 21:36:41 2012 +0100 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2011 TMate Software Ltd + * Copyright (c) 2011-2012 TMate Software Ltd * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by @@ -21,7 +21,8 @@ import java.util.Formatter; /** - * @see http://mercurial.selenic.com/wiki/BundleFormat, in Changelog group description + * @see http://mercurial.selenic.com/wiki/BundleFormat + * in Changelog group description * * range [start..end] in original source gets replaced with data of length (do not keep, use data.length instead) * range [end(i)..start(i+1)] is copied from the source diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/repo/HgChangelog.java --- a/src/org/tmatesoft/hg/repo/HgChangelog.java Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/repo/HgChangelog.java Thu Mar 22 21:36:41 2012 +0100 @@ -116,8 +116,8 @@ /** * Unlike regular {@link Inspector}, this one supplies changeset revision along with its parents and children according * to parent information of the revlog this inspector visits. - * @see HgDataFile#history(TreeInspector) - * @deprecated use {@link HgChangesetTreeHandler} and HgLogCommand#execute(HgChangesetTreeHandler)} + * @see HgDataFile#history(HgChangelog.TreeInspector) + * @deprecated use {@link org.tmatesoft.hg.core.HgChangesetTreeHandler} and HgLogCommand#execute(org.tmatesoft.hg.core.HgChangesetTreeHandler)} */ @Deprecated public interface TreeInspector { diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/repo/HgIgnore.java --- a/src/org/tmatesoft/hg/repo/HgIgnore.java Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/repo/HgIgnore.java Thu Mar 22 21:36:41 2012 +0100 @@ -213,7 +213,7 @@ } /** - * A handy wrap of {@link #isIgnored(Path)} into {@link Path.Matcher}. Yields same result as {@link #isIgnored(Path)}. + * A handy wrap of {@link #isIgnored(Path)} into {@link org.tmatesoft.hg.util.Path.Matcher}. Yields same result as {@link #isIgnored(Path)}. * @return true if file is deemed ignored. */ public boolean accept(Path path) { diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/repo/HgManifest.java --- a/src/org/tmatesoft/hg/repo/HgManifest.java Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/repo/HgManifest.java Thu Mar 22 21:36:41 2012 +0100 @@ -338,7 +338,7 @@ public interface Inspector { boolean begin(int mainfestRevision, Nodeid nid, int changelogRevision); /** - * @deprecated switch to {@link Inspector2#next(Nodeid, Path, Flags)} + * @deprecated switch to {@link HgManifest.Inspector2#next(Nodeid, Path, HgManifest.Flags)} */ @Deprecated boolean next(Nodeid nid, String fname, String flags); diff -r 528b6780a8bd -r 7f136a3fa671 src/org/tmatesoft/hg/repo/Revlog.java --- a/src/org/tmatesoft/hg/repo/Revlog.java Thu Mar 22 21:02:20 2012 +0100 +++ b/src/org/tmatesoft/hg/repo/Revlog.java Thu Mar 22 21:36:41 2012 +0100 @@ -131,7 +131,7 @@ * If unsure, use {@link #isKnown(Nodeid)} to find out whether nodeid belongs to this revlog. * * For occasional queries, this method works with decent performance, despite its O(n/2) approach. - * Alternatively, if you need to perform multiple queries (e.g. at least 15-20), {@link RevisionMap} may come handy. + * Alternatively, if you need to perform multiple queries (e.g. at least 15-20), {@link Revlog.RevisionMap} may come handy. * * @param nid revision to look up * @return revision local index in this revlog @@ -162,7 +162,7 @@ * Note, {@link Nodeid#NULL} nodeid is not reported as known in any revlog. * * @param nodeid - * @return + * @return true if revision is part of this revlog * @throws HgInvalidControlFileException if access to revlog index/data entry failed */ public final boolean isKnown(Nodeid nodeid) throws HgInvalidControlFileException {