Changeset 5266 in josm for trunk


Ignore:
Timestamp:
2012-06-03T16:41:25+02:00 (12 years ago)
Author:
bastiK
Message:

fixed majority of javadoc warnings by replacing "{@see" by "{@link"

Location:
trunk/src/org/openstreetmap/josm
Files:
192 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/org/openstreetmap/josm/actions/ChangesetManagerToggleAction.java

    r4982 r5266  
    1818import org.openstreetmap.josm.tools.Shortcut;
    1919/**
    20  * This action toggles the visibility of the {@see ChangesetCacheManager} dialog.
     20 * This action toggles the visibility of the {@link ChangesetCacheManager} dialog.
    2121 *
    2222 */

  • trunk/src/org/openstreetmap/josm/actions/ExtensionFileFilter.java

    r5131 r5266  
    9393
    9494    /**
    95      * Updates the {@see AllFormatsImporter} that is contained in the importers list. If
     95     * Updates the {@link AllFormatsImporter} that is contained in the importers list. If
    9696     * you do not use the importers variable directly, you don’t need to call this.
    9797     *
    … …  
    109109
    110110    /**
    111      * Replies an ordered list of {@see ExtensionFileFilter}s for importing.
    112      * The list is ordered according to their description, an {@see AllFormatsImporter}
     111     * Replies an ordered list of {@link ExtensionFileFilter}s for importing.
     112     * The list is ordered according to their description, an {@link AllFormatsImporter}
    113113     * is append at the end.
    114114     *
    115      * @return an ordered list of {@see ExtensionFileFilter}s for importing.
     115     * @return an ordered list of {@link ExtensionFileFilter}s for importing.
    116116     */
    117117    public static List<ExtensionFileFilter> getImportExtensionFileFilters() {
    … …  
    126126
    127127    /**
    128      * Replies an ordered list of {@see ExtensionFileFilter}s for exporting.
    129      * The list is ordered according to their description, an {@see AllFormatsImporter}
     128     * Replies an ordered list of {@link ExtensionFileFilter}s for exporting.
     129     * The list is ordered according to their description, an {@link AllFormatsImporter}
    130130     * is append at the end.
    131131     *
    132      * @return an ordered list of {@see ExtensionFileFilter}s for exporting.
     132     * @return an ordered list of {@link ExtensionFileFilter}s for exporting.
    133133     */
    134134    public static List<ExtensionFileFilter> getExportExtensionFileFilters() {
    … …  
    145145
    146146    /**
    147      * Replies the default {@see ExtensionFileFilter} for a given extension
     147     * Replies the default {@link ExtensionFileFilter} for a given extension
    148148     *
    149149     * @param extension the extension
    150      * @return the default {@see ExtensionFileFilter} for a given extension
     150     * @return the default {@link ExtensionFileFilter} for a given extension
    151151     */
    152152    public static ExtensionFileFilter getDefaultImportExtensionFileFilter(String extension) {
    … …  
    160160
    161161    /**
    162      * Replies the default {@see ExtensionFileFilter} for a given extension
     162     * Replies the default {@link ExtensionFileFilter} for a given extension
    163163     *
    164164     * @param extension the extension
    165      * @return the default {@see ExtensionFileFilter} for a given extension
     165     * @return the default {@link ExtensionFileFilter} for a given extension
    166166     */
    167167    public static ExtensionFileFilter getDefaultExportExtensionFileFilter(String extension) {
    … …  
    175175
    176176    /**
    177      * Applies the choosable {@see FileFilter} to a {@see JFileChooser} before using the
     177     * Applies the choosable {@link FileFilter} to a {@link JFileChooser} before using the
    178178     * file chooser for selecting a file for reading.
    179179     *
    … …  
    189189
    190190    /**
    191      * Applies the choosable {@see FileFilter} to a {@see JFileChooser} before using the
     191     * Applies the choosable {@link FileFilter} to a {@link JFileChooser} before using the
    192192     * file chooser for selecting a file for writing.
    193193     *

  • trunk/src/org/openstreetmap/josm/actions/GpxExportAction.java

    r4982 r5266  
    6161     *
    6262     * <code>layer</code> must not be null. <code>layer</code> must be an instance of
    63      * {@see OsmDataLayer} or {@see GpxLayer}.
     63     * {@link OsmDataLayer} or {@link GpxLayer}.
    6464     *
    6565     * @param layer the layer
    6666     * @exception IllegalArgumentException thrown if layer is null
    67      * @exception IllegalArgumentException thrown if layer is neither an instance of {@see OsmDataLayer}
    68      *  nor of {@see GpxLayer}
     67     * @exception IllegalArgumentException thrown if layer is neither an instance of {@link OsmDataLayer}
     68     *  nor of {@link GpxLayer}
    6969     */
    7070    public void export(Layer layer) {

  • trunk/src/org/openstreetmap/josm/actions/JosmAction.java

    r5110 r5266  
    2424 * Base class helper for all Actions in JOSM. Just to make the life easier.
    2525 *
    26  * A JosmAction is a {@see LayerChangeListener} and a {@see SelectionChangedListener}. Upon
    27  * a layer change event or a selection change event it invokes {@see #updateEnabled()}.
    28  * Subclasses can override {@see #updateEnabled()} in order to update the {@see #isEnabled()}-state
    29  * of a JosmAction depending on the {@see #getCurrentDataSet()} and the current layers
    30  * (see also {@see #getEditLayer()}).
     26 * A JosmAction is a {@link LayerChangeListener} and a {@link SelectionChangedListener}. Upon
     27 * a layer change event or a selection change event it invokes {@link #updateEnabled()}.
     28 * Subclasses can override {@link #updateEnabled()} in order to update the {@link #isEnabled()}-state
     29 * of a JosmAction depending on the {@link #getCurrentDataSet()} and the current layers
     30 * (see also {@link #getEditLayer()}).
    3131 *
    3232 * destroy() from interface Destroyable is called e.g. for MapModes, when the last layer has
    … …  
    179179    /**
    180180     * Override in subclasses to init the enabled state of an action when it is
    181      * created. Default behaviour is to call {@see #updateEnabledState()}
     181     * created. Default behaviour is to call {@link #updateEnabledState()}
    182182     *
    183183     * @see #updateEnabledState()
    … …  
    192192     * something in the JOSM state changes, i.e. when a layer is removed or added.
    193193     *
    194      * See {@see #updateEnabledState(Collection)} to respond to changes in the collection
     194     * See {@link #updateEnabledState(Collection)} to respond to changes in the collection
    195195     * of selected primitives.
    196196     *

  • trunk/src/org/openstreetmap/josm/actions/PasteTagsAction.java

    r4982 r5266  
    5353        /**
    5454         * Replies true if the source for tag pasting is heterogeneous, i.e. if it doesn't consist of
    55          * {@see OsmPrimitive}s of exactly one type
     55         * {@link OsmPrimitive}s of exactly one type
    5656         *
    5757         * @return
    … …  
    130130
    131131        /**
    132          * Pastes the tags from a homogeneous source (i.e. the {@see Main#pasteBuffer}s selection consisting
    133          * of one type of {@see OsmPrimitive}s only.
     132         * Pastes the tags from a homogeneous source (i.e. the {@link Main#pasteBuffer}s selection consisting
     133         * of one type of {@link OsmPrimitive}s only.
    134134         *
    135135         * Tags from a homogeneous source can be pasted to a heterogeneous target. All target primitives,

  • trunk/src/org/openstreetmap/josm/actions/SplitWayAction.java

    r5041 r5266  
    468468    /**
    469469     * Splits the way {@code way} at the nodes in {@code atNodes} and replies
    470      * the result of this process in an instance of {@see SplitWayResult}.
     470     * the result of this process in an instance of {@link SplitWayResult}.
    471471     *
    472472     * Note that changes are not applied to the data yet. You have to
    473      * submit the command in {@see SplitWayResult#getCommand()} first,
     473     * submit the command in {@link SplitWayResult#getCommand()} first,
    474474     * i.e. {@code Main.main.undoredo.add(result.getCommand())}.
    475475     *

  • trunk/src/org/openstreetmap/josm/actions/UpdateSelectionAction.java

    r4982 r5266  
    4747
    4848    /**
    49      * Updates the data for for the {@see OsmPrimitive}s in <code>selection</code>
     49     * Updates the data for for the {@link OsmPrimitive}s in <code>selection</code>
    5050     * with the data currently kept on the server.
    5151     *
    52      * @param selection a collection of {@see OsmPrimitive}s to update
     52     * @param selection a collection of {@link OsmPrimitive}s to update
    5353     *
    5454     */
    … …  
    5959
    6060    /**
    61      * Updates the data for  the {@see OsmPrimitive}s with id <code>id</code>
     61     * Updates the data for  the {@link OsmPrimitive}s with id <code>id</code>
    6262     * with the data currently kept on the server.
    6363     *
    64      * @param id  the id of a primitive in the {@see DataSet} of the current edit layer. Must not be null.
     64     * @param id  the id of a primitive in the {@link DataSet} of the current edit layer. Must not be null.
    6565     * @throws IllegalArgumentException thrown if id is null
    6666     * @exception IllegalStateException thrown if there is no primitive with <code>id</code> in

  • trunk/src/org/openstreetmap/josm/actions/UploadAction.java

    r5233 r5266  
    136136     * Check whether the preconditions are met to upload data in <code>apiData</code>.
    137137     * Makes sure upload is allowed, primitives in <code>apiData</code> don't participate in conflicts and
    138      * runs the installed {@see UploadHook}s.
     138     * runs the installed {@link UploadHook}s.
    139139     *
    140140     * @param layer the source layer of the data to be uploaded

  • trunk/src/org/openstreetmap/josm/actions/downloadtasks/DownloadTask.java

    r4521 r5266  
    1313     *
    1414     * Set <code>progressMonitor</code> to null, if the task should create, open, and close a progress monitor.
    15      * Set progressMonitor to {@see NullProgressMonitor#INSTANCE} if progress information is to
     15     * Set progressMonitor to {@link NullProgressMonitor#INSTANCE} if progress information is to
    1616     * be discarded.
    1717     *
    1818     * You can wait for the asynchronous download task to finish by synchronizing on the returned
    19      * {@see Future}, but make sure not to freeze up JOSM. Example:
     19     * {@link Future}, but make sure not to freeze up JOSM. Example:
    2020     * <pre>
    2121     *    Future<?> future = task.download(...);
    … …  
    5353     *
    5454     * Set progressMonitor to null, if the task should create, open, and close a progress monitor.
    55      * Set progressMonitor to {@see NullProgressMonitor#INSTANCE} if progress information is to
     55     * Set progressMonitor to {@link NullProgressMonitor#INSTANCE} if progress information is to
    5656     * be discarded.
    5757
    … …  
    7676     * Replies the error objects of the task. Empty list, if no error messages are available.
    7777     *
    78      * Error objects are either {@see String}s with error messages or {@see Exception}s.
     78     * Error objects are either {@link String}s with error messages or {@link Exception}s.
    7979     *
    8080     * @return the list of error objects

  • trunk/src/org/openstreetmap/josm/actions/mapmode/DeleteAction.java

    r5102 r5266  
    331331    /**
    332332     * Deletes the relation in the context of the given layer. Also notifies
    333      * {@see RelationDialogManager} and {@see OsmDataLayer#fireDataChange()} events.
     333     * {@link RelationDialogManager} and {@link OsmDataLayer#fireDataChange()} events.
    334334     *
    335335     * @param layer the layer in whose context the relation is deleted. Must not be null.

  • trunk/src/org/openstreetmap/josm/command/AddCommand.java

    r5112 r5266  
    2020 * way.
    2121 *
    22  * See {@see ChangeCommand} for comments on relation back references.
     22 * See {@link ChangeCommand} for comments on relation back references.
    2323 *
    2424 * @author imi

  • trunk/src/org/openstreetmap/josm/command/Command.java

    r5060 r5266  
    3535 * one atomic action on a specific dataset, such as move or delete.
    3636 *
    37  * The command remembers the {@see OsmDataLayer} it is operating on.
     37 * The command remembers the {@link OsmDataLayer} it is operating on.
    3838 *
    3939 * @author imi

  • trunk/src/org/openstreetmap/josm/command/ConflictResolveCommand.java

    r4191 r5266  
    1010
    1111/**
    12  * This is the common base class for {@see Command}s which manipulate {@see Conflict}s in
    13  * addition to {@see OsmPrimitive}s.
     12 * This is the common base class for {@link Command}s which manipulate {@link Conflict}s in
     13 * addition to {@link OsmPrimitive}s.
    1414 *
    1515 * A ConflictResolverCommand can remember a collection of conflicts it resolves. Upon undoing
    … …  
    4444    /**
    4545     * reconstitutes all remembered conflicts. Add the remembered conflicts to the
    46      * set of conflicts of the {@see OsmDataLayer} this command was applied to.
     46     * set of conflicts of the {@link OsmDataLayer} this command was applied to.
    4747     *
    4848     */

  • trunk/src/org/openstreetmap/josm/command/CoordinateConflictResolveCommand.java

    r4918 r5266  
    1414
    1515/**
    16  * Represents a the resolution of a conflict between the coordinates of two {@see Node}s
     16 * Represents a the resolution of a conflict between the coordinates of two {@link Node}s
    1717 *
    1818 */

  • trunk/src/org/openstreetmap/josm/command/DeleteCommand.java

    r5077 r5266  
    239239     * If a way is deleted, only the way and no nodes are deleted.
    240240     *
    241      * @param layer the {@see OsmDataLayer} in whose context primitives are deleted. Must not be null.
     241     * @param layer the {@link OsmDataLayer} in whose context primitives are deleted. Must not be null.
    242242     * @param selection The list of all object to be deleted.
    243243     * @param silent  Set to true if the user should not be bugged with additional dialogs
    … …  
    270270     * can be deleted too. A node can be deleted if
    271271     * <ul>
    272      *    <li>it is untagged (see {@see Node#isTagged()}</li>
     272     *    <li>it is untagged (see {@link Node#isTagged()}</li>
    273273     *    <li>it is not referred to by other non-deleted primitives outside of  <code>primitivesToDelete</code></li>
    274274     * <ul>
    … …  
    310310     * they are part of a relation, inform the user and do not delete.
    311311     *
    312      * @param layer the {@see OsmDataLayer} in whose context the primitives are deleted
     312     * @param layer the {@link OsmDataLayer} in whose context the primitives are deleted
    313313     * @param selection the objects to delete.
    314314     * @param alsoDeleteNodesInWay <code>true</code> if nodes should be deleted as well
    … …  
    329329     * they are part of a relation, inform the user and do not delete.
    330330     *
    331      * @param layer the {@see OsmDataLayer} in whose context the primitives are deleted
     331     * @param layer the {@link OsmDataLayer} in whose context the primitives are deleted
    332332     * @param selection the objects to delete.
    333333     * @param alsoDeleteNodesInWay <code>true</code> if nodes should be deleted as well

  • trunk/src/org/openstreetmap/josm/command/DeletedStateConflictResolveCommand.java

    r4918 r5266  
    1616
    1717/**
    18  * Represents a the resolution of a conflict between the coordinates of two {@see Node}s
     18 * Represents a the resolution of a conflict between the coordinates of two {@link Node}s
    1919 *
    2020 */

  • trunk/src/org/openstreetmap/josm/command/ModifiedConflictResolveCommand.java

    r4918 r5266  
    1616
    1717/**
    18  * Represents a command for to set the modified flag {@see OsmPrimitive}
     18 * Represents a command for to set the modified flag {@link OsmPrimitive}
    1919 *
    2020 *

  • trunk/src/org/openstreetmap/josm/command/RelationMemberConflictResolverCommand.java

    r4918 r5266  
    1818/**
    1919 * Represent a command for resolving conflicts in the member lists of two
    20  * {@see Relation}s.
     20 * {@link Relation}s.
    2121 *
    2222 */

  • trunk/src/org/openstreetmap/josm/command/TagConflictResolveCommand.java

    r4918 r5266  
    1818
    1919/**
    20  * Represents a the resolution of a tag conflict in an {@see OsmPrimitive}
     20 * Represents a the resolution of a tag conflict in an {@link OsmPrimitive}
    2121 *
    2222 */
    … …  
    2525    private Conflict<? extends OsmPrimitive> conflict;
    2626
    27     /** the list of merge decisions, represented as {@see TagMergeItem}s */
     27    /** the list of merge decisions, represented as {@link TagMergeItem}s */
    2828    private final List<TagMergeItem> mergeItems;
    2929
    … …  
    4848     * @param my  my primitive
    4949     * @param their  their primitive
    50      * @param mergeItems the list of merge decisions, represented as {@see TagMergeItem}s
     50     * @param mergeItems the list of merge decisions, represented as {@link TagMergeItem}s
    5151     */
    5252    public TagConflictResolveCommand(Conflict<? extends OsmPrimitive> conflict, List<TagMergeItem> mergeItems) {

  • trunk/src/org/openstreetmap/josm/command/VersionConflictResolveCommand.java

    r4918 r5266  
    1414
    1515/**
    16  * Represents a command for resolving a version conflict between two {@see OsmPrimitive}
     16 * Represents a command for resolving a version conflict between two {@link OsmPrimitive}
    1717 *
    1818 *

  • trunk/src/org/openstreetmap/josm/command/WayNodesConflictResolverCommand.java

    r4918 r5266  
    1717/**
    1818 * Represent a command for resolving conflicts in the node list of two
    19  * {@see Way}s.
     19 * {@link Way}s.
    2020 *
    2121 */

  • trunk/src/org/openstreetmap/josm/data/APIDataSet.java

    r4874 r5266  
    2828
    2929/**
    30  * Represents a collection of {@see OsmPrimitive}s which should be uploaded to the
     30 * Represents a collection of {@link OsmPrimitive}s which should be uploaded to the
    3131 * API.
    32  * The collection is derived from the modified primitives of an {@see DataSet} and it provides methods
     32 * The collection is derived from the modified primitives of an {@link DataSet} and it provides methods
    3333 * for sorting the objects in upload order.
    3434 *

  • trunk/src/org/openstreetmap/josm/data/Version.java

    r4310 r5266  
    180180
    181181    /**
    182      * Replies the JOSM version. Replies {@see #JOSM_UNKNOWN_VERSION} if the version isn't known.
     182     * Replies the JOSM version. Replies {@link #JOSM_UNKNOWN_VERSION} if the version isn't known.
    183183     * @return the JOSM version
    184184     */

  • trunk/src/org/openstreetmap/josm/data/conflict/Conflict.java

    r3530 r5266  
    66
    77/**
    8  * Represents a conflict between two {@see OsmPrimitive}s. It is represented as
    9  * a pair of {@see OsmPrimitive}s where one element of the pair has the role <em>my</em>
     8 * Represents a conflict between two {@link OsmPrimitive}s. It is represented as
     9 * a pair of {@link OsmPrimitive}s where one element of the pair has the role <em>my</em>
    1010 * and the other has the role <em>their</em>.
    1111 * <ul>
    12  *   <li><code>my</code> is the {@see OsmPrimitive} in the local dataset</li>
    13  *   <li><code>their</code> is the {@see OsmPrimitive} which caused the conflict when it
     12 *   <li><code>my</code> is the {@link OsmPrimitive} in the local dataset</li>
     13 *   <li><code>their</code> is the {@link OsmPrimitive} which caused the conflict when it
    1414 *   it was tried to merge it onto <code>my</code>. <code>their</code> is usually the
    15  *   {@see OsmPrimitive} from the dataset in another layer or the one retrieved from the server.</li>
     15 *   {@link OsmPrimitive} from the dataset in another layer or the one retrieved from the server.</li>
    1616 * </ul>
    1717 *

  • trunk/src/org/openstreetmap/josm/data/conflict/ConflictCollection.java

    r3083 r5266  
    1616
    1717/**
    18  * This is a collection of {@see Conflict}s. This collection is {@see Iterable}, i.e.
     18 * This is a collection of {@link Conflict}s. This collection is {@link Iterable}, i.e.
    1919 * it can be used in <code>for</code>-loops as follows:
    2020 * <pre>
    … …  
    2929 * and unregister for these events using:
    3030 * <ul>
    31  *   <li>{@see #addConflictListener(IConflictListener)}</li>
    32  *   <li>{@see #removeConflictListener(IConflictListener)}</li>
     31 *   <li>{@link #addConflictListener(IConflictListener)}</li>
     32 *   <li>{@link #removeConflictListener(IConflictListener)}</li>
    3333 * </ul>
    3434 */
    … …  
    108108
    109109    /**
    110      * Adds a conflict for the pair of {@see OsmPrimitive}s given by <code>my</code> and
     110     * Adds a conflict for the pair of {@link OsmPrimitive}s given by <code>my</code> and
    111111     * <code>their</code>.
    112112     *
    … …  
    130130
    131131    /**
    132      * removes the conflict registered for {@see OsmPrimitive} <code>my</code> if any
     132     * removes the conflict registered for {@link OsmPrimitive} <code>my</code> if any
    133133     *
    134134     * @param my  the primitive
    … …  
    145145
    146146    /**
    147      * Replies the conflict for the {@see OsmPrimitive} <code>my</code>, null
     147     * Replies the conflict for the {@link OsmPrimitive} <code>my</code>, null
    148148     * if no such conflict exists.
    149149     *
    150150     * @param my  my primitive
    151      * @return the conflict for the {@see OsmPrimitive} <code>my</code>, null
     151     * @return the conflict for the {@link OsmPrimitive} <code>my</code>, null
    152152     * if no such conflict exists.
    153153     */
    … …  
    160160    }
    161161    /**
    162      * Replies the conflict for the {@see OsmPrimitive} <code>their</code>, null
     162     * Replies the conflict for the {@link OsmPrimitive} <code>their</code>, null
    163163     * if no such conflict exists.
    164164     *
    165165     * @param my  my primitive
    166      * @return the conflict for the {@see OsmPrimitive} <code>their</code>, null
     166     * @return the conflict for the {@link OsmPrimitive} <code>their</code>, null
    167167     * if no such conflict exists.
    168168     */
    … …  
    206206
    207207    /**
    208      * Removes any conflicts for the {@see OsmPrimitive} <code>my</code>.
     208     * Removes any conflicts for the {@link OsmPrimitive} <code>my</code>.
    209209     *
    210210     * @param my the primitive
    … …  
    220220
    221221    /**
    222      * Removes any conflicts for the {@see OsmPrimitive} <code>their</code>.
     222     * Removes any conflicts for the {@link OsmPrimitive} <code>their</code>.
    223223     *
    224224     * @param their the primitive
    … …  
    277277
    278278    /**
    279      * Replies the set of  {@see OsmPrimitive} which participate in the role
     279     * Replies the set of  {@link OsmPrimitive} which participate in the role
    280280     * of "my" in the conflicts managed by this collection.
    281281     *
    282      * @return the set of  {@see OsmPrimitive} which participate in the role
     282     * @return the set of  {@link OsmPrimitive} which participate in the role
    283283     * of "my" in the conflicts managed by this collection.
    284284     */
    … …  
    291291    }
    292292    /**
    293      * Replies the set of  {@see OsmPrimitive} which participate in the role
     293     * Replies the set of  {@link OsmPrimitive} which participate in the role
    294294     * of "their" in the conflicts managed by this collection.
    295295     *
    296      * @return the set of  {@see OsmPrimitive} which participate in the role
     296     * @return the set of  {@link OsmPrimitive} which participate in the role
    297297     * of "their" in the conflicts managed by this collection.
    298298     */

  • trunk/src/org/openstreetmap/josm/data/oauth/OAuthParameters.java

    r3479 r5266  
    128128
    129129    /**
    130      * Builds an {@see OAuthConsumer} based on these parameters
     130     * Builds an {@link OAuthConsumer} based on these parameters
    131131     *
    132132     * @return the consumer
    … …  
    138138
    139139    /**
    140      * Builds an {@see OAuthProvider} based on these parameters and a OAuth consumer <code>consumer</code>.
     140     * Builds an {@link OAuthProvider} based on these parameters and a OAuth consumer <code>consumer</code>.
    141141     *
    142142     * @param consumer the consumer. Must not be null.

  • trunk/src/org/openstreetmap/josm/data/oauth/OAuthToken.java

    r3530 r5266  
    99
    1010    /**
    11      * Creates an OAuthToken from the token currently managed by the {@see OAuthConsumer}.
     11     * Creates an OAuthToken from the token currently managed by the {@link OAuthConsumer}.
    1212     *
    1313     * @param consumer the consumer

  • trunk/src/org/openstreetmap/josm/data/osm/AbstractPrimitive.java

    r5251 r5266  
    492492    /**
    493493     * Set the given value to the given key. If key is null, does nothing. If value is null,
    494      * removes the key and behaves like {@see #remove(String)}.
     494     * removes the key and behaves like {@link #remove(String)}.
    495495     *
    496496     * @param key  The key, for which the value is to be set. Can be null, does nothing in this case.

  • trunk/src/org/openstreetmap/josm/data/osm/ChangesetCache.java

    r4191 r5266  
    2020 * ChangesetCache is global in-memory cache for changesets downloaded from
    2121 * an OSM API server. The unique instance is available as singleton, see
    22  * {@see #getInstance()}.
    23  *
    24  * Clients interested in cache updates can register for {@see ChangesetCacheEvent}s
    25  * using {@see #addChangesetCacheListener(ChangesetCacheListener)}. They can use
    26  * {@see #removeChangesetCacheListener(ChangesetCacheListener)} to unregister as
     22 * {@link #getInstance()}.
     23 *
     24 * Clients interested in cache updates can register for {@link ChangesetCacheEvent}s
     25 * using {@link #addChangesetCacheListener(ChangesetCacheListener)}. They can use
     26 * {@link #removeChangesetCacheListener(ChangesetCacheListener)} to unregister as
    2727 * cache event listener.
    2828 *
    29  * The cache itself listens to {@see java.util.prefs.PreferenceChangeEvent}s. It
     29 * The cache itself listens to {@link java.util.prefs.PreferenceChangeEvent}s. It
    3030 * clears itself if the OSM API URL is changed in the preferences.
    3131 *
    32  * {@see ChangesetCacheEvent}s are delivered on the EDT.
     32 * {@link ChangesetCacheEvent}s are delivered on the EDT.
    3333 *
    3434 */
    … …  
    150150    /**
    151151     * Removes the changesets in <code>changesets</code> from the cache. A
    152      * {@see ChangesetCacheEvent} is fired.
     152     * {@link ChangesetCacheEvent} is fired.
    153153     *
    154154     * @param changesets the changesets to remove. Ignored if null.

  • trunk/src/org/openstreetmap/josm/data/osm/ChangesetDataSet.java

    r3083 r5266  
    135135
    136136    /**
    137      * Replies the {@see HistoryOsmPrimitive} with id <code>id</code> from this
     137     * Replies the {@link HistoryOsmPrimitive} with id <code>id</code> from this
    138138     * dataset. null, if there is no such primitive in the data set.
    139139     *
    140140     * @param id the id
    141      * @return  the {@see HistoryOsmPrimitive} with id <code>id</code> from this
     141     * @return  the {@link HistoryOsmPrimitive} with id <code>id</code> from this
    142142     * dataset
    143143     */

  • trunk/src/org/openstreetmap/josm/data/osm/DataSet.java

    r5122 r5266  
    379379     * Removes a primitive from the dataset. This method only removes the
    380380     * primitive form the respective collection of primitives managed
    381      * by this dataset, i.e. from {@see #nodes}, {@see #ways}, or
    382      * {@see #relations}. References from other primitives to this
     381     * by this dataset, i.e. from {@link #nodes}, {@link #ways}, or
     382     * {@link #relations}. References from other primitives to this
    383383     * primitive are left unchanged.
    384384     *
    … …  
    433433
    434434    /**
    435      * Notifies all registered {@see SelectionChangedListener} about the current selection in
     435     * Notifies all registered {@link SelectionChangedListener} about the current selection in
    436436     * this dataset.
    437437     *
    … …  
    584584    /**
    585585     * Sets the current selection to the primitives in <code>selection</code>.
    586      * Notifies all {@see SelectionChangedListener} if <code>fireSelectionChangeEvent</code> is true.
     586     * Notifies all {@link SelectionChangedListener} if <code>fireSelectionChangeEvent</code> is true.
    587587     *
    588588     * @param selection the selection
    … …  
    609609    /**
    610610     * Sets the current selection to the primitives in <code>selection</code>
    611      * and notifies all {@see SelectionChangedListener}.
     611     * and notifies all {@link SelectionChangedListener}.
    612612     *
    613613     * @param selection the selection
    … …  
    628628    /**
    629629     * Adds   the primitives in <code>selection</code> to the current selection
    630      * and notifies all {@see SelectionChangedListener}.
     630     * and notifies all {@link SelectionChangedListener}.
    631631     *
    632632     * @param selection the selection
    … …  
    642642    /**
    643643     * Adds the primitives in <code>selection</code> to the current selection.
    644      * Notifies all {@see SelectionChangedListener} if <code>fireSelectionChangeEvent</code> is true.
     644     * Notifies all {@link SelectionChangedListener} if <code>fireSelectionChangeEvent</code> is true.
    645645     *
    646646     * @param selection the selection
    … …  
    890890    /**
    891891     * Replies true if there is at least one primitive in this dataset with
    892      * {@see OsmPrimitive#isModified()} == <code>true</code>.
     892     * {@link OsmPrimitive#isModified()} == <code>true</code>.
    893893     *
    894894     * @return true if there is at least one primitive in this dataset with
    895      * {@see OsmPrimitive#isModified()} == <code>true</code>.
     895     * {@link OsmPrimitive#isModified()} == <code>true</code>.
    896896     */
    897897    public boolean isModified() {

  • trunk/src/org/openstreetmap/josm/data/osm/DataSetMerger.java

    r4684 r5266  
    6969     * If other.id != 0 it tries to merge it with an corresponding primitive from
    7070     * my dataset with the same id. If this is not possible a conflict is remembered
    71      * in {@see #conflicts}.
     71     * in {@link #conflicts}.
    7272     *
    7373     * If other.id == 0 it tries to find a primitive in my dataset with id == 0 which
    … …  
    370370
    371371    /**
    372      * Runs the merge operation. Successfully merged {@see OsmPrimitive}s are in
    373      * {@see #getMyDataSet()}.
    374      *
    375      * See {@see #getConflicts()} for a map of conflicts after the merge operation.
     372     * Runs the merge operation. Successfully merged {@link OsmPrimitive}s are in
     373     * {@link #getMyDataSet()}.
     374     *
     375     * See {@link #getConflicts()} for a map of conflicts after the merge operation.
    376376     */
    377377    public void merge() {
    … …  
    380380
    381381    /**
    382      * Runs the merge operation. Successfully merged {@see OsmPrimitive}s are in
    383      * {@see #getMyDataSet()}.
    384      *
    385      * See {@see #getConflicts()} for a map of conflicts after the merge operation.
     382     * Runs the merge operation. Successfully merged {@link OsmPrimitive}s are in
     383     * {@link #getMyDataSet()}.
     384     *
     385     * See {@link #getConflicts()} for a map of conflicts after the merge operation.
    386386     */
    387387    public void merge(ProgressMonitor progressMonitor) {

  • trunk/src/org/openstreetmap/josm/data/osm/OsmPrimitive.java

    r5188 r5266  
    9090
    9191    /**
    92      * Replies the sub-collection of {@see OsmPrimitive}s of type <code>type</code> present in
    93      * another collection of {@see OsmPrimitive}s. The result collection is a list.
     92     * Replies the sub-collection of {@link OsmPrimitive}s of type <code>type</code> present in
     93     * another collection of {@link OsmPrimitive}s. The result collection is a list.
    9494     *
    9595     * If <code>list</code> is null, replies an empty list.
    … …  
    112112
    113113    /**
    114      * Replies the sub-collection of {@see OsmPrimitive}s of type <code>type</code> present in
    115      * another collection of {@see OsmPrimitive}s. The result collection is a set.
     114     * Replies the sub-collection of {@link OsmPrimitive}s of type <code>type</code> present in
     115     * another collection of {@link OsmPrimitive}s. The result collection is a set.
    116116     *
    117117     * If <code>list</code> is null, replies an empty set.
    … …  
    363363     * of calling this method.
    364364     *
    365      * <strong>Caution</strong>: Do not use this method on primitives which are already added to a {@see DataSet}.
     365     * <strong>Caution</strong>: Do not use this method on primitives which are already added to a {@link DataSet}.
    366366     *
    367367     * @throws DataIntegrityProblemException If primitive was already added to the dataset

  • trunk/src/org/openstreetmap/josm/data/osm/Relation.java

    r4213 r5266  
    378378
    379379    /**
    380      * Replies the set of  {@see OsmPrimitive}s referred to by at least one
     380     * Replies the set of  {@link OsmPrimitive}s referred to by at least one
    381381     * member of this relation
    382382     *
    383      * @return the set of  {@see OsmPrimitive}s referred to by at least one
     383     * @return the set of  {@link OsmPrimitive}s referred to by at least one
    384384     * member of this relation
    385385     */

  • trunk/src/org/openstreetmap/josm/data/osm/RelationToChildReference.java

    r3083 r5266  
    99
    1010    /**
    11      * Replies a set of all {@see RelationToChildReference}s for a given child primitive.
     11     * Replies a set of all {@link RelationToChildReference}s for a given child primitive.
    1212     *
    1313     * @param child the child primitive
    14      * @return  a set of all {@see RelationToChildReference}s for a given child primitive
     14     * @return  a set of all {@link RelationToChildReference}s for a given child primitive
    1515     */
    1616    static public Set<RelationToChildReference> getRelationToChildReferences(OsmPrimitive child) {
    … …  
    2828
    2929    /**
    30      * Replies a set of all {@see RelationToChildReference}s for a collection of child primitives
     30     * Replies a set of all {@link RelationToChildReference}s for a collection of child primitives
    3131     *
    3232     * @param children the collection of child primitives
    33      * @return  a set of all {@see RelationToChildReference}s to the children in the collection of child
     33     * @return  a set of all {@link RelationToChildReference}s to the children in the collection of child
    3434     * primitives
    3535     */

  • trunk/src/org/openstreetmap/josm/data/osm/TagCollection.java

    r5058 r5266  
    2020/**
    2121 * TagCollection is a collection of tags which can be used to manipulate
    22  * tags managed by {@see OsmPrimitive}s.
     22 * tags managed by {@link OsmPrimitive}s.
    2323 *
    2424 * A TagCollection can be created:
    2525 * <ul>
    26  *  <li>from the tags managed by a specific {@see OsmPrimitive} with {@see #from(OsmPrimitive)}</li>
    27  *  <li>from the union of all tags managed by a collection of {@see OsmPrimitive}s with {@see #unionOfAllPrimitives(Collection)}</li>
    28  *  <li>from the union of all tags managed by a {@see DataSet} with {@see #unionOfAllPrimitives(DataSet)}</li>
    29  *  <li>from the intersection of all tags managed by a collection of primitives with {@see #commonToAllPrimitives(Collection)}</li>
     26 *  <li>from the tags managed by a specific {@link OsmPrimitive} with {@link #from(OsmPrimitive)}</li>
     27 *  <li>from the union of all tags managed by a collection of {@link OsmPrimitive}s with {@link #unionOfAllPrimitives(Collection)}</li>
     28 *  <li>from the union of all tags managed by a {@link DataSet} with {@link #unionOfAllPrimitives(DataSet)}</li>
     29 *  <li>from the intersection of all tags managed by a collection of primitives with {@link #commonToAllPrimitives(Collection)}</li>
    3030 * </ul>
    3131 *
    32  * It  provides methods to query the collection, like {@see #size()}, {@see #hasTagsFor(String)}, etc.
     32 * It  provides methods to query the collection, like {@link #size()}, {@link #hasTagsFor(String)}, etc.
    3333 *
    3434 * Basic set operations allow to create the union, the intersection and  the difference
    35  * of tag collections, see {@see #union(TagCollection)}, {@see #intersect(TagCollection)},
    36  * and {@see #minus(TagCollection)}.
     35 * of tag collections, see {@link #union(TagCollection)}, {@link #intersect(TagCollection)},
     36 * and {@link #minus(TagCollection)}.
    3737 *
    3838 *
    … …  
    4242    /**
    4343     * Creates a tag collection from the tags managed by a specific
    44      * {@see OsmPrimitive}. If <code>primitive</code> is null, replies
     44     * {@link OsmPrimitive}. If <code>primitive</code> is null, replies
    4545     * an empty tag collection.
    4646     *
    4747     * @param primitive  the primitive
    4848     * @return a tag collection with the tags managed by a specific
    49      * {@see OsmPrimitive}
     49     * {@link OsmPrimitive}
    5050     */
    5151    public static TagCollection from(Tagged primitive) {
    … …  
    578578
    579579    /**
    580      * Applies this tag collection to an {@see OsmPrimitive}. Does nothing if
     580     * Applies this tag collection to an {@link OsmPrimitive}. Does nothing if
    581581     * primitive is null
    582582     *
    … …  
    599599
    600600    /**
    601      * Applies this tag collection to a collection of {@see OsmPrimitive}s. Does nothing if
     601     * Applies this tag collection to a collection of {@link OsmPrimitive}s. Does nothing if
    602602     * primitives is null
    603603     *
    … …  
    616616
    617617    /**
    618      * Replaces the tags of an {@see OsmPrimitive} by the tags in this collection . Does nothing if
     618     * Replaces the tags of an {@link OsmPrimitive} by the tags in this collection . Does nothing if
    619619     * primitive is null
    620620     *
    … …  
    634634
    635635    /**
    636      * Replaces the tags of a collection of{@see OsmPrimitive}s by the tags in this collection.
     636     * Replaces the tags of a collection of{@link OsmPrimitive}s by the tags in this collection.
    637637     * Does nothing if primitives is null
    638638     *

  • trunk/src/org/openstreetmap/josm/data/osm/Way.java

    r5199 r5266  
    109109     * @return  the node at position <code>index</code>
    110110     * @exception IndexOutOfBoundsException thrown if <code>index</code> < 0
    111      * or <code>index</code> >= {@see #getNodesCount()}
     111     * or <code>index</code> >= {@link #getNodesCount()}
    112112     * @since 1862
    113113     */

  • trunk/src/org/openstreetmap/josm/data/osm/history/HistoryDataSet.java

    r4191 r5266  
    148148
    149149    /**
    150      * merges the histories from the {@see HistoryDataSet} other in this history data set
     150     * merges the histories from the {@link HistoryDataSet} other in this history data set
    151151     *
    152152     * @param other the other history data set. Ignored if null.

  • trunk/src/org/openstreetmap/josm/data/osm/history/HistoryDataSetListener.java

    r3530 r5266  
    66public interface HistoryDataSetListener {
    77    /**
    8      * Fired by a {@see HistoryDataSet} if the cached history of an OSM primitive with
     8     * Fired by a {@link HistoryDataSet} if the cached history of an OSM primitive with
    99     * id <code>id</code> is updated
    1010     *
    … …  
    1515
    1616    /**
    17      * Fired by a {@see HistoryDataSet} if the history cached is cleared.
     17     * Fired by a {@link HistoryDataSet} if the history cached is cleared.
    1818     *
    1919     * @param source the history data set firing the event

  • trunk/src/org/openstreetmap/josm/data/osm/history/HistoryOsmPrimitive.java

    r4602 r5266  
    219219        if (!(obj instanceof HistoryOsmPrimitive))
    220220            return false;
    221         // equal semantics is valid for subclasses like {@see HistoryOsmNode} etc. too.
     221        // equal semantics is valid for subclasses like {@link HistoryOsmNode} etc. too.
    222222        // So, don't enforce equality of class.
    223223        //

  • trunk/src/org/openstreetmap/josm/data/osm/history/HistoryRelation.java

    r4734 r5266  
    9898
    9999    /**
    100      * replies the type, i.e. {@see OsmPrimitiveType#RELATION}
     100     * replies the type, i.e. {@link OsmPrimitiveType#RELATION}
    101101     *
    102102     */

  • trunk/src/org/openstreetmap/josm/data/osm/history/HistoryWay.java

    r4602 r5266  
    6666
    6767    /**
    68      * replies the ways type, i.e. {@see OsmPrimitiveType#WAY}
     68     * replies the ways type, i.e. {@link OsmPrimitiveType#WAY}
    6969     *
    7070     * @return the ways type

  • trunk/src/org/openstreetmap/josm/data/osm/visitor/MergeSourceBuildingVisitor.java

    r3440 r5266  
    2020
    2121/**
    22  * MergeSourceBuildingVisitor helps to build the "hull" of a collection of {@see OsmPrimitive}s
     22 * MergeSourceBuildingVisitor helps to build the "hull" of a collection of {@link OsmPrimitive}s
    2323 * which shall be merged into another layer. The "hull" is slightly bigger than the original
    2424 * collection. It includes, for instance the nodes of a way in the original collection even though
    2525 * these nodes might not be present explicitly in the original collection. The "hull" also includes
    26  * incomplete {@see OsmPrimitive}s which are referred to by relations in the original collection. And
    27  * it turns {@see OsmPrimitive} referred to by {@see Relation}s in the original collection into
    28  * incomplete {@see OsmPrimitive}s in the "hull", if they are not themselves present in the
     26 * incomplete {@link OsmPrimitive}s which are referred to by relations in the original collection. And
     27 * it turns {@link OsmPrimitive} referred to by {@link Relation}s in the original collection into
     28 * incomplete {@link OsmPrimitive}s in the "hull", if they are not themselves present in the
    2929 * original collection.
    3030 *
    … …  
    3838     * Creates the visitor. The visitor starts to build the "hull" from
    3939     * the currently selected primitives in the dataset <code>selectionBase</code>,
    40      * i.e. from {@see DataSet#getSelected()}.
     40     * i.e. from {@link DataSet#getSelected()}.
    4141     *
    4242     * @param selectionBase the dataset. Must not be null.

  • trunk/src/org/openstreetmap/josm/data/projection/Projection.java

    r4305 r5266  
    1414public interface Projection {
    1515    /**
    16      * The default scale factor in east/north units per pixel ({@see #NavigatableComponent#scale}))
     16     * The default scale factor in east/north units per pixel ({@link #NavigatableComponent#scale}))
    1717     * FIXME: misnomer
    1818     */

  • trunk/src/org/openstreetmap/josm/gui/ConditionalOptionPaneUtil.java

    r2929 r5266  
    2020 * which can be enabled/disabled by the user.
    2121 *
    22  * They wrap the methods provided by {@see JOptionPane}. Within JOSM you should use these
    23  * methods rather than the bare methods from {@see JOptionPane} because the methods provided
     22 * They wrap the methods provided by {@link JOptionPane}. Within JOSM you should use these
     23 * methods rather than the bare methods from {@link JOptionPane} because the methods provided
    2424 * by ConditionalOptionPaneUtil ensure that a dialog window is always on top and isn't hidden by one of the
    2525 * JOSM windows for detached dialogs, relation editors, history browser and the like.
    … …  
    8181     * relation editors, history browsers and the like.
    8282     *
    83      * Set <code>optionType</code> to {@see JOptionPane#YES_NO_OPTION} for a dialog with a YES and
     83     * Set <code>optionType</code> to {@link JOptionPane#YES_NO_OPTION} for a dialog with a YES and
    8484     * a NO button.
    8585
    86      * Set <code>optionType</code> to {@see JOptionPane#YES_NO_CANCEL_OPTION} for a dialog with a YES,
     86     * Set <code>optionType</code> to {@link JOptionPane#YES_NO_CANCEL_OPTION} for a dialog with a YES,
    8787     * a NO and a CANCEL button
    8888     *
    … …  
    100100     * @param defaultOption the default option
    101101     *
    102      * @return the option selected by user. {@see JOptionPane#CLOSED_OPTION} if the dialog was closed.
     102     * @return the option selected by user. {@link JOptionPane#CLOSED_OPTION} if the dialog was closed.
    103103     */
    104104    static public int showOptionDialog(String preferenceKey, Component parent, Object message, String title, int optionType, int messageType, Object [] options, Object defaultOption) throws HeadlessException {
    … …  
    121121     * relation editors, history browsers and the like.
    122122     *
    123      * Set <code>optionType</code> to {@see JOptionPane#YES_NO_OPTION} for a dialog with a YES and
     123     * Set <code>optionType</code> to {@link JOptionPane#YES_NO_OPTION} for a dialog with a YES and
    124124     * a NO button.
    125125
    126      * Set <code>optionType</code> to {@see JOptionPane#YES_NO_CANCEL_OPTION} for a dialog with a YES,
     126     * Set <code>optionType</code> to {@link JOptionPane#YES_NO_CANCEL_OPTION} for a dialog with a YES,
    127127     * a NO and a CANCEL button
    128128     *
    … …  
    191191     * This is a message panel used in dialogs which can be enabled/disabled with a preference
    192192     * setting.
    193      * In addition to the normal message any {@see JOptionPane} would display it includes
     193     * In addition to the normal message any {@link JOptionPane} would display it includes
    194194     * a checkbox for enabling/disabling this particular dialog.
    195195     *

  • trunk/src/org/openstreetmap/josm/gui/DefaultNameFormatter.java

    r5132 r5266  
    4141
    4242/**
    43  * This is the default implementation of a {@see NameFormatter} for names of {@see OsmPrimitive}s.
     43 * This is the default implementation of a {@link NameFormatter} for names of {@link OsmPrimitive}s.
    4444 *
    4545 */
    … …  
    100100     * <ul>
    101101     *   <li>by the tag names in the preference <tt>relation.nameOrder</tt></li>
    102      *   <li>by the default tags in {@see #DEFAULT_NAMING_TAGS_FOR_RELATIONS}
     102     *   <li>by the default tags in {@link #DEFAULT_NAMING_TAGS_FOR_RELATIONS}
    103103     * </ul>
    104104     *
    … …  
    524524     * <tt>osm-primitives.showid</tt> is set.
    525525     *
    526      * The id is append to the {@see StringBuilder} passed in in <code>name</code>.
     526     * The id is append to the {@link StringBuilder} passed in in <code>name</code>.
    527527     *
    528528     * @param name  the name without the id
    … …  
    605605
    606606    /**
    607      * Formats a name for a {@see HistoryRelation})
     607     * Formats a name for a {@link HistoryRelation})
    608608     *
    609609     * @param relation the relation

  • trunk/src/org/openstreetmap/josm/gui/ExceptionDialogUtil.java

    r4540 r5266  
    9191
    9292    /**
    93      * Explains a {@see SecurityException} which has caused an {@see OsmTransferException}.
     93     * Explains a {@link SecurityException} which has caused an {@link OsmTransferException}.
    9494     * This is most likely happening when user tries to access the OSM API from within an
    9595     * applet which wasn't loaded from the API server.
    … …  
    109109
    110110    /**
    111      * Explains a {@see SocketException} which has caused an {@see OsmTransferException}.
     111     * Explains a {@link SocketException} which has caused an {@link OsmTransferException}.
    112112     * This is most likely because there's not connection to the Internet or because
    113113     * the remote server is not reachable.
    … …  
    127127
    128128    /**
    129      * Explains a {@see IOException} which has caused an {@see OsmTransferException}.
     129     * Explains a {@link IOException} which has caused an {@link OsmTransferException}.
    130130     * This is most likely happening when the communication with the remote server is
    131131     * interrupted for any reason.
    … …  
    145145
    146146    /**
    147      * Explains a {@see IllegalDataException} which has caused an {@see OsmTransferException}.
     147     * Explains a {@link IllegalDataException} which has caused an {@link OsmTransferException}.
    148148     * This is most likely happening when JOSM tries to load data in in an unsupported format.
    149149     *
    … …  
    162162
    163163    /**
    164      * Explains a {@see InvocationTargetException }
     164     * Explains a {@link InvocationTargetException }
    165165     *
    166166     * @param e the exception
    … …  
    178178
    179179    /**
    180      * Explains a {@see OsmApiException} which was thrown because of an internal server
     180     * Explains a {@link OsmApiException} which was thrown because of an internal server
    181181     * error in the OSM API server.
    182182     *
    … …  
    195195
    196196    /**
    197      * Explains a {@see OsmApiException} which was thrown because of a bad
     197     * Explains a {@link OsmApiException} which was thrown because of a bad
    198198     * request
    199199     *
    … …  
    211211
    212212    /**
    213      * Explains a {@see OsmApiException} which was thrown because a resource wasn't found
     213     * Explains a {@link OsmApiException} which was thrown because a resource wasn't found
    214214     * on the server
    215215     *
    … …  
    227227
    228228    /**
    229      * Explains a {@see OsmApiException} which was thrown because of a conflict
     229     * Explains a {@link OsmApiException} which was thrown because of a conflict
    230230     *
    231231     * @param e the exception
    … …  
    242242
    243243    /**
    244      * Explains a {@see OsmApiException} which was thrown because the authentication at
     244     * Explains a {@link OsmApiException} which was thrown because the authentication at
    245245     * the OSM server failed
    246246     *
    … …  
    266266
    267267    /**
    268      * Explains a {@see OsmApiException} which was thrown because accessing a protected
     268     * Explains a {@link OsmApiException} which was thrown because accessing a protected
    269269     * resource was forbidden.
    270270     *
    … …  
    283283
    284284    /**
    285      * Explains a {@see OsmApiException} which was thrown because of a
     285     * Explains a {@link OsmApiException} which was thrown because of a
    286286     * client timeout (HTTP 408)
    287287     *
    … …  
    299299
    300300    /**
    301      * Explains a {@see OsmApiException} which was thrown because of a
     301     * Explains a {@link OsmApiException} which was thrown because of a
    302302     * bandwidth limit (HTTP 509)
    303303     *
    … …  
    315315
    316316    /**
    317      * Explains a {@see OsmApiException} with a generic error
     317     * Explains a {@link OsmApiException} with a generic error
    318318     * message.
    319319     *
    … …  
    331331
    332332    /**
    333      * Explains a {@see OsmApiException} which was thrown because accessing a protected
     333     * Explains a {@link OsmApiException} which was thrown because accessing a protected
    334334     * resource was forbidden.
    335335     *
    … …  
    347347
    348348    /**
    349      * Explains a {@see UnknownHostException} which has caused an {@see OsmTransferException}.
     349     * Explains a {@link UnknownHostException} which has caused an {@link OsmTransferException}.
    350350     * This is most likely happening when there is an error in the API URL or when
    351351     * local DNS services are not working.
    … …  
    387387
    388388    /**
    389      * Explains an {@see OsmTransferException} to the user.
    390      *
    391      * @param e the {@see OsmTransferException}
     389     * Explains an {@link OsmTransferException} to the user.
     390     *
     391     * @param e the {@link OsmTransferException}
    392392     */
    393393    public static void explainOsmTransferException(OsmTransferException e) {
    … …  
    470470    /**
    471471     * explains the case of an error due to a delete request on an already deleted
    472      * {@see OsmPrimitive}, i.e. a HTTP response code 410, where we don't know which
    473      * {@see OsmPrimitive} is causing the error.
     472     * {@link OsmPrimitive}, i.e. a HTTP response code 410, where we don't know which
     473     * {@link OsmPrimitive} is causing the error.
    474474     *
    475475     * @param e the exception
    … …  
    486486
    487487    /**
    488      * Explains an {@see Exception} to the user.
    489      *
    490      * @param e the {@see Exception}
     488     * Explains an {@link Exception} to the user.
     489     *
     490     * @param e the {@link Exception}
    491491     */
    492492    public static void explainException(Exception e) {

  • trunk/src/org/openstreetmap/josm/gui/ExtendedDialog.java

    r4932 r5266  
    9797    /**
    9898     * set to true if the content of the extended dialog should
    99      * be placed in a {@see JScrollPane}
     99     * be placed in a {@link JScrollPane}
    100100     */
    101101    private boolean placeContentInScrollPane;

  • trunk/src/org/openstreetmap/josm/gui/HelpAwareOptionPane.java

    r5200 r5266  
    134134     * @param msg the message
    135135     * @param title the title
    136      * @param messageType the message type (see {@see JOptionPane})
     136     * @param messageType the message type (see {@link JOptionPane})
    137137     * @param icon the icon to display. Can be null.
    138138     * @param options the list of options to display. Can be null.

  • trunk/src/org/openstreetmap/josm/gui/JosmUserIdentityManager.java

    r4612 r5266  
    3131 * of the current user.
    3232 *
    33  * The global JosmUserStateManager listens to {@see PreferenceChangeEvent}s and keeps track
     33 * The global JosmUserStateManager listens to {@link PreferenceChangeEvent}s and keeps track
    3434 * of what the current JOSM instance knows about the current user. Other subsystems can
    3535 * let the global JosmUserStateManager know in case they fully identify the current user, see
    36  * {@see #setFullyIdentified(String, long)}.
     36 * {@link #setFullyIdentified(String, long)}.
    3737 *
    3838 * The information kept by the JosmUserStateManager can be used to
    … …  
    138138
    139139    /**
    140      * Replies the user name of the current JOSM user. null, if {@see #isAnonymous()} is true.
     140     * Replies the user name of the current JOSM user. null, if {@link #isAnonymous()} is true.
    141141     *
    142142     * @return  the user name of the current JOSM user
    … …  
    147147
    148148    /**
    149      * Replies the user id of the current JOSM user. 0, if {@see #isAnonymous()} or
    150      * {@see #isPartiallyIdentified()} is true.
     149     * Replies the user id of the current JOSM user. 0, if {@link #isAnonymous()} or
     150     * {@link #isPartiallyIdentified()} is true.
    151151     *
    152152     * @return  the user id of the current JOSM user
    … …  
    159159    /**
    160160     * Replies verified additional information about the current user if the user is
    161      * {@see #isFullyIdentified()}.
     161     * {@link #isFullyIdentified()}.
    162162     *
    163163     * @return verified additional information about the current user
    … …  
    167167    }
    168168    /**
    169      * Initializes the user identity manager from values in the {@see org.openstreetmap.josm.data.Preferences}
     169     * Initializes the user identity manager from values in the {@link org.openstreetmap.josm.data.Preferences}
    170170     */
    171171    public void initFromPreferences() {

  • trunk/src/org/openstreetmap/josm/gui/MapView.java

    r5219 r5266  
    323323     * rules:
    324324     * <ul>
    325      *   <li>if there is at least one {@see OsmDataLayer} the first one
     325     *   <li>if there is at least one {@link OsmDataLayer} the first one
    326326     *     becomes active</li>
    327327     *   <li>otherwise, the top most layer of any type becomes active</li>
    … …  
    700700    /**
    701701     * Sets the active layer to <code>layer</code>. If <code>layer</code> is an instance
    702      * of {@see OsmDataLayer} also sets {@see #editLayer} to <code>layer</code>.
     702     * of {@link OsmDataLayer} also sets {@link #editLayer} to <code>layer</code>.
    703703     *
    704704     * @param layer the layer to be activate; must be one of the layers in the list of layers

  • trunk/src/org/openstreetmap/josm/gui/bbox/BBoxChooser.java

    r3720 r5266  
    1212
    1313    /**
    14      * A BBoxChooser emits {@see ProperyChangeEvent}s for this property
     14     * A BBoxChooser emits {@link ProperyChangeEvent}s for this property
    1515     * if the current bounding box changes.
    1616     */

  • trunk/src/org/openstreetmap/josm/gui/bbox/TileSelectionBBoxChooser.java

    r4516 r5266  
    187187    /**
    188188     * Listens to changes in the selected tile bounds, refreshes the map view and emits
    189      * property change events for {@see BBoxChooser#BBOX_PROP}
     189     * property change events for {@link BBoxChooser#BBOX_PROP}
    190190     */
    191191    class TileBoundsChangeListener implements PropertyChangeListener {
    … …  
    203203     * A panel for describing a rectangular area of OSM tiles at a given zoom level.
    204204     *
    205      * The panel emits PropertyChangeEvents for the property {@see TileGridInputPanel#TILE_BOUNDS_PROP}
     205     * The panel emits PropertyChangeEvents for the property {@link TileGridInputPanel#TILE_BOUNDS_PROP}
    206206     * when the user successfully enters a valid tile grid specification.
    207207     *

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/ComparePairType.java

    r3083 r5266  
    1313
    1414    /**
    15      * compare my version of an {@see OsmPrimitive} with their version
     15     * compare my version of an {@link OsmPrimitive} with their version
    1616     */
    1717    MY_WITH_THEIR (tr("My with Their"), new ListRole[] {MY_ENTRIES, THEIR_ENTRIES}),
    1818
    1919    /**
    20      * compare my version of an {@see OsmPrimitive} with the merged version
     20     * compare my version of an {@link OsmPrimitive} with the merged version
    2121     */
    2222    MY_WITH_MERGED (tr("My with Merged"),  new ListRole[] {MY_ENTRIES, MERGED_ENTRIES}),
    2323
    2424    /**
    25      * compare their version of an {@see OsmPrimitive} with the merged veresion
     25     * compare their version of an {@link OsmPrimitive} with the merged veresion
    2626     */
    2727    THEIR_WITH_MERGED(tr("Their with Merged"),  new ListRole[] {THEIR_ENTRIES, MERGED_ENTRIES});
    … …  
    6161
    6262    /**
    63      * replies the pair of {@see ListRole}s participating in this comparison
     63     * replies the pair of {@link ListRole}s participating in this comparison
    6464     * pair
    6565     *

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/ConflictResolver.java

    r4191 r5266  
    3535
    3636/**
    37  * An UI component for resolving conflicts between two {@see OsmPrimitive}s.
     37 * An UI component for resolving conflicts between two {@link OsmPrimitive}s.
    3838 *
    39  * This component emits {@see PropertyChangeEvent}s for three properties:
     39 * This component emits {@link PropertyChangeEvent}s for three properties:
    4040 * <ul>
    41  *   <li>{@see #RESOLVED_COMPLETELY_PROP} - new value is <code>true</code>, if the conflict is
     41 *   <li>{@link #RESOLVED_COMPLETELY_PROP} - new value is <code>true</code>, if the conflict is
    4242 *   completely resolved</li>
    43  *   <li>{@see #MY_PRIMITIVE_PROP} - new value is the {@see OsmPrimitive} in the role of
     43 *   <li>{@link #MY_PRIMITIVE_PROP} - new value is the {@link OsmPrimitive} in the role of
    4444 *   my primitive</li>
    45  *   <li>{@see #THEIR_PRIMITIVE_PROP} - new value is the {@see OsmPrimitive} in the role of
     45 *   <li>{@link #THEIR_PRIMITIVE_PROP} - new value is the {@link OsmPrimitive} in the role of
    4646 *   their primitive</li>
    4747 * </ul>
    … …  
    5454    /* -------------------------------------------------------------------------------------- */
    5555    /** name of the property indicating whether all conflicts are resolved,
    56      *  {@see #isResolvedCompletely()}
     56     *  {@link #isResolvedCompletely()}
    5757     */
    5858    static public final String RESOLVED_COMPLETELY_PROP = ConflictResolver.class.getName() + ".resolvedCompletely";
    5959    /**
    60      * name of the property for the {@see OsmPrimitive} in the role "my"
     60     * name of the property for the {@link OsmPrimitive} in the role "my"
    6161     */
    6262    static public final String MY_PRIMITIVE_PROP = ConflictResolver.class.getName() + ".myPrimitive";
    6363
    6464    /**
    65      * name of the property for the {@see OsmPrimitive} in the role "my"
     65     * name of the property for the {@link OsmPrimitive} in the role "my"
    6666     */
    6767    static public final String THEIR_PRIMITIVE_PROP = ConflictResolver.class.getName() + ".theirPrimitive";
    … …  
    136136
    137137    /**
    138      * Sets the {@see OsmPrimitive} in the role "my"
     138     * Sets the {@link OsmPrimitive} in the role "my"
    139139     *
    140140     * @param my the primitive in the role "my"
    … …  
    149149
    150150    /**
    151      * Sets the {@see OsmPrimitive} in the role "their".
     151     * Sets the {@link OsmPrimitive} in the role "their".
    152152     *
    153153     * @param their the primitive in the role "their"
    … …  
    284284
    285285    /**
    286      * Updates the state of the property {@see #RESOLVED_COMPLETELY_PROP}
     286     * Updates the state of the property {@link #RESOLVED_COMPLETELY_PROP}
    287287     *
    288288     */

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/ListMergeModel.java

    r4191 r5266  
    3939 * </ol>
    4040 *
    41  * A ListMergeModel is a factory for three {@see TableModel}s and three {@see ListSelectionModel}s:
     41 * A ListMergeModel is a factory for three {@link TableModel}s and three {@link ListSelectionModel}s:
    4242 * <ol>
    43  *   <li>the table model and the list selection for for a  {@see JTable} which shows my entries.
    44  *    See {@see #getMyTableModel()}</li> and {@see ListMergeModel#getMySelectionModel()}</li>
     43 *   <li>the table model and the list selection for for a  {@link JTable} which shows my entries.
     44 *    See {@link #getMyTableModel()}</li> and {@link ListMergeModel#getMySelectionModel()}</li>
    4545 *   <li>dito for their entries and merged entries</li>
    4646 * </ol>
    4747 *
    4848 * A ListMergeModel can be ''frozen''. If it's frozen, it doesn't accept additional merge
    49  * decisions. {@see PropertyChangeListener}s can register for property value changes of
    50  * {@see #PROP_FROZEN}.
     49 * decisions. {@link PropertyChangeListener}s can register for property value changes of
     50 * {@link #PROP_FROZEN}.
    5151 *
    5252 * ListMergeModel is an abstract class. Three methods have to be implemented by subclasses:
    5353 * <ul>
    54  *   <li>{@see ListMergeModel#cloneEntryForMergedList(Object)} - clones an entry of type T</li>
    55  *   <li>{@see ListMergeModel#isEqualEntry(Object, Object)} - checks whether two entries are equals </li>
    56  *   <li>{@see ListMergeModel#setValueAt(DefaultTableModel, Object, int, int)} - handles values edited in
    57  *     a JTable, dispatched from {@see TableModel#setValueAt(Object, int, int)} </li>
     54 *   <li>{@link ListMergeModel#cloneEntryForMergedList(Object)} - clones an entry of type T</li>
     55 *   <li>{@link ListMergeModel#isEqualEntry(Object, Object)} - checks whether two entries are equals </li>
     56 *   <li>{@link ListMergeModel#setValueAt(DefaultTableModel, Object, int, int)} - handles values edited in
     57 *     a JTable, dispatched from {@link TableModel#setValueAt(Object, int, int)} </li>
    5858 * </ul>
    59  * A ListMergeModel is used in combination with a {@see ListMerger}.
     59 * A ListMergeModel is used in combination with a {@link ListMerger}.
    6060 *
    6161 * @param <T>  the type of the list entries
    … …  
    101101
    102102    /**
    103      * Handles method dispatches from {@see TableModel#setValueAt(Object, int, int)}.
     103     * Handles method dispatches from {@link TableModel#setValueAt(Object, int, int)}.
    104104     *
    105105     * @param model the table model
    … …  
    545545
    546546    /**
    547      * This an adapter between a {@see JTable} and one of the three entry lists
    548      * in the role {@see ListRole} managed by the {@see ListMergeModel}.
    549      *
    550      * From the point of view of the {@see JTable} it is a {@see TableModel}.
     547     * This an adapter between a {@link JTable} and one of the three entry lists
     548     * in the role {@link ListRole} managed by the {@link ListMergeModel}.
     549     *
     550     * From the point of view of the {@link JTable} it is a {@link TableModel}.
    551551     *
    552552     * @param <T>
    … …  
    595595
    596596        /**
    597          * replies true if the {@see ListRole} of this {@see EntriesTableModel}
    598          * participates in the current {@see ComparePairType}
     597         * replies true if the {@link ListRole} of this {@link EntriesTableModel}
     598         * participates in the current {@link ComparePairType}
    599599         *
    600          * @return true, if the if the {@see ListRole} of this {@see EntriesTableModel}
    601          * participates in the current {@see ComparePairType}
     600         * @return true, if the if the {@link ListRole} of this {@link EntriesTableModel}
     601         * participates in the current {@link ComparePairType}
    602602         *
    603603         * @see ComparePairListModel#getSelectedComparePair()
    … …  
    611611        /**
    612612         * replies true if the entry at <code>row</code> is equal to the entry at the
    613          * same position in the opposite list of the current {@see ComparePairType}.
     613         * same position in the opposite list of the current {@link ComparePairType}.
    614614         *
    615615         * @param row  the row number
    616616         * @return true if the entry at <code>row</code> is equal to the entry at the
    617          * same position in the opposite list of the current {@see ComparePairType}
     617         * same position in the opposite list of the current {@link ComparePairType}
    618618         * @exception IllegalStateException thrown, if this model is not participating in the
    619          *   current  {@see ComparePairType}
     619         *   current  {@link ComparePairType}
    620620         * @see ComparePairType#getOppositeRole(ListRole)
    621621         * @see #getRole()
    … …  
    635635        /**
    636636         * replies true if the entry at the current position is present in the opposite list
    637          * of the current {@see ComparePairType}.
     637         * of the current {@link ComparePairType}.
    638638         *
    639639         * @param row the current row
    640640         * @return true if the entry at the current position is present in the opposite list
    641          * of the current {@see ComparePairType}.
     641         * of the current {@link ComparePairType}.
    642642         * @exception IllegalStateException thrown, if this model is not participating in the
    643          *   current  {@see ComparePairType}
     643         *   current  {@link ComparePairType}
    644644         * @see ComparePairType#getOppositeRole(ListRole)
    645645         * @see #getRole()
    … …  
    663663
    664664        /**
    665          * replies the opposite list of entries with respect to the current {@see ComparePairType}
     665         * replies the opposite list of entries with respect to the current {@link ComparePairType}
    666666         *
    667667         * @return the opposite list of entries
    … …  
    678678
    679679    /**
    680      * This is the selection model to be used in a {@see JTable} which displays
    681      * an entry list managed by {@see ListMergeModel}.
     680     * This is the selection model to be used in a {@link JTable} which displays
     681     * an entry list managed by {@link ListMergeModel}.
    682682     *
    683683     * The model ensures that only rows displaying an entry in the entry list

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/ListMerger.java

    r4310 r5266  
    882882    /**
    883883     * Synchronizes scrollbar adjustments between a set of
    884      * {@see Adjustable}s. Whenever the adjustment of one of
     884     * {@link Adjustable}s. Whenever the adjustment of one of
    885885     * the registerd Adjustables is updated the adjustment of
    886886     * the other registered Adjustables is adjusted too.
    … …  
    901901
    902902        /**
    903          * registers an {@see Adjustable} for participation in synchronized
     903         * registers an {@link Adjustable} for participation in synchronized
    904904         * scrolling.
    905905         *
    … …  
    917917
    918918        /**
    919          * event handler for {@see AdjustmentEvent}s
     919         * event handler for {@link AdjustmentEvent}s
    920920         *
    921921         */
    … …  
    960960
    961961        /**
    962          * wires a {@see JCheckBox} to  the adjustment synchronizer, in such a way  that:
     962         * wires a {@link JCheckBox} to  the adjustment synchronizer, in such a way  that:
    963963         * <li>
    964964         *   <ol>state changes in the checkbox control whether the adjustable participates
    965965         *      in synchronized adjustment</ol>
    966          *   <ol>state changes in this {@see AdjustmentSynchronizer} are reflected in the
    967          *      {@see JCheckBox}</ol>
     966         *   <ol>state changes in this {@link AdjustmentSynchronizer} are reflected in the
     967         *      {@link JCheckBox}</ol>
    968968         * </li>
    969969         *

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/ListRole.java

    r3083 r5266  
    33
    44/**
    5  * Enumeration of roles entry lists play in {@see ListMergeModel}
     5 * Enumeration of roles entry lists play in {@link ListMergeModel}
    66 */
    77public enum ListRole {

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/nodes/NodeListMergeModel.java

    r4191 r5266  
    2222
    2323    /**
    24      * Populates the model with the nodes in the two {@see Way}s <code>my</code> and
     24     * Populates the model with the nodes in the two {@link Way}s <code>my</code> and
    2525     * <code>their</code>.
    2626     *

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/nodes/NodeListMerger.java

    r4191 r5266  
    1313
    1414/**
    15  * A UI component for resolving conflicts in the node lists of two {@see Way}s.
     15 * A UI component for resolving conflicts in the node lists of two {@link Way}s.
    1616 *
    1717 */

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/nodes/NodeListTableCellRenderer.java

    r4162 r5266  
    2222
    2323/**
    24  * This is the {@see TableCellRenderer} used in the node tables of {@see NodeListMerger}.
     24 * This is the {@link TableCellRenderer} used in the node tables of {@link NodeListMerger}.
    2525 *
    2626 */
    … …  
    4040
    4141    /**
    42      * build the tool tip text for an {@see OsmPrimitive}. It consist of the formatted
     42     * build the tool tip text for an {@link OsmPrimitive}. It consist of the formatted
    4343     * key/value pairs for this primitive.
    4444     *

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/properties/PropertiesMergeModel.java

    r4310 r5266  
    2323/**
    2424 * This is the model for resolving conflicts in the properties of the
    25  * {@see OsmPrimitive}s. In particular, it represents conflicts in the coordinates of {@see Node}s and
    26  * the deleted or visible state of {@see OsmPrimitive}s.
     25 * {@link OsmPrimitive}s. In particular, it represents conflicts in the coordinates of {@link Node}s and
     26 * the deleted or visible state of {@link OsmPrimitive}s.
    2727 *
    28  * This model is an {@see Observable}. It notifies registered {@see Observer}s whenever the
     28 * This model is an {@link Observable}. It notifies registered {@link Observer}s whenever the
    2929 * internal state changes.
    3030 *
    31  * This model also emits property changes for {@see #RESOLVED_COMPLETELY_PROP}. Property change
    32  * listeners may register themselves using {@see #addPropertyChangeListener(PropertyChangeListener)}.
     31 * This model also emits property changes for {@link #RESOLVED_COMPLETELY_PROP}. Property change
     32 * listeners may register themselves using {@link #addPropertyChangeListener(PropertyChangeListener)}.
    3333 *
    3434 * @see Node#getCoor()
    … …  
    150150
    151151    /**
    152      * replies the coordinates of my {@see OsmPrimitive}. null, if my primitive hasn't
    153      * coordinates (i.e. because it is a {@see Way}).
    154      *
    155      * @return the coordinates of my {@see OsmPrimitive}. null, if my primitive hasn't
    156      *  coordinates (i.e. because it is a {@see Way}).
     152     * replies the coordinates of my {@link OsmPrimitive}. null, if my primitive hasn't
     153     * coordinates (i.e. because it is a {@link Way}).
     154     *
     155     * @return the coordinates of my {@link OsmPrimitive}. null, if my primitive hasn't
     156     *  coordinates (i.e. because it is a {@link Way}).
    157157     */
    158158    public LatLon getMyCoords() {
    … …  
    161161
    162162    /**
    163      * replies the coordinates of their {@see OsmPrimitive}. null, if their primitive hasn't
    164      * coordinates (i.e. because it is a {@see Way}).
    165      *
    166      * @return the coordinates of my {@see OsmPrimitive}. null, if my primitive hasn't
    167      * coordinates (i.e. because it is a {@see Way}).
     163     * replies the coordinates of their {@link OsmPrimitive}. null, if their primitive hasn't
     164     * coordinates (i.e. because it is a {@link Way}).
     165     *
     166     * @return the coordinates of my {@link OsmPrimitive}. null, if my primitive hasn't
     167     * coordinates (i.e. because it is a {@link Way}).
    168168     */
    169169    public LatLon getTheirCoords() {
    … …  
    172172
    173173    /**
    174      * replies the coordinates of the merged {@see OsmPrimitive}. null, if the current primitives
    175      * have no coordinates or if the conflict is yet {@see MergeDecisionType#UNDECIDED}
    176      *
    177      * @return the coordinates of the merged {@see OsmPrimitive}. null, if the current primitives
    178      * have no coordinates or if the conflict is yet {@see MergeDecisionType#UNDECIDED}
     174     * replies the coordinates of the merged {@link OsmPrimitive}. null, if the current primitives
     175     * have no coordinates or if the conflict is yet {@link MergeDecisionType#UNDECIDED}
     176     *
     177     * @return the coordinates of the merged {@link OsmPrimitive}. null, if the current primitives
     178     * have no coordinates or if the conflict is yet {@link MergeDecisionType#UNDECIDED}
    179179     */
    180180    public LatLon getMergedCoords() {

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/properties/PropertiesMerger.java

    r4310 r5266  
    3131/**
    3232 * This class represents a UI component for resolving conflicts in some properties
    33  * of {@see OsmPrimitive}.
     33 * of {@link OsmPrimitive}.
    3434 *
    3535 */

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/relation/RelationMemberMerger.java

    r4191 r5266  
    1313
    1414/**
    15  * A UI component for resolving conflicts in the member lists of two {@see Relation}
     15 * A UI component for resolving conflicts in the member lists of two {@link Relation}
    1616 */
    1717public class RelationMemberMerger extends ListMerger<RelationMember> implements IConflictResolver {

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/relation/RelationMemberTableCellEditor.java

    r4478 r5266  
    1414
    1515/**
    16  * {@see TableCellEditor} for the role column in a table for {@see RelationMember}s.
     16 * {@link TableCellEditor} for the role column in a table for {@link RelationMember}s.
    1717 *
    1818 */

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/relation/RelationMemberTableCellRenderer.java

    r4162 r5266  
    2222
    2323/**
    24  * This is the {@see TableCellRenderer} used in the tables of {@see RelationMemberMerger}.
     24 * This is the {@link TableCellRenderer} used in the tables of {@link RelationMemberMerger}.
    2525 *
    2626 */

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/tags/TagMergeModel.java

    r4191 r5266  
    1717
    1818/**
    19  * This is the {@see TableModel} used in the tables of the {@see TagMerger}.
    20  *
    21  * The model can {@see #populate(OsmPrimitive, OsmPrimitive)} itself from the conflicts
    22  * in the tag sets of two {@see OsmPrimitive}s. Internally, it keeps a list of {@see TagMergeItem}s.
    23  *
    24  *  {@see #decide(int, MergeDecisionType)} and {@see #decide(int[], MergeDecisionType)} can be used
     19 * This is the {@link TableModel} used in the tables of the {@link TagMerger}.
     20 *
     21 * The model can {@link #populate(OsmPrimitive, OsmPrimitive)} itself from the conflicts
     22 * in the tag sets of two {@link OsmPrimitive}s. Internally, it keeps a list of {@link TagMergeItem}s.
     23 *
     24 *  {@link #decide(int, MergeDecisionType)} and {@link #decide(int[], MergeDecisionType)} can be used
    2525 *  to remember a merge decision for a specific row in the model.
    2626 *
    27  *  The model notifies {@see PropertyChangeListener}s about updates of the number of
    28  *  undecided tags (see {@see #PROP_NUM_UNDECIDED_TAGS}).
     27 *  The model notifies {@link PropertyChangeListener}s about updates of the number of
     28 *  undecided tags (see {@link #PROP_NUM_UNDECIDED_TAGS}).
    2929 *
    3030 */
    … …  
    6262
    6363    /**
    64      * notifies {@see PropertyChangeListener}s about an update of {@see TagMergeModel#PROP_NUM_UNDECIDED_TAGS}
     64     * notifies {@link PropertyChangeListener}s about an update of {@link TagMergeModel#PROP_NUM_UNDECIDED_TAGS}
    6565
    6666     * @param oldValue the old value
    … …  
    7878    /**
    7979     * refreshes the number of undecided tag conflicts after an update in the list of
    80      * {@see TagMergeItem}s. Notifies {@see PropertyChangeListener} if necessary.
     80     * {@link TagMergeItem}s. Notifies {@link PropertyChangeListener} if necessary.
    8181     *
    8282     */
    … …  
    9696    /**
    9797     * Populate the model with conflicts between the tag sets of the two
    98      * {@see OsmPrimitive} <code>my</code> and <code>their</code>.
     98     * {@link OsmPrimitive} <code>my</code> and <code>their</code>.
    9999     *
    100100     * @param my  my primitive (i.e. the primitive from the local dataset)
    … …  
    121121
    122122    /**
    123      * add a {@see TagMergeItem} to the model
     123     * add a {@link TagMergeItem} to the model
    124124     *
    125125     * @param item the item
    … …  
    139139
    140140    /**
    141      * set the merge decision of the {@see TagMergeItem} in row <code>row</code>
     141     * set the merge decision of the {@link TagMergeItem} in row <code>row</code>
    142142     * to <code>decision</code>.
    143143     *
    … …  
    152152
    153153    /**
    154      * set the merge decision of all {@see TagMergeItem} given by indices in <code>rows</code>
     154     * set the merge decision of all {@link TagMergeItem} given by indices in <code>rows</code>
    155155     * to <code>decision</code>.
    156156     *

  • trunk/src/org/openstreetmap/josm/gui/conflict/pair/tags/TagMerger.java

    r3083 r5266  
    3232import org.openstreetmap.josm.tools.ImageProvider;
    3333/**
    34  * UI component for resolving conflicts in the tag sets of two {@see OsmPrimitive}s.
     34 * UI component for resolving conflicts in the tag sets of two {@link OsmPrimitive}s.
    3535 *
    3636 */
    … …  
    4646
    4747    /**
    48      * embeds table in a new {@see JScrollPane} and returns th scroll pane
     48     * embeds table in a new {@link JScrollPane} and returns th scroll pane
    4949     *
    5050     * @param table the table
    … …  
    322322    /**
    323323     * Synchronizes scrollbar adjustments between a set of
    324      * {@see Adjustable}s. Whenever the adjustment of one of
     324     * {@link Adjustable}s. Whenever the adjustment of one of
    325325     * the registerd Adjustables is updated the adjustment of
    326326     * the other registered Adjustables is adjusted too.
    … …  
    385385    /**
    386386     * Sets the currently selected tags in the table of merged tags to state
    387      * {@see MergeDecisionType#UNDECIDED}
     387     * {@link MergeDecisionType#UNDECIDED}
    388388     *
    389389     */

  • trunk/src/org/openstreetmap/josm/gui/conflict/tags/CombinePrimitiveResolverDialog.java

    r5132 r5266  
    6161 *
    6262 * There is a singleton instance of this dialog which can be retrieved using
    63  * {@see #getInstance()}.
     63 * {@link #getInstance()}.
    6464 *
    6565 * The dialog uses two models: one  for resolving tag conflicts, the other
    6666 * for resolving conflicts in relation memberships. For both models there are accessors,
    67  * i.e {@see #getTagConflictResolverModel()} and {@see #getRelationMemberConflictResolverModel()}.
     67 * i.e {@link #getTagConflictResolverModel()} and {@link #getRelationMemberConflictResolverModel()}.
    6868 *
    6969 * Models have to be <strong>populated</strong> before the dialog is launched. Example:
    … …  
    7676 *
    7777 * You should also set the target primitive which other primitives (ways or nodes) are
    78  * merged to, see {@see #setTargetPrimitive(OsmPrimitive)}.
    79  *
    80  * After the dialog is closed use {@see #isCanceled()} to check whether the user canceled
    81  * the dialog. If it wasn't canceled you may build a collection of {@see Command} objects
     78 * merged to, see {@link #setTargetPrimitive(OsmPrimitive)}.
     79 *
     80 * After the dialog is closed use {@link #isCanceled()} to check whether the user canceled
     81 * the dialog. If it wasn't canceled you may build a collection of {@link Command} objects
    8282 * which reflect the conflict resolution decisions the user made in the dialog:
    83  * see {@see #buildResolutionCommands()}
     83 * see {@link #buildResolutionCommands()}
    8484 *
    8585 *

  • trunk/src/org/openstreetmap/josm/gui/conflict/tags/MultiValueCellEditor.java

    r4162 r5266  
    2727 *
    2828 * The editor responds intercepts some keys and interprets them as navigation keys. It
    29  * forwards navigation events to {@see NavigationListener}s registred with this editor.
    30  * You should register the parent table using this editor as {@see NavigationListener}.
     29 * forwards navigation events to {@link NavigationListener}s registred with this editor.
     30 * You should register the parent table using this editor as {@link NavigationListener}.
    3131 *
    32  * {@see KeyEvent#VK_ENTER} and {@see KeyEvent#VK_TAB} trigger a {@see NavigationListener#gotoNextDecision()}.
     32 * {@link KeyEvent#VK_ENTER} and {@link KeyEvent#VK_TAB} trigger a {@link NavigationListener#gotoNextDecision()}.
    3333 */
    3434public class MultiValueCellEditor extends AbstractCellEditor implements TableCellEditor{

  • trunk/src/org/openstreetmap/josm/gui/conflict/tags/MultiValueCellRenderer.java

    r4162 r5266  
    2020
    2121/**
    22  * This is a {@see TableCellRenderer} for {@see MultiValueResolutionDecision}s.
     22 * This is a {@link TableCellRenderer} for {@link MultiValueResolutionDecision}s.
    2323 *
    2424 */

  • trunk/src/org/openstreetmap/josm/gui/conflict/tags/MultiValueResolutionDecision.java

    r4223 r5266  
    2727    /** the collection of tags for which a decision is needed */
    2828    private TagCollection  tags;
    29     /** the selected value if {@see #type} is {@see MultiValueDecisionType#KEEP_ONE} */
     29    /** the selected value if {@link #type} is {@link MultiValueDecisionType#KEEP_ONE} */
    3030    private String value;
    3131
    … …  
    201201
    202202    /**
    203      * Applies the resolution to an {@see OsmPrimitive}
     203     * Applies the resolution to an {@link OsmPrimitive}
    204204     *
    205205     * @param primitive the primitive

  • trunk/src/org/openstreetmap/josm/gui/conflict/tags/RelationMemberConflictResolverModel.java

    r5090 r5266  
    2323 * This model manages a list of conflicting relation members.
    2424 *
    25  * It can be used as {@see TableModel}.
     25 * It can be used as {@link TableModel}.
    2626 *
    2727 *
    … …  
    152152    /**
    153153     * Populates the model with the relation members represented as a collection of
    154      * {@see RelationToChildReference}s.
     154     * {@link RelationToChildReference}s.
    155155     *
    156156     * @param references the references. Empty list assumed if null.
    … …  
    252252     *
    253253     * @param newPrimitive the primitive which members shall refer to if the
    254      * decision is {@see RelationMemberConflictDecisionType#REPLACE}
     254     * decision is {@link RelationMemberConflictDecisionType#REPLACE}
    255255     * @return a list of commands
    256256     */
    … …  
    291291     *
    292292     * @param newPrimitive the primitive which members shall refer to if the
    293      * decision is {@see RelationMemberConflictDecisionType#REPLACE}
     293     * decision is {@link RelationMemberConflictDecisionType#REPLACE}
    294294     *
    295295     * @return the set of relations which have to be modified according

  • trunk/src/org/openstreetmap/josm/gui/conflict/tags/TagConflictResolver.java

    r5132 r5266  
    2020/**
    2121 * This is a UI widget for resolving tag conflicts, i.e. differences of the tag values
    22  * of multiple {@see OsmPrimitive}s.
     22 * of multiple {@link OsmPrimitive}s.
    2323 *
    2424 *

  • trunk/src/org/openstreetmap/josm/gui/conflict/tags/TagConflictResolverModel.java

    r5090 r5266  
    165165
    166166    /**
    167      * Replies true if each {@see MultiValueResolutionDecision} is decided.
    168      *
    169      * @return true if each {@see MultiValueResolutionDecision} is decided; false
     167     * Replies true if each {@link MultiValueResolutionDecision} is decided.
     168     *
     169     * @return true if each {@link MultiValueResolutionDecision} is decided; false
    170170     * otherwise
    171171     */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/ConflictDialog.java

    r4982 r5266  
    5050
    5151/**
    52  * This dialog displays the {@see ConflictCollection} of the active {@see OsmDataLayer} in a toggle
     52 * This dialog displays the {@link ConflictCollection} of the active {@link OsmDataLayer} in a toggle
    5353 * dialog on the right of the main frame.
    5454 *
    … …  
    273273
    274274    /**
    275      * The {@see ListModel} for conflicts
     275     * The {@link ListModel} for conflicts
    276276     *
    277277     */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/ConflictResolutionDialog.java

    r4189 r5266  
    3434
    3535/**
    36  * This is an extended dialog for resolving conflict between {@see OsmPrimitive}s.
     36 * This is an extended dialog for resolving conflict between {@link OsmPrimitive}s.
    3737 *
    3838 */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/LayerListDialog.java

    r5200 r5266  
    321321    /**
    322322     * Wires <code>listener</code> to <code>listSelectionModel</code> in such a way, that
    323      * <code>listener</code> receives a {@see IEnabledStateUpdating#updateEnabledState()}
    324      * on every {@see ListSelectionEvent}.
     323     * <code>listener</code> receives a {@link IEnabledStateUpdating#updateEnabledState()}
     324     * on every {@link ListSelectionEvent}.
    325325     *
    326326     * @param listener  the listener
    327      * @param listSelectionModel  the source emitting {@see ListSelectionEvent}s
     327     * @param listSelectionModel  the source emitting {@link ListSelectionEvent}s
    328328     */
    329329    protected void adaptTo(final IEnabledStateUpdating listener, ListSelectionModel listSelectionModel) {
    … …  
    340340    /**
    341341     * Wires <code>listener</code> to <code>listModel</code> in such a way, that
    342      * <code>listener</code> receives a {@see IEnabledStateUpdating#updateEnabledState()}
    343      * on every {@see ListDataEvent}.
     342     * <code>listener</code> receives a {@link IEnabledStateUpdating#updateEnabledState()}
     343     * on every {@link ListDataEvent}.
    344344     *
    345345     * @param listener  the listener
    346      * @param listSelectionModel  the source emitting {@see ListDataEvent}s
     346     * @param listSelectionModel  the source emitting {@link ListDataEvent}s
    347347     */
    348348    protected void adaptTo(final IEnabledStateUpdating listener, LayerListModel listModel) {
    … …  
    375375    public final class DeleteLayerAction extends AbstractAction implements IEnabledStateUpdating, LayerAction {
    376376        /**
    377          * Creates a {@see DeleteLayerAction} which will delete the currently
     377         * Creates a {@link DeleteLayerAction} which will delete the currently
    378378         * selected layers in the layer dialog.
    379379         *
    … …  
    456456
    457457        /**
    458          * Creates a {@see ShowHideLayerAction} which will toggle the visibility of
     458         * Creates a {@link ShowHideLayerAction} which will toggle the visibility of
    459459         * the currently selected layers
    460460         *
    … …  
    546546
    547547        /**
    548          * Creates a {@see LayerOpacityAction} which allows to chenge the
     548         * Creates a {@link LayerOpacityAction} which allows to chenge the
    549549         * opacity of one or more layers.
    550550         *
    … …  
    561561
    562562        /**
    563          * Creates a {@see ShowHideLayerAction} which will toggle the visibility of
     563         * Creates a {@link ShowHideLayerAction} which will toggle the visibility of
    564564         * the currently selected layers
    565565         *
    … …  
    10991099
    11001100    /**
    1101      * Observer interface to be implemented by views using {@see LayerListModel}
     1101     * Observer interface to be implemented by views using {@link LayerListModel}
    11021102     *
    11031103     */
    … …  
    11111111     * moving layers up and down, for toggling their visibility, and for activating a layer.
    11121112     *
    1113      * The model is a {@see TableModel} and it provides a {@see ListSelectionModel}. It expects
    1114      * to be configured with a {@see DefaultListSelectionModel}. The selection model is used
     1113     * The model is a {@link TableModel} and it provides a {@link ListSelectionModel}. It expects
     1114     * to be configured with a {@link DefaultListSelectionModel}. The selection model is used
    11151115     * to update the selection state of views depending on messages sent to the model.
    11161116     *
    1117      * The model manages a list of {@see LayerListModelListener} which are mainly notified if
     1117     * The model manages a list of {@link LayerListModelListener} which are mainly notified if
    11181118     * the model requires views to make a specific list entry visible.
    11191119     *
    1120      * It also listens to {@see PropertyChangeEvent}s of every {@see Layer} it manages, in particular to
    1121      * the properties {@see Layer#VISIBLE_PROP} and {@see Layer#NAME_PROP}.
     1120     * It also listens to {@link PropertyChangeEvent}s of every {@link Layer} it manages, in particular to
     1121     * the properties {@link Layer#VISIBLE_PROP} and {@link Layer#NAME_PROP}.
    11221122     */
    11231123    public class LayerListModel extends AbstractTableModel implements MapView.LayerChangeListener, PropertyChangeListener {
    … …  
    11821182        /**
    11831183         * Populates the model with the current layers managed by
    1184          * {@see MapView}.
     1184         * {@link MapView}.
    11851185         *
    11861186         */
    … …  
    12461246
    12471247        /**
    1248          * Invoked if a layer managed by {@see MapView} is removed
     1248         * Invoked if a layer managed by {@link MapView} is removed
    12491249         *
    12501250         * @param layer the layer which is removed
    … …  
    12651265
    12661266        /**
    1267          * Invoked when a layer managed by {@see MapView} is added
     1267         * Invoked when a layer managed by {@link MapView} is added
    12681268         *
    12691269         * @param layer the layer
    … …  
    14061406
    14071407        /**
    1408          * Replies the list of layers currently managed by {@see MapView}.
     1408         * Replies the list of layers currently managed by {@link MapView}.
    14091409         * Never null, but can be empty.
    14101410         *
    1411          * @return the list of layers currently managed by {@see MapView}.
     1411         * @return the list of layers currently managed by {@link MapView}.
    14121412         * Never null, but can be empty.
    14131413         */
    … …  
    15631563
    15641564    /**
    1565      * Creates a {@see ShowHideLayerAction} for <code>layer</code> in the
    1566      * context of this {@see LayerListDialog}.
     1565     * Creates a {@link ShowHideLayerAction} for <code>layer</code> in the
     1566     * context of this {@link LayerListDialog}.
    15671567     *
    15681568     * @param layer the layer
    … …  
    15761576
    15771577    /**
    1578      * Creates a {@see DeleteLayerAction} for <code>layer</code> in the
    1579      * context of this {@see LayerListDialog}.
     1578     * Creates a {@link DeleteLayerAction} for <code>layer</code> in the
     1579     * context of this {@link LayerListDialog}.
    15801580     *
    15811581     * @param layer the layer
    … …  
    15881588
    15891589    /**
    1590      * Creates a {@see ActivateLayerAction} for <code>layer</code> in the
    1591      * context of this {@see LayerListDialog}.
     1590     * Creates a {@link ActivateLayerAction} for <code>layer</code> in the
     1591     * context of this {@link LayerListDialog}.
    15921592     *
    15931593     * @param layer the layer
    … …  
    15991599
    16001600    /**
    1601      * Creates a {@see MergeLayerAction} for <code>layer</code> in the
    1602      * context of this {@see LayerListDialog}.
     1601     * Creates a {@link MergeLayerAction} for <code>layer</code> in the
     1602     * context of this {@link LayerListDialog}.
    16031603     *
    16041604     * @param layer the layer

  • trunk/src/org/openstreetmap/josm/gui/dialogs/RelationListDialog.java

    r5200 r5266  
    183183    /**
    184184     * Initializes the relation list dialog from a layer. If <code>layer</code> is null
    185      * or if it isn't an {@see OsmDataLayer} the dialog is reset to an empty dialog.
     185     * or if it isn't an {@link OsmDataLayer} the dialog is reset to an empty dialog.
    186186     * Otherwise it is initialized with the list of non-deleted and visible relations
    187187     * in the layer's dataset.

  • trunk/src/org/openstreetmap/josm/gui/dialogs/SelectionListDialog.java

    r5200 r5266  
    440440     * The list model for the list of OSM primitives in the current JOSM selection.
    441441     *
    442      * The model also maintains a history of the last {@see SelectionListModel#SELECTION_HISTORY_SIZE}
     442     * The model also maintains a history of the last {@link SelectionListModel#SELECTION_HISTORY_SIZE}
    443443     * JOSM selection.
    444444     *

  • trunk/src/org/openstreetmap/josm/gui/dialogs/ToggleDialog.java

    r5207 r5266  
    187187     * The action to toggle the visibility state of this toggle dialog.
    188188     *
    189      * Emits {@see PropertyChangeEvent}s for the property <tt>selected</tt>:
     189     * Emits {@link PropertyChangeEvent}s for the property <tt>selected</tt>:
    190190     * <ul>
    191191     *   <li>true, if the dialog is currently visible</li>

  • trunk/src/org/openstreetmap/josm/gui/dialogs/ValidatorDialog.java

    r5200 r5266  
    535535
    536536    /**
    537      * Task for fixing a collection of {@see TestError}s. Can be run asynchronously.
     537     * Task for fixing a collection of {@link TestError}s. Can be run asynchronously.
    538538     *
    539539     *

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/ChangesetCacheManagerModel.java

    r3083 r5266  
    4848    /**
    4949     * Sets the changeset currently displayed in the detail view. Fires a property change event
    50      * for the property {@see #CHANGESET_IN_DETAIL_VIEW_PROP} if necessary.
     50     * for the property {@link #CHANGESET_IN_DETAIL_VIEW_PROP} if necessary.
    5151     *
    5252     * @param cs the changeset currently displayed in the detail view.
    … …  
    118118     * Selects the changeset displayed at row <code>row</code>
    119119     *
    120      * @param row the row. Ignored if < 0 or >= {@see #getRowCount()}
     120     * @param row the row. Ignored if < 0 or >= {@link #getRowCount()}
    121121     */
    122122    public void setSelectedByIdx(int row) {

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/ChangesetContentDownloadTask.java

    r4310 r5266  
    8787     * Creates a download task for a single changeset
    8888     *
    89      * @param parent the parent component for the {@see PleaseWaitDialog}. Must not be null.
     89     * @param parent the parent component for the {@link PleaseWaitDialog}. Must not be null.
    9090     * @param changesetId the changeset id. >0 required.
    9191     * @throws IllegalArgumentException thrown if changesetId <= 0
    … …  
    103103     * the collection are sillently discarded.
    104104     *
    105      * @param parent the parent component for the {@see PleaseWaitDialog}. Must not be null.
     105     * @param parent the parent component for the {@link PleaseWaitDialog}. Must not be null.
    106106     * @param changesetIds the changeset ids. Empty collection assumed, if null.
    107107     * @throws IllegalArgumentException thrown if parent is null
    … …  
    113113
    114114    /**
    115      * Replies true if the local {@see ChangesetCache} already includes the changeset with
     115     * Replies true if the local {@link ChangesetCache} already includes the changeset with
    116116     * id <code>changesetId</code>.
    117117     *
    118118     * @param changesetId the changeset id
    119      * @return true if the local {@see ChangesetCache} already includes the changeset with
     119     * @return true if the local {@link ChangesetCache} already includes the changeset with
    120120     * id <code>changesetId</code>
    121121     */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/ChangesetContentPanel.java

    r4786 r5266  
    5757 * The panel which displays the content of a changeset in a scollable table.
    5858 *
    59  * It listens to property change events for {@see ChangesetCacheManagerModel#CHANGESET_IN_DETAIL_VIEW_PROP}
     59 * It listens to property change events for {@link ChangesetCacheManagerModel#CHANGESET_IN_DETAIL_VIEW_PROP}
    6060 * and updates its view accordingly.
    6161 *

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/ChangesetContentTableCellRenderer.java

    r4072 r5266  
    1616/**
    1717 * The table cell renderer used in the changeset content table, except for the "name"
    18  * column in which we use a {@see OsmPrimitivRenderer}.
     18 * column in which we use a {@link OsmPrimitivRenderer}.
    1919 *
    2020 */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/ChangesetContentTableModel.java

    r3083 r5266  
    131131
    132132    /**
    133      * The type used internally to keep information about {@see HistoryOsmPrimitive}
    134      * with their {@see ChangesetModificationType}.
     133     * The type used internally to keep information about {@link HistoryOsmPrimitive}
     134     * with their {@link ChangesetModificationType}.
    135135     *
    136136     */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/ChangesetDetailPanel.java

    r3995 r5266  
    4444/**
    4545 * This panel displays the properties of the currently selected changeset in the
    46  * {@see ChangesetCacheManager}.
     46 * {@link ChangesetCacheManager}.
    4747 *
    4848 */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/ChangesetHeaderDownloadTask.java

    r4310 r5266  
    3131 *
    3232 * The  task only downloads the changeset properties without the changeset content. It
    33  * updates the global {@see ChangesetCache}.
     33 * updates the global {@link ChangesetCache}.
    3434 *
    3535 */
    … …  
    3939     * Builds a download task from for a collection of changesets.
    4040     *
    41      * Ignores null values and changesets with {@see Changeset#isNew()} == true.
     41     * Ignores null values and changesets with {@link Changeset#isNew()} == true.
    4242     *
    4343     * @param changesets the collection of changesets. Assumes an empty collection if null.
    … …  
    5151     * Builds a download task from for a collection of changesets.
    5252     *
    53      * Ignores null values and changesets with {@see Changeset#isNew()} == true.
    54      *
    55      * @param parent the parent component relative to which the {@see PleaseWaitDialog} is displayed.
     53     * Ignores null values and changesets with {@link Changeset#isNew()} == true.
     54     *
     55     * @param parent the parent component relative to which the {@link PleaseWaitDialog} is displayed.
    5656     * Must not be null.
    5757     * @param changesets the collection of changesets. Assumes an empty collection if null.
    … …  
    101101
    102102    /**
    103      * Creates the download task for a collection of changeset ids. Uses a {@see PleaseWaitDialog}
    104      * whose parent is {@see Main#parent}.
     103     * Creates the download task for a collection of changeset ids. Uses a {@link PleaseWaitDialog}
     104     * whose parent is {@link Main#parent}.
    105105     *
    106106     * Null ids or or ids <= 0 in the id collection are ignored.
    … …  
    115115
    116116    /**
    117      * Creates the download task for a collection of changeset ids. Uses a {@see PleaseWaitDialog}
     117     * Creates the download task for a collection of changeset ids. Uses a {@link PleaseWaitDialog}
    118118     * whose parent is the parent window of <code>dialogParent</code>.
    119119     *
    120120     * Null ids or or ids <= 0 in the id collection are ignored.
    121121     *
    122      * @param dialogParent the parent reference component for the {@see PleaseWaitDialog}. Must not be null.
     122     * @param dialogParent the parent reference component for the {@link PleaseWaitDialog}. Must not be null.
    123123     * @param ids the collection of ids. Empty collection assumed if null.
    124124     * @throws IllegalArgumentException thrown if dialogParent is null

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/ChangesetTagsPanel.java

    r3141 r5266  
    1515
    1616/**
    17  * This panel displays the tags of the currently selected changeset in the {@see ChangesetCacheManager}
     17 * This panel displays the tags of the currently selected changeset in the {@link ChangesetCacheManager}
    1818 *
    1919 */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/SingleChangesetDownloadPanel.java

    r3083 r5266  
    116116
    117117    /**
    118      * Validator for a changeset ID entered in a {@see JTextComponent}.
     118     * Validator for a changeset ID entered in a {@link JTextComponent}.
    119119     *
    120120     */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/query/AdvancedChangesetQueryPanel.java

    r4307 r5266  
    960960
    961961    /**
    962      * Validator for user ids entered in in a {@see JTextComponent}.
     962     * Validator for user ids entered in in a {@link JTextComponent}.
    963963     *
    964964     */
    … …  
    10361036
    10371037    /**
    1038      * Validates dates entered as text in in a {@see JTextComponent}. Validates the input
     1038     * Validates dates entered as text in in a {@link JTextComponent}. Validates the input
    10391039     * on the fly and gives feedback about whether the date is valid or not.
    10401040     *
    … …  
    10991099
    11001100    /**
    1101      * Validates time values entered as text in in a {@see JTextComponent}. Validates the input
     1101     * Validates time values entered as text in in a {@link JTextComponent}. Validates the input
    11021102     * on the fly and gives feedback about whether the time value is valid or not.
    11031103     *

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/query/ChangesetQueryTask.java

    r4310 r5266  
    6262     * Creates the task.
    6363     *
    64      * @param parent the parent component relative to which the {@see PleaseWaitDialog} is displayed.
     64     * @param parent the parent component relative to which the {@link PleaseWaitDialog} is displayed.
    6565     * Must not be null.
    6666     * @param query the query to submit to the OSM server. Must not be null.

  • trunk/src/org/openstreetmap/josm/gui/dialogs/changeset/query/UrlBasedQueryPanel.java

    r3530 r5266  
    140140
    141141    /**
    142      * Replies the {@see ChangesetQuery} specified in this panel. null, if no valid changeset query
     142     * Replies the {@link ChangesetQuery} specified in this panel. null, if no valid changeset query
    143143     * is specified.
    144144     *

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/ChildRelationBrowser.java

    r4471 r5266  
    6464
    6565    /**
    66      * Replies the {@see OsmDataLayer} this editor is related to
     66     * Replies the {@link OsmDataLayer} this editor is related to
    6767     *
    6868     * @return the osm data layer
    … …  
    113113     * constructor
    114114     *
    115      * @param layer the {@see OsmDataLayer} this browser is related to. Must not be null.
     115     * @param layer the {@link OsmDataLayer} this browser is related to. Must not be null.
    116116     * @exception IllegalArgumentException thrown, if layer is null
    117117     */
    … …  
    126126     * constructor
    127127     *
    128      * @param layer the {@see OsmDataLayer} this browser is related to. Must not be null.
     128     * @param layer the {@link OsmDataLayer} this browser is related to. Must not be null.
    129129     * @param root the root relation
    130130     * @exception IllegalArgumentException thrown, if layer is null
    … …  
    157157     * replies the parent dialog this browser is embedded in
    158158     *
    159      * @return the parent dialog; null, if there is no {@see Dialog} as parent dialog
     159     * @return the parent dialog; null, if there is no {@link Dialog} as parent dialog
    160160     */
    161161    protected Dialog getParentDialog() {

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/DownloadRelationTask.java

    r4310 r5266  
    2424/**
    2525 * The asynchronous task for fully downloading a collection of relations. Does a full download
    26  * for each relations and merges the relation into an {@see OsmDataLayer}
     26 * for each relations and merges the relation into an {@link OsmDataLayer}
    2727 *
    2828 */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/GenericRelationEditor.java

    r5082 r5266  
    105105     * If no relation is given, will create an editor for a new relation.
    106106     *
    107      * @param layer the {@see OsmDataLayer} the new or edited relation belongs to
     107     * @param layer the {@link OsmDataLayer} the new or edited relation belongs to
    108108     * @param relation relation to edit, or null to create a new one.
    109109     * @param selectedMembers a collection of members which shall be selected initially
    … …  
    425425
    426426    /**
    427      * builds the {@see JSplitPane} which divides the editor in an upper and a lower half
     427     * builds the {@link JSplitPane} which divides the editor in an upper and a lower half
    428428     *
    429429     * @return the split panel

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/MemberTableCellRenderer.java

    r3083 r5266  
    1313
    1414/**
    15  * This is the {@see TableCellRenderer} used in the tables of {@see RelationMemberMerger}.
     15 * This is the {@link TableCellRenderer} used in the tables of {@link RelationMemberMerger}.
    1616 *
    1717 */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/MemberTableModel.java

    r5082 r5266  
    599599
    600600    /**
    601      * Selects all mebers which refer to {@see OsmPrimitive}s in the collections
     601     * Selects all mebers which refer to {@link OsmPrimitive}s in the collections
    602602     * <code>primitmives</code>. Does nothing is primitives is null.
    603603     *

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/ReferringRelationsBrowserModel.java

    r3083 r5266  
    6969
    7070    /**
    71      * Populates the browser with the list of referring relations in the {@see DataSet} ds.
     71     * Populates the browser with the list of referring relations in the {@link DataSet} ds.
    7272     *
    7373     * @param ds the data set

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/RelationDialogManager.java

    r3479 r5266  
    2424
    2525    /**
    26      * Replies the singleton {@see RelationDialogManager}
    27      *
    28      * @return the singleton {@see RelationDialogManager}
     26     * Replies the singleton {@link RelationDialogManager}
     27     *
     28     * @return the singleton {@link RelationDialogManager}
    2929     */
    3030    static public RelationDialogManager getRelationDialogManager() {
    … …  
    3838    /**
    3939     * Helper class for keeping the context of a relation editor. A relation editor
    40      * is open for a specific relation managed by a specific {@see OsmDataLayer}
     40     * is open for a specific relation managed by a specific {@link OsmDataLayer}
    4141     *
    4242     */
    … …  
    102102    /**
    103103     * Register the relation editor for a relation managed by a
    104      * {@see OsmDataLayer}.
     104     * {@link OsmDataLayer}.
    105105     *
    106106     * @param layer the layer
    … …  
    224224
    225225    /**
    226      * Replies true, if there is another open {@see RelationEditor} whose
     226     * Replies true, if there is another open {@link RelationEditor} whose
    227227     * upper left corner is close to <code>p</code>.
    228228     *
    229229     * @param p  the reference point to check
    230      * @return true, if there is another open {@see RelationEditor} whose
     230     * @return true, if there is another open {@link RelationEditor} whose
    231231     * upper left corner is close to <code>p</code>.
    232232     */
    … …  
    245245
    246246    /**
    247      * Positions a {@see RelationEditor} on the screen. Tries to center it on the
     247     * Positions a {@link RelationEditor} on the screen. Tries to center it on the
    248248     * screen. If it hide another instance of an editor at the same position this
    249249     * method tries to reposition <code>editor</code> by moving it slightly down and

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/RelationEditor.java

    r3351 r5266  
    3535    /**
    3636     * Registers a relation editor class. Depending on the type of relation to be edited
    37      * {@see #getEditor(OsmDataLayer, Relation, Collection)} will create an instance of
     37     * {@link #getEditor(OsmDataLayer, Relation, Collection)} will create an instance of
    3838     * this class.
    3939     *
    … …  
    108108     * Creates a new relation editor
    109109     *
    110      * @param layer  the {@see OsmDataLayer} in whose context a relation is edited. Must not be null.
     110     * @param layer  the {@link OsmDataLayer} in whose context a relation is edited. Must not be null.
    111111     * @param relation the relation. Can be null if a new relation is to be edited.
    112112     * @param selectedMembers  a collection of members in <code>relation</code> which the editor
    … …  
    150150    /**
    151151     * Sets the currently edited relation. Creates a snapshot of the current
    152      * state of the relation. See {@see #getRelationSnapshot()}
     152     * state of the relation. See {@link #getRelationSnapshot()}
    153153     *
    154154     * @param relation the relation
    … …  
    165165
    166166    /**
    167      * Replies the {@see OsmDataLayer} in whose context this relation editor is
     167     * Replies the {@link OsmDataLayer} in whose context this relation editor is
    168168     * open
    169169     *
    170      * @return the {@see OsmDataLayer} in whose context this relation editor is
     170     * @return the {@link OsmDataLayer} in whose context this relation editor is
    171171     * open
    172172     */

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/RelationTree.java

    r4310 r5266  
    2929
    3030/**
    31  * This is a {@see JTree} rendering the hierarchical structure of {@see Relation}s.
     31 * This is a {@link JTree} rendering the hierarchical structure of {@link Relation}s.
    3232 *
    3333 * @see RelationTreeModel

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/RelationTreeCellRenderer.java

    r4591 r5266  
    1515
    1616/**
    17  * This is the cell renderer used in {@see RelationTree}.
     17 * This is the cell renderer used in {@link RelationTree}.
    1818 *
    1919 *

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/RelationTreeModel.java

    r4191 r5266  
    1414
    1515/**
    16  * This is a {@see TreeModel} which provides the hierarchical structure of {@see Relation}s
    17  * to a  {@see JTree}.
     16 * This is a {@link TreeModel} which provides the hierarchical structure of {@link Relation}s
     17 * to a  {@link JTree}.
    1818 *
    19  * The model is initialized with a root relation or with a list of {@see RelationMember}s, see
    20  * {@see #populate(Relation)} and {@see #populate(List)} respectively.
     19 * The model is initialized with a root relation or with a list of {@link RelationMember}s, see
     20 * {@link #populate(Relation)} and {@link #populate(List)} respectively.
    2121 *
    2222 *

  • trunk/src/org/openstreetmap/josm/gui/dialogs/relation/SelectionTableCellRenderer.java

    r4072 r5266  
    1515
    1616/**
    17  * This is the {@see TableCellRenderer} used in {@see SelectionTable}.
     17 * This is the {@link TableCellRenderer} used in {@link SelectionTable}.
    1818 *
    1919 */

  • trunk/src/org/openstreetmap/josm/gui/help/HelpContentReader.java

    r3569 r5266  
    8282     * in the internal help browser.
    8383     *
    84      * Throws a {@see MissingHelpContentException} if the content read from the stream
     84     * Throws a {@link MissingHelpContentException} if the content read from the stream
    8585     * most likely represents a stub help page.
    8686     *

  • trunk/src/org/openstreetmap/josm/gui/help/HelpUtil.java

    r3083 r5266  
    121121     * </ul>
    122122     *
    123      * @param locale the locale. {@see Locale#ENGLISH} assumed, if null.
     123     * @param locale the locale. {@link Locale#ENGLISH} assumed, if null.
    124124     * @return the help topic prefix
    125125     * @see #getHelpTopicPrefix(Locale)
    … …  
    142142     *
    143143     * @param topic the relative help topic. Home help topic assumed, if null.
    144      * @param locale the locale. {@see Locale#ENGLISH} assumed, if null.
     144     * @param locale the locale. {@link Locale#ENGLISH} assumed, if null.
    145145     * @return the absolute, localized help topic
    146146     */
    … …  
    207207    /**
    208208     * Replies the global help action, if available. Otherwise, creates an instance
    209      * of {@see HelpAction}.
     209     * of {@link HelpAction}.
    210210     *
    211211     * @return

  • trunk/src/org/openstreetmap/josm/gui/history/AdjustmentSynchronizer.java

    r3083 r5266  
    2020/**
    2121 * Synchronizes scrollbar adjustments between a set of
    22  * {@see Adjustable}s. Whenever the adjustment of one of
     22 * {@link Adjustable}s. Whenever the adjustment of one of
    2323 * the registerd Adjustables is updated the adjustment of
    2424 * the other registered Adjustables is adjusted too.
    … …  
    3939
    4040    /**
    41      * registers an {@see Adjustable} for participation in synchronized
     41     * registers an {@link Adjustable} for participation in synchronized
    4242     * scrolling.
    4343     *
    … …  
    5555
    5656    /**
    57      * event handler for {@see AdjustmentEvent}s
     57     * event handler for {@link AdjustmentEvent}s
    5858     *
    5959     */
    … …  
    9898
    9999    /**
    100      * wires a {@see JCheckBox} to  the adjustment synchronizer, in such a way  that:
     100     * wires a {@link JCheckBox} to  the adjustment synchronizer, in such a way  that:
    101101     * <li>
    102102     *   <ol>state changes in the checkbox control whether the adjustable participates
    103103     *      in synchronized adjustment</ol>
    104      *   <ol>state changes in this {@see AdjustmentSynchronizer} are reflected in the
    105      *      {@see JCheckBox}</ol>
     104     *   <ol>state changes in this {@link AdjustmentSynchronizer} are reflected in the
     105     *      {@link JCheckBox}</ol>
    106106     * </li>
    107107     *

  • trunk/src/org/openstreetmap/josm/gui/history/CoordinateInfoViewer.java

    r4990 r5266  
    2222/**
    2323 * An UI widget for displaying differences in the coordinates of two
    24  * {@see HistoryNode}s.
     24 * {@link HistoryNode}s.
    2525 *
    2626 */
    … …  
    163163    /**
    164164     * A UI widgets which displays the Lan/Lon-coordinates of a
    165      * {@see HistoryNode}.
     165     * {@link HistoryNode}.
    166166     *
    167167     */

  • trunk/src/org/openstreetmap/josm/gui/history/DiffTableModel.java

    r4689 r5266  
    1010 * Simple model storing "diff cells" in a list. Could probably have used a DefaultTableModel instead..
    1111 *
    12  * {@see NodeListDiffTableCellRenderer}
     12 * {@link NodeListDiffTableCellRenderer}
    1313 */
    1414class DiffTableModel extends AbstractTableModel {

  • trunk/src/org/openstreetmap/josm/gui/history/HistoryBrowser.java

    r4601 r5266  
    1717
    1818/**
    19  * HistoryBrowser is an UI component which displays history information about an {@see OsmPrimitive}.
     19 * HistoryBrowser is an UI component which displays history information about an {@link OsmPrimitive}.
    2020 *
    2121 *
    … …  
    3333
    3434    /**
    35      * embedds table in a {@see JScrollPane}
     35     * embedds table in a {@link JScrollPane}
    3636     *
    3737     * @param table the table
    38      * @return the {@see JScrollPane} with the embedded table
     38     * @return the {@link JScrollPane} with the embedded table
    3939     */
    4040    protected JScrollPane embeddInScrollPane(JTable table) {
    … …  
    6161    /**
    6262     * creates the panel which shows information about two different versions
    63      * of the same {@see OsmPrimitive}.
     63     * of the same {@link OsmPrimitive}.
    6464     *
    6565     * @return the panel
    … …  
    113113    /**
    114114     * constructor
    115      * @param history  the history of an {@see OsmPrimitive}
     115     * @param history  the history of an {@link OsmPrimitive}
    116116     */
    117117    public HistoryBrowser(History history) {
    … …  
    121121
    122122    /**
    123      * populates the browser with the history of a specific {@see OsmPrimitive}
     123     * populates the browser with the history of a specific {@link OsmPrimitive}
    124124     *
    125125     * @param history the history
    … …  
    147147
    148148    /**
    149      * replies the {@see History} currently displayed by this browser
     149     * replies the {@link History} currently displayed by this browser
    150150     *
    151151     * @return the current history

  • trunk/src/org/openstreetmap/josm/gui/history/HistoryBrowserDialog.java

    r5171 r5266  
    3232/**
    3333 * This is non-modal dialog, always showing on top, which displays history information
    34  * about a given {@see OsmPrimitive}.
     34 * about a given {@link OsmPrimitive}.
    3535 *
    3636 */

  • trunk/src/org/openstreetmap/josm/gui/history/HistoryBrowserModel.java

    r5146 r5266  
    4949 * The model state consists of the following elements:
    5050 * <ul>
    51  *   <li>the {@see History} of a specific {@see OsmPrimitive}</li>
    52  *   <li>a dedicated version in this {@see History} called the {@see PointInTimeType#REFERENCE_POINT_IN_TIME}</li>
    53  *   <li>another version in this {@see History} called the {@see PointInTimeType#CURRENT_POINT_IN_TIME}</li>
     51 *   <li>the {@link History} of a specific {@link OsmPrimitive}</li>
     52 *   <li>a dedicated version in this {@link History} called the {@link PointInTimeType#REFERENCE_POINT_IN_TIME}</li>
     53 *   <li>another version in this {@link History} called the {@link PointInTimeType#CURRENT_POINT_IN_TIME}</li>
    5454 * <ul>
    55  * {@see HistoryBrowser} always compares the {@see PointInTimeType#REFERENCE_POINT_IN_TIME} with the
    56  * {@see PointInTimeType#CURRENT_POINT_IN_TIME}.
    57 
    58  * This model provides various {@see TableModel}s for {@see JTable}s used in {@see HistoryBrowser}, for
     55 * {@link HistoryBrowser} always compares the {@link PointInTimeType#REFERENCE_POINT_IN_TIME} with the
     56 * {@link PointInTimeType#CURRENT_POINT_IN_TIME}.
     57
     58 * This model provides various {@link TableModel}s for {@link JTable}s used in {@link HistoryBrowser}, for
    5959 * instance:
    6060 * <ul>
    61  *  <li>{@see #getTagTableModel(PointInTimeType)} replies a {@see TableModel} for the tags of either of
     61 *  <li>{@link #getTagTableModel(PointInTimeType)} replies a {@link TableModel} for the tags of either of
    6262 *   the two selected versions</li>
    63  *  <li>{@see #getNodeListTableModel(PointInTimeType)} replies a {@see TableModel} for the list of nodes of
    64  *   the two selected versions (if the current history provides information about a {@see Way}</li>
    65  *  <li> {@see #getRelationMemberTableModel(PointInTimeType)} replies a {@see TableModel} for the list of relation
    66  *  members  of the two selected versions (if the current history provides information about a {@see Relation}</li>
     63 *  <li>{@link #getNodeListTableModel(PointInTimeType)} replies a {@link TableModel} for the list of nodes of
     64 *   the two selected versions (if the current history provides information about a {@link Way}</li>
     65 *  <li> {@link #getRelationMemberTableModel(PointInTimeType)} replies a {@link TableModel} for the list of relation
     66 *  members  of the two selected versions (if the current history provides information about a {@link Relation}</li>
    6767 *  </ul>
    6868 *
    … …  
    7676    /**
    7777     * latest isn't a reference of history. It's a clone of the currently edited
    78      * {@see OsmPrimitive} in the current edit layer.
     78     * {@link OsmPrimitive} in the current edit layer.
    7979     */
    8080    private HistoryOsmPrimitive latest;
    … …  
    120120    /**
    121121     * Replies the current edit layer; null, if there isn't a current edit layer
    122      * of type {@see OsmDataLayer}.
     122     * of type {@link OsmDataLayer}.
    123123     *
    124124     * @return the current edit layer
    … …  
    206206
    207207    /**
    208      * Replies the table model to be used in a {@see JTable} which
     208     * Replies the table model to be used in a {@link JTable} which
    209209     * shows the list of versions in this history.
    210210     *
    … …  
    284284
    285285    /**
    286      * Sets the {@see HistoryOsmPrimitive} which plays the role of a reference point
    287      * in time (see {@see PointInTimeType}).
     286     * Sets the {@link HistoryOsmPrimitive} which plays the role of a reference point
     287     * in time (see {@link PointInTimeType}).
    288288     *
    289289     * @param reference the reference history primitive. Must not be null.
    … …  
    314314
    315315    /**
    316      * Sets the {@see HistoryOsmPrimitive} which plays the role of the current point
    317      * in time (see {@see PointInTimeType}).
     316     * Sets the {@link HistoryOsmPrimitive} which plays the role of the current point
     317     * in time (see {@link PointInTimeType}).
    318318     *
    319319     * @param reference the reference history primitive. Must not be null.
    … …  
    343343
    344344    /**
    345      * Replies the history OSM primitive for the {@see PointInTimeType#CURRENT_POINT_IN_TIME}
    346      *
    347      * @return the history OSM primitive for the {@see PointInTimeType#CURRENT_POINT_IN_TIME} (may be null)
     345     * Replies the history OSM primitive for the {@link PointInTimeType#CURRENT_POINT_IN_TIME}
     346     *
     347     * @return the history OSM primitive for the {@link PointInTimeType#CURRENT_POINT_IN_TIME} (may be null)
    348348     */
    349349    public HistoryOsmPrimitive getCurrentPointInTime() {
    … …  
    352352
    353353    /**
    354      * Replies the history OSM primitive for the {@see PointInTimeType#REFERENCE_POINT_IN_TIME}
    355      *
    356      * @return the history OSM primitive for the {@see PointInTimeType#REFERENCE_POINT_IN_TIME} (may be null)
     354     * Replies the history OSM primitive for the {@link PointInTimeType#REFERENCE_POINT_IN_TIME}
     355     *
     356     * @return the history OSM primitive for the {@link PointInTimeType#REFERENCE_POINT_IN_TIME} (may be null)
    357357     */
    358358    public HistoryOsmPrimitive getReferencePointInTime() {
    … …  
    538538
    539539    /**
    540      * The table model for the tags of the version at {@see PointInTimeType#REFERENCE_POINT_IN_TIME}
    541      * or {@see PointInTimeType#CURRENT_POINT_IN_TIME}
     540     * The table model for the tags of the version at {@link PointInTimeType#REFERENCE_POINT_IN_TIME}
     541     * or {@link PointInTimeType#CURRENT_POINT_IN_TIME}
    542542     *
    543543     */
    … …  
    638638
    639639    /**
    640      * The table model for the relation members of the version at {@see PointInTimeType#REFERENCE_POINT_IN_TIME}
    641      * or {@see PointInTimeType#CURRENT_POINT_IN_TIME}
     640     * The table model for the relation members of the version at {@link PointInTimeType#REFERENCE_POINT_IN_TIME}
     641     * or {@link PointInTimeType#CURRENT_POINT_IN_TIME}
    642642     *
    643643     */
    … …  
    865865
    866866    /**
    867      * Creates a {@see HistoryOsmPrimitive} from a {@see OsmPrimitive}
     867     * Creates a {@link HistoryOsmPrimitive} from a {@link OsmPrimitive}
    868868     *
    869869     */

  • trunk/src/org/openstreetmap/josm/gui/history/HistoryLoadTask.java

    r5171 r5266  
    6060     * Creates a new task
    6161     *
    62      * @param parent the component to be used as reference to find the parent for {@see PleaseWaitDialog}.
     62     * @param parent the component to be used as reference to find the parent for {@link PleaseWaitDialog}.
    6363     * Must not be null.
    6464     * @throws IllegalArgumentException thrown if parent is null

  • trunk/src/org/openstreetmap/josm/gui/history/NodeListTableColumnModel.java

    r4498 r5266  
    99
    1010/**
    11  * The {@see TableColumnModel} for the table with the list of nodes.
     11 * The {@link TableColumnModel} for the table with the list of nodes.
    1212 *
    1313 *

  • trunk/src/org/openstreetmap/josm/gui/history/NodeListViewer.java

    r4498 r5266  
    3333/**
    3434 * NodeListViewer is a UI component which displays the node list of two
    35  * version of a {@see OsmPrimitive} in a {@see History}.
     35 * version of a {@link OsmPrimitive} in a {@link History}.
    3636 *
    3737 * <ul>
    38  *   <li>on the left, it displays the node list for the version at {@see PointInTimeType#REFERENCE_POINT_IN_TIME}</li>
    39  *   <li>on the right, it displays the node list for the version at {@see PointInTimeType#CURRENT_POINT_IN_TIME}</li>
     38 *   <li>on the left, it displays the node list for the version at {@link PointInTimeType#REFERENCE_POINT_IN_TIME}</li>
     39 *   <li>on the right, it displays the node list for the version at {@link PointInTimeType#CURRENT_POINT_IN_TIME}</li>
    4040 * </ul>
    4141 *

  • trunk/src/org/openstreetmap/josm/gui/history/PointInTimeType.java

    r3083 r5266  
    33
    44/**
    5  * PointInTimeType enumerates two points in time in the {@see History} of an {@see OsmPrimitive}.
     5 * PointInTimeType enumerates two points in time in the {@link History} of an {@link OsmPrimitive}.
    66 * @author karl
    77 *

  • trunk/src/org/openstreetmap/josm/gui/history/RelationMemberListTableCellRenderer.java

    r4734 r5266  
    1818
    1919/**
    20  * The {@see TableCellRenderer} for a list of relation members in {@see HistoryBrower}
     20 * The {@link TableCellRenderer} for a list of relation members in {@link HistoryBrower}
    2121 *
    2222 *

  • trunk/src/org/openstreetmap/josm/gui/history/RelationMemberListViewer.java

    r3083 r5266  
    1212/**
    1313 * RelationMemberListViewer is a UI component which displays the  list of relation members of two
    14  * version of a {@see Relation} in a {@see History}.
     14 * version of a {@link Relation} in a {@link History}.
    1515 *
    1616 * <ul>
    17  *   <li>on the left, it displays the list of relation members for the version at {@see PointInTimeType#REFERENCE_POINT_IN_TIME}</li>
    18  *   <li>on the right, it displays the list of relation members for the version at {@see PointInTimeType#CURRENT_POINT_IN_TIME}</li>
     17 *   <li>on the left, it displays the list of relation members for the version at {@link PointInTimeType#REFERENCE_POINT_IN_TIME}</li>
     18 *   <li>on the right, it displays the list of relation members for the version at {@link PointInTimeType#CURRENT_POINT_IN_TIME}</li>
    1919 * </ul>
    2020 *

  • trunk/src/org/openstreetmap/josm/gui/history/RelationMemberTableColumnModel.java

    r3995 r5266  
    88
    99/**
    10  * The {@see TableColumnModel} for the table with the list of relation members.
     10 * The {@link TableColumnModel} for the table with the list of relation members.
    1111 *
    1212 */

  • trunk/src/org/openstreetmap/josm/gui/history/TagInfoViewer.java

    r3083 r5266  
    1313/**
    1414 * TagInfoViewer is a UI component which displays the list of tags of two
    15  * version of a {@see OsmPrimitive} in a {@see History}.
     15 * version of a {@link OsmPrimitive} in a {@link History}.
    1616 *
    1717 * <ul>
    18  *   <li>on the left, it displays the list of tags for the version at {@see PointInTimeType#REFERENCE_POINT_IN_TIME}</li>
    19  *   <li>on the right, it displays the list of tags for the version at {@see PointInTimeType#CURRENT_POINT_IN_TIME}</li>
     18 *   <li>on the left, it displays the list of tags for the version at {@link PointInTimeType#REFERENCE_POINT_IN_TIME}</li>
     19 *   <li>on the right, it displays the list of tags for the version at {@link PointInTimeType#CURRENT_POINT_IN_TIME}</li>
    2020 * </ul>
    2121 *

  • trunk/src/org/openstreetmap/josm/gui/history/TagTableCellRenderer.java

    r4191 r5266  
    1414
    1515/**
    16  * The {@see TableCellRenderer} for a list of tagsin {@see HistoryBrower}
     16 * The {@link TableCellRenderer} for a list of tagsin {@link HistoryBrower}
    1717 *
    1818 */

  • trunk/src/org/openstreetmap/josm/gui/history/TagTableColumnModel.java

    r3083 r5266  
    88
    99/**
    10  * The {@see TableColumnModel} for the table with the list of tags
     10 * The {@link TableColumnModel} for the table with the list of tags
    1111 *
    1212 */

  • trunk/src/org/openstreetmap/josm/gui/history/VersionInfoPanel.java

    r5053 r5266  
    3030/**
    3131 * VersionInfoPanel is an UI component which displays the basic properties of a version
    32  * of a {@see OsmPrimitive}.
     32 * of a {@link OsmPrimitive}.
    3333 *
    3434 */

  • trunk/src/org/openstreetmap/josm/gui/history/VersionTableColumnModel.java

    r4779 r5266  
    1010
    1111/**
    12  * The {@see TableColumnModel} for the table with the list of versions
     12 * The {@link TableColumnModel} for the table with the list of versions
    1313 *
    1414 */

  • trunk/src/org/openstreetmap/josm/gui/io/AbstractUploadTask.java

    r4816 r5266  
    5151
    5252    /**
    53      * Synchronizes the local state of an {@see OsmPrimitive} with its state on the
     53     * Synchronizes the local state of an {@link OsmPrimitive} with its state on the
    5454     * server. The method uses an individual GET for the primitive.
    5555     *
    … …  
    7171     * Synchronizes the local state of the dataset with the state on the server.
    7272     *
    73      * Reuses the functionality of {@see UpdateDataAction}.
     73     * Reuses the functionality of {@link UpdateDataAction}.
    7474     *
    7575     * @see UpdateDataAction#actionPerformed(ActionEvent)
    … …  
    8181
    8282    /**
    83      * Handles the case that a conflict in a specific {@see OsmPrimitive} was detected while
     83     * Handles the case that a conflict in a specific {@link OsmPrimitive} was detected while
    8484     * uploading
    8585     *
    … …  
    147147    /**
    148148     * Handles the case that a conflict was detected while uploading where we don't
    149      * know what {@see OsmPrimitive} actually caused the conflict (for whatever reason)
     149     * know what {@link OsmPrimitive} actually caused the conflict (for whatever reason)
    150150     *
    151151     */
    … …  
    189189    /**
    190190     * Handles the case that a conflict was detected while uploading where we don't
    191      * know what {@see OsmPrimitive} actually caused the conflict (for whatever reason)
     191     * know what {@link OsmPrimitive} actually caused the conflict (for whatever reason)
    192192     *
    193193     */
    … …  
    286286    /**
    287287     * Handles an error which is caused by a delete request for an already deleted
    288      * {@see OsmPrimitive} on the server, i.e. a HTTP response code of 410.
     288     * {@link OsmPrimitive} on the server, i.e. a HTTP response code of 410.
    289289     * Note that an <strong>update</strong> on an already deleted object results
    290290     * in a 409, not a 410.

  • trunk/src/org/openstreetmap/josm/gui/io/ChangesetCellRenderer.java

    r3083 r5266  
    1717
    1818/**
    19  * A {@see ListCellRenderer} for the list of changesets in the upload dialog.
     19 * A {@link ListCellRenderer} for the list of changesets in the upload dialog.
    2020 *
    2121 *

  • trunk/src/org/openstreetmap/josm/gui/io/ChangesetCommentModel.java

    r4414 r5266  
    66/**
    77 * ChangesetCommentModel is an observable model for the changeset comment edited
    8  * in the {@see UploadDialog}.
     8 * in the {@link UploadDialog}.
    99 *
    1010 */

  • trunk/src/org/openstreetmap/josm/gui/io/ChangesetManagementPanel.java

    r3998 r5266  
    3535 * upload.
    3636 *
    37  * It is displayed as one of the configuration panels in the {@see UploadDialog}.
     37 * It is displayed as one of the configuration panels in the {@link UploadDialog}.
    3838 *
    39  * ChangesetManagementPanel is a source for {@see PropertyChangeEvent}s. Clients can listen
     39 * ChangesetManagementPanel is a source for {@link PropertyChangeEvent}s. Clients can listen
    4040 * to
    4141 * <ul>
    42  *   <li>{@see #SELECTED_CHANGESET_PROP}  - the new value in the property change event is
     42 *   <li>{@link #SELECTED_CHANGESET_PROP}  - the new value in the property change event is
    4343 *   the changeset selected by the user. The value is null if the user didn't select a
    4444 *   a changeset or if he chosed to use a new changeset.</li>
    45  *   <li> {@see #CLOSE_CHANGESET_AFTER_UPLOAD} - the new value is a boolean value indicating
     45 *   <li> {@link #CLOSE_CHANGESET_AFTER_UPLOAD} - the new value is a boolean value indicating
    4646 *   whether the changeset should be closed after the next upload</li>
    4747 * </ul>

  • trunk/src/org/openstreetmap/josm/gui/io/DownloadFileTask.java

    r5114 r5266  
    4343     * Creates the download task
    4444     *
    45      * @param parent the parent component relative to which the {@see PleaseWaitDialog} is displayed
    46      * @param title the title to display in the {@see PleaseWaitDialog}
     45     * @param parent the parent component relative to which the {@link PleaseWaitDialog} is displayed
     46     * @param title the title to display in the {@link PleaseWaitDialog}
    4747     * @throws IllegalArgumentException thrown if toUpdate is null
    4848     */

  • trunk/src/org/openstreetmap/josm/gui/io/FilenameCellEditor.java

    r3083 r5266  
    2626
    2727/**
    28  * This is a {@see TableCellEditor} for filenames. It provides a text input field and
    29  * a button for launchinig a {@see JFileChooser}.
     28 * This is a {@link TableCellEditor} for filenames. It provides a text input field and
     29 * a button for launchinig a {@link JFileChooser}.
    3030 *
    3131 *

  • trunk/src/org/openstreetmap/josm/gui/io/OpenChangesetComboBoxModel.java

    r3083 r5266  
    1414/**
    1515 * A combobox model for the list of open changesets. The model is populated with the list
    16  * of open changesets kept in the {@see ChangesetCache}.
     16 * of open changesets kept in the {@link ChangesetCache}.
    1717 *
    1818 */
    … …  
    3434    /**
    3535     * Refreshes the content of the combobox model with the current list of open
    36      * changesets from the {@see ChangesetCache}.
     36     * changesets from the {@link ChangesetCache}.
    3737     */
    3838    public void refresh() {

  • trunk/src/org/openstreetmap/josm/gui/io/SaveLayerInfo.java

    r5233 r5266  
    100100
    101101    /**
    102      * Replies the file this layer should be saved to, if {@see #isDoSaveToFile()} is true
     102     * Replies the file this layer should be saved to, if {@link #isDoSaveToFile()} is true
    103103     *
    104      * @return the file this layer should be saved to, if {@see #isDoSaveToFile()} is true
     104     * @return the file this layer should be saved to, if {@link #isDoSaveToFile()} is true
    105105     */
    106106    public File getFile() {
    … …  
    109109
    110110    /**
    111      * Sets the file this layer should be saved to, if {@see #isDoSaveToFile()} is true
     111     * Sets the file this layer should be saved to, if {@link #isDoSaveToFile()} is true
    112112     *
    113113     * @param file the file
    … …  
    140140
    141141    /**
    142      * Replies the upload state of {@see #getLayer()}.
     142     * Replies the upload state of {@link #getLayer()}.
    143143     * <ul>
    144      *   <li>{@see UploadOrSaveState#OK} if {@see #getLayer() was successfully uploaded</li>
    145      *   <li>{@see UploadOrSaveState#canceled} if uploading {@see #getLayer() was canceled</li>
    146      *   <li>{@see UploadOrSaveState#FAILED} if uploading {@see #getLayer() has failed</li>
     144     *   <li>{@link UploadOrSaveState#OK} if {@link #getLayer() was successfully uploaded</li>
     145     *   <li>{@link UploadOrSaveState#canceled} if uploading {@link #getLayer() was canceled</li>
     146     *   <li>{@link UploadOrSaveState#FAILED} if uploading {@link #getLayer() has failed</li>
    147147     * </ul>
    148148     *
    … …  
    154154
    155155    /**
    156      * Sets the upload state for {@see #getLayer()}
     156     * Sets the upload state for {@link #getLayer()}
    157157     *
    158158     * @param uploadState the upload state
    … …  
    163163
    164164    /**
    165      * Replies the save state of {@see #getLayer()}.
     165     * Replies the save state of {@link #getLayer()}.
    166166     * <ul>
    167      *   <li>{@see UploadOrSaveState#OK} if {@see #getLayer() was successfully saved to file</li>
    168      *   <li>{@see UploadOrSaveState#canceled} if saving {@see #getLayer() was canceled</li>
    169      *   <li>{@see UploadOrSaveState#FAILED} if saving {@see #getLayer() has failed</li>
     167     *   <li>{@link UploadOrSaveState#OK} if {@link #getLayer() was successfully saved to file</li>
     168     *   <li>{@link UploadOrSaveState#canceled} if saving {@link #getLayer() was canceled</li>
     169     *   <li>{@link UploadOrSaveState#FAILED} if saving {@link #getLayer() has failed</li>
    170170     * </ul>
    171171     *
    … …  
    177177
    178178    /**
    179      * Sets the save state for {@see #getLayer()}
     179     * Sets the save state for {@link #getLayer()}
    180180     *
    181181     * @param saveState save the upload state

  • trunk/src/org/openstreetmap/josm/gui/io/SaveLayerTask.java

    r5014 r5266  
    1010
    1111/**
    12  * SaveLayerTask saves the data managed by an {@see OsmDataLayer} to the
    13  * {@see OsmDataLayer#getAssociatedFile()}.
     12 * SaveLayerTask saves the data managed by an {@link OsmDataLayer} to the
     13 * {@link OsmDataLayer#getAssociatedFile()}.
    1414 *
    1515 * <pre>
    … …  
    3232     *
    3333     * @param layerInfo information about the layer to be saved to save. Must not be null.
    34      * @param monitor the monitor. Set to {@see NullProgressMonitor#INSTANCE} if null
     34     * @param monitor the monitor. Set to {@link NullProgressMonitor#INSTANCE} if null
    3535     * @throws IllegalArgumentException thrown if layer is null
    3636     */

  • trunk/src/org/openstreetmap/josm/gui/io/UploadDialog.java

    r5200 r5266  
    308308
    309309    /**
    310      * Replies the {@see UploadStrategySpecification} the user entered in the dialog.
    311      *
    312      * @return the {@see UploadStrategySpecification} the user entered in the dialog.
     310     * Replies the {@link UploadStrategySpecification} the user entered in the dialog.
     311     *
     312     * @return the {@link UploadStrategySpecification} the user entered in the dialog.
    313313     */
    314314    public UploadStrategySpecification getUploadStrategySpecification() {

  • trunk/src/org/openstreetmap/josm/gui/io/UploadLayerTask.java

    r4534 r5266  
    2424
    2525/**
    26  * UploadLayerTask uploads the data managed by an {@see OsmDataLayer} asynchronously.
     26 * UploadLayerTask uploads the data managed by an {@link OsmDataLayer} asynchronously.
    2727 *
    2828 * <pre>
    … …  
    5252     * @param strategy the upload strategy specification
    5353     * @param layer the layer. Must not be null.
    54      * @param monitor  a progress monitor. If monitor is null, uses {@see NullProgressMonitor#INSTANCE}
     54     * @param monitor  a progress monitor. If monitor is null, uses {@link NullProgressMonitor#INSTANCE}
    5555     * @param changeset the changeset to be used
    5656     * @throws IllegalArgumentException thrown, if layer is null

  • trunk/src/org/openstreetmap/josm/gui/io/UploadStrategy.java

    r3344 r5266  
    5858     * present, checks for the legacy preference key <pre>osm-server.atomic-upload</pre>.
    5959     *
    60      * If both are missing or if the preference value is illegal, {@see #DEFAULT_UPLOAD_STRATEGY}
     60     * If both are missing or if the preference value is illegal, {@link #DEFAULT_UPLOAD_STRATEGY}
    6161     * is replied.
    6262     *

  • trunk/src/org/openstreetmap/josm/gui/io/UploadStrategySelectionPanel.java

    r4309 r5266  
    3939 *
    4040 * Clients can listen for property change events for the property
    41  * {@see #UPLOAD_STRATEGY_SPECIFICATION_PROP}.
     41 * {@link #UPLOAD_STRATEGY_SPECIFICATION_PROP}.
    4242 */
    4343public class UploadStrategySelectionPanel extends JPanel implements PropertyChangeListener {

  • trunk/src/org/openstreetmap/josm/gui/io/UploadStrategySpecification.java

    r3083 r5266  
    44/**
    55 * An UploadStrategySpecification consists of the parameter describing the strategy
    6  * for uploading a collection of {@see OsmPrimitive}.
     6 * for uploading a collection of {@link OsmPrimitive}.
    77 *
    88 * This includes:
    99 * <ul>
    10  * <li>a decision on which {@see UploadStrategy} to use</li>
     10 * <li>a decision on which {@link UploadStrategy} to use</li>
    1111 * <li>the upload chunk size</li>
    1212 * <li>whether to close the changeset used after the upload</li>

  • trunk/src/org/openstreetmap/josm/gui/io/UploadedObjectsSummaryPanel.java

    r3083 r5266  
    2121/**
    2222 * This panel displays a summary of the objects to upload. It is displayed in
    23  * the upper part of the {@see UploadDialog}.
     23 * the upper part of the {@link UploadDialog}.
    2424 *
    2525 */

  • trunk/src/org/openstreetmap/josm/gui/layer/Layer.java

    r5048 r5266  
    239239    /**
    240240     * Sets the visibility of this layer. Emits property change event for
    241      * property {@see #VISIBLE_PROP}.
     241     * property {@link #VISIBLE_PROP}.
    242242     *
    243243     * @param visible true, if the layer is visible; false, otherwise.
    … …  
    287287
    288288    /**
    289      * Adds a {@see PropertyChangeListener}
     289     * Adds a {@link PropertyChangeListener}
    290290     *
    291291     * @param listener the listener
    … …  
    296296
    297297    /**
    298      * Removes a {@see PropertyChangeListener}
     298     * Removes a {@link PropertyChangeListener}
    299299     *
    300300     * @param listener the listener
    … …  
    305305
    306306    /**
    307      * fires a property change for the property {@see #VISIBLE_PROP}
     307     * fires a property change for the property {@link #VISIBLE_PROP}
    308308     *
    309309     * @param oldValue the old value
    … …  
    315315
    316316    /**
    317      * fires a property change for the property {@see #OPACITY_PROP}
     317     * fires a property change for the property {@link #OPACITY_PROP}
    318318     *
    319319     * @param oldValue the old value
    … …  
    406406    public void projectionChanged(Projection oldValue, Projection newValue) {
    407407        if(!isProjectionSupported(newValue)) {
    408               JOptionPane.showMessageDialog(Main.parent,
    409                   tr("The layer {0} does not support the new projection {1}.\n{2}\n"
    410                   + "Change the projection again or remove the layer.",
    411                       getName(), newValue.toCode(), nameSupportedProjections()),
    412                       tr("Warning"),
    413                       JOptionPane.WARNING_MESSAGE);
     408            JOptionPane.showMessageDialog(Main.parent,
     409                    tr("The layer {0} does not support the new projection {1}.\n{2}\n"
     410                            + "Change the projection again or remove the layer.",
     411                            getName(), newValue.toCode(), nameSupportedProjections()),
     412                            tr("Warning"),
     413                            JOptionPane.WARNING_MESSAGE);
    414414        }
    415415    }

  • trunk/src/org/openstreetmap/josm/gui/oauth/AbstractAuthorizationUI.java

    r3530 r5266  
    5252
    5353    /**
    54      * Replies the panel for entering advanced OAuth parameters (see {@see OAuthParameters})
     54     * Replies the panel for entering advanced OAuth parameters (see {@link OAuthParameters})
    5555     *
    5656     * @return the panel for entering advanced OAuth parameters
    … …  
    8080
    8181    /**
    82      * Sets the current Access Token. This will fire a property change event for {@see #ACCESS_TOKEN_PROP}
     82     * Sets the current Access Token. This will fire a property change event for {@link #ACCESS_TOKEN_PROP}
    8383     * if the access token has changed
    8484     *

  • trunk/src/org/openstreetmap/josm/gui/oauth/OsmOAuthAuthorizationClient.java

    r4874 r5266  
    125125     * Provider and replies the request token.
    126126     *
    127      * @param monitor a progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null
     127     * @param monitor a progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null
    128128     * @return the OAuth Request Token
    129129     * @throws OsmOAuthAuthorizationException thrown if something goes wrong when retrieving the request token
    … …  
    155155     * Provider and replies the request token.
    156156     *
    157      * You must have requested a Request Token using {@see #getRequestToken(ProgressMonitor)} first.
    158      *
    159      * @param monitor a progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null
     157     * You must have requested a Request Token using {@link #getRequestToken(ProgressMonitor)} first.
     158     *
     159     * @param monitor a progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null
    160160     * @return the OAuth Access Token
    161161     * @throws OsmOAuthAuthorizationException thrown if something goes wrong when retrieving the request token
    … …  
    525525     * @param osmPassword the OSM password. Must not be null.
    526526     * @param privileges the set of privileges. Must not be null.
    527      * @param monitor a progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null
     527     * @param monitor a progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null
    528528     * @throws IllegalArgumentException thrown if requestToken is null
    529529     * @throws IllegalArgumentException thrown if osmUserName is null

  • trunk/src/org/openstreetmap/josm/gui/oauth/RetrieveAccessTokenTask.java

    r4310 r5266  
    3535     * Creates the task
    3636     *
    37      * @param parent the parent component relative to which the {@see PleaseWaitRunnable}-Dialog
     37     * @param parent the parent component relative to which the {@link PleaseWaitRunnable}-Dialog
    3838     * is displayed
    3939     * @param parameters the OAuth parameters. Must not be null.

  • trunk/src/org/openstreetmap/josm/gui/oauth/RetrieveRequestTokenTask.java

    r4310 r5266  
    3333     * Creates the task
    3434     *
    35      * @param parent the parent component relative to which the {@see PleaseWaitRunnable}-Dialog
     35     * @param parent the parent component relative to which the {@link PleaseWaitRunnable}-Dialog
    3636     * is displayed
    3737     * @param parameters the OAuth parameters. Must not be null.

  • trunk/src/org/openstreetmap/josm/gui/oauth/TestAccessTokenTask.java

    r3530 r5266  
    5151     * Create the task
    5252     *
    53      * @param parent the parent component relative to which the  {@see PleaseWaitRunnable}-Dialog is displayed
     53     * @param parent the parent component relative to which the  {@link PleaseWaitRunnable}-Dialog is displayed
    5454     * @param apiUrl the API URL. Must not be null.
    5555     * @param parameters the OAuth parameters. Must not be null.

  • trunk/src/org/openstreetmap/josm/gui/preferences/ServerAccessPreference.java

    r4968 r5266  
    4141
    4242    /**
    43      * Embeds a vertically scrollable panel in a {@see JScrollPane}
     43     * Embeds a vertically scrollable panel in a {@link JScrollPane}
    4444     * @param panel the panel
    4545     * @return the scroll pane

  • trunk/src/org/openstreetmap/josm/gui/preferences/server/ApiUrlTestTask.java

    r3530 r5266  
    2525 * This is an asynchronous task for testing whether an URL points to an OSM API server.
    2626 * It tries to retrieve a list of changesets from the given URL. If it succeeds, the method
    27  * {@see #isSuccess()} replies true, otherwise false.
     27 * {@link #isSuccess()} replies true, otherwise false.
    2828 *
    2929 * Note: it fetches a list of changesets instead of the much smaller capabilities because - strangely enough -
    … …  
    4444     * Creates the task
    4545     *
    46      * @param parent the parent component relative to which the {@see PleaseWaitRunnable}-Dialog is displayed
     46     * @param parent the parent component relative to which the {@link PleaseWaitRunnable}-Dialog is displayed
    4747     * @param url the url. Must not be null.
    4848     * @throws IllegalArgumentException thrown if url is null.

  • trunk/src/org/openstreetmap/josm/gui/preferences/server/OAuthAuthenticationPreferencesPanel.java

    r4245 r5266  
    4040 * user already has an Access Token.
    4141 *
    42  * For initial authorisation see {@see OAuthAuthorisationWizard}.
     42 * For initial authorisation see {@link OAuthAuthorisationWizard}.
    4343 *
    4444 */

  • trunk/src/org/openstreetmap/josm/gui/progress/ProgressRenderer.java

    r3083 r5266  
    33
    44/**
    5  * Swing components can implement this interface and use a {@see SwingRenderingProgressMonitor}
     5 * Swing components can implement this interface and use a {@link SwingRenderingProgressMonitor}
    66 * to render progress information.
    77 *

  • trunk/src/org/openstreetmap/josm/gui/progress/SwingRenderingProgressMonitor.java

    r4762 r5266  
    1111/**
    1212 * SwingRenderingProgressMonitor is progress monitor which delegates the rendering
    13  * of progress information to a {@see ProgressRenderer}.
     13 * of progress information to a {@link ProgressRenderer}.
    1414 * Methods of the progress renderer are always called on the Swing EDT.
    1515 *

  • trunk/src/org/openstreetmap/josm/gui/tagging/TagEditorModel.java

    r4310 r5266  
    4747     * for row selection and column selection.
    4848     *
    49      * To create a {@see JTable} with this model:
     49     * To create a {@link JTable} with this model:
    5050     * <pre>
    5151     *    TagEditorModel model = new TagEditorModel();
    … …  
    441441
    442442    /**
    443      * Replies the tags in this tag editor model as {@see TagCollection}.
    444      *
    445      * @return the tags in this tag editor model as {@see TagCollection}
     443     * Replies the tags in this tag editor model as {@link TagCollection}.
     444     *
     445     * @return the tags in this tag editor model as {@link TagCollection}
    446446     */
    447447    public TagCollection getTagCollection() {

  • trunk/src/org/openstreetmap/josm/gui/tagging/TagEditorPanel.java

    r5155 r5266  
    2323
    2424/**
    25  * TagEditorPanel is a {@see JPanel} which can be embedded as UI component in
     25 * TagEditorPanel is a {@link JPanel} which can be embedded as UI component in
    2626 * UIs. It provides a spreadsheet like tabular control for editing tag names
    2727 * and tag values. Two action buttons are placed on the left, one for adding
    … …  
    120120    /**
    121121     * Creates a new tag editor panel. The editor model is created
    122      * internally and can be retrieved with {@see #getModel()}.
     122     * internally and can be retrieved with {@link #getModel()}.
    123123     */
    124124    public TagEditorPanel(PresetHandler presetHandler) {

  • trunk/src/org/openstreetmap/josm/gui/tagging/TagTable.java

    r4310 r5266  
    540540     *
    541541     * This implementation also checks whether focus is transferred to one of a list
    542      * of dedicated components, see {@see TagTable#doNotStopCellEditingWhenFocused}.
    543      * A typical example for such a component is a button in {@see TagEditorPanel}
    544      * which isn't a child component of {@see TagTable} but which should respond to
     542     * of dedicated components, see {@link TagTable#doNotStopCellEditingWhenFocused}.
     543     * A typical example for such a component is a button in {@link TagEditorPanel}
     544     * which isn't a child component of {@link TagTable} but which should respond to
    545545     * to focus transfer in a similar way to a child of TagTable.
    546546     *

  • trunk/src/org/openstreetmap/josm/gui/tagging/ac/AutoCompletingTextField.java

    r4191 r5266  
    2525/**
    2626 * AutoCompletingTextField is an text field with autocompletion behaviour. It
    27  * can be used as table cell editor in {@see JTable}s.
     27 * can be used as table cell editor in {@link JTable}s.
    2828 *
    29  * Autocompletion is controlled by a list of {@see AutoCompletionListItem}s
    30  * managed in a {@see AutoCompletionList}.
     29 * Autocompletion is controlled by a list of {@link AutoCompletionListItem}s
     30 * managed in a {@link AutoCompletionList}.
    3131 *
    3232 *

  • trunk/src/org/openstreetmap/josm/gui/tagging/ac/AutoCompletionList.java

    r4300 r5266  
    1313
    1414/**
    15  * AutoCompletionList manages a list of {@see AutoCompletionListItem}s.
     15 * AutoCompletionList manages a list of {@link AutoCompletionListItem}s.
    1616 *
    1717 * The list is sorted, items with higher priority first, then according to lexicographic order
    18  * on the value of the {@see AutoCompletionListItem}.
    19  *
    20  * AutoCompletionList maintains two views on the list of {@see AutoCompletionListItem}s.
     18 * on the value of the {@link AutoCompletionListItem}.
     19 *
     20 * AutoCompletionList maintains two views on the list of {@link AutoCompletionListItem}s.
    2121 * <ol>
    2222 *   <li>the bare, unfiltered view which includes all items</li>
    … …  
    4949
    5050    /**
    51      * applies a filter expression to the list of {@see AutoCompletionListItem}s.
     51     * applies a filter expression to the list of {@link AutoCompletionListItem}s.
    5252     *
    5353     * The matching criterion is a case insensitive substring match.
    … …  
    247247    /**
    248248     * replies the idx-th item from the list of filtered items
    249      * @param idx the index; must be in the range 0<= idx < {@see #getFilteredSize()}
     249     * @param idx the index; must be in the range 0<= idx < {@link #getFilteredSize()}
    250250     * @return the item
    251251     *

  • trunk/src/org/openstreetmap/josm/gui/tagging/ac/AutoCompletionListItem.java

    r4868 r5266  
    1010 *  in an auto completion list for tag names, standard tag names would be assigned a higher
    1111 *  priority than arbitrary tag names present in the current data set. There are three priority levels,
    12  *  {@see AutoCompletionItemPritority}.
     12 *  {@link AutoCompletionItemPritority}.
    1313 *
    1414 * The value is a string which will be displayed in the auto completion list.

  • trunk/src/org/openstreetmap/josm/gui/tagging/ac/AutoCompletionManager.java

    r5196 r5266  
    205205
    206206    /**
    207      * Populates the an {@see AutoCompletionList} with the currently cached
     207     * Populates the an {@link AutoCompletionList} with the currently cached
    208208     * member roles.
    209209     *
    … …  
    216216
    217217    /**
    218      * Populates the an {@see AutoCompletionList} with the currently cached
     218     * Populates the an {@link AutoCompletionList} with the currently cached
    219219     * tag keys
    220220     *
    … …  
    227227
    228228    /**
    229      * Populates the an {@see AutoCompletionList} with the currently cached
     229     * Populates the an {@link AutoCompletionList} with the currently cached
    230230     * values for a tag
    231231     *
    … …  
    238238
    239239    /**
    240      * Populates the an {@see AutoCompletionList} with the currently cached
     240     * Populates the an {@link AutoCompletionList} with the currently cached
    241241     * values for some given tags
    242242     *

  • trunk/src/org/openstreetmap/josm/gui/widgets/AbstractTextComponentValidator.java

    r5226 r5266  
    2424 * This is an abstract class for a validator on a text component.
    2525 *
    26  * Subclasses implement {@see #validate()}. {@see #validate()} is invoked whenever
     26 * Subclasses implement {@link #validate()}. {@link #validate()} is invoked whenever
    2727 * <ul>
    28  *   <li>the content of the text component changes (the validator is a {@see DocumentListener})</li>
    29  *   <li>the text component loses focus (the validator is a {@see FocusListener})</li>
    30  *   <li>the text component is a {@see JTextField} and an {@see ActionEvent} is detected</li>
     28 *   <li>the content of the text component changes (the validator is a {@link DocumentListener})</li>
     29 *   <li>the text component loses focus (the validator is a {@link FocusListener})</li>
     30 *   <li>the text component is a {@link JTextField} and an {@link ActionEvent} is detected</li>
    3131 * </ul>
    3232 *

  • trunk/src/org/openstreetmap/josm/gui/widgets/HtmlPanel.java

    r3461 r5266  
    1616 * HTML.
    1717 *
    18  * It displays HTML text in the same font as {@see JLabel}. Hyperlinks are rendered in
     18 * It displays HTML text in the same font as {@link JLabel}. Hyperlinks are rendered in
    1919 * blue and they are underlined. There is also a CSS rule for the HTML tag &lt;strong&gt;
    2020 * configured.

  • trunk/src/org/openstreetmap/josm/gui/widgets/OsmIdTextField.java

    r5211 r5266  
    4747
    4848    /**
    49      * Validator for a changeset ID entered in a {@see JTextComponent}.
     49     * Validator for a changeset ID entered in a {@link JTextComponent}.
    5050     *
    5151     */

  • trunk/src/org/openstreetmap/josm/io/ChangesetClosedException.java

    r3562 r5266  
    1414/**
    1515 * A ChangesetClosedException is thrown if the server replies with a HTTP
    16  * return code 409 (Conflict) with the error header {@see #ERROR_HEADER_PATTERN}.
     16 * return code 409 (Conflict) with the error header {@link #ERROR_HEADER_PATTERN}.
    1717 *
    1818 * Depending on the context the exception is thrown in we have to react differently.
    … …  
    5050
    5151    /**
    52      * Replies true if <code>errorHeader</code> matches with {@see #ERROR_HEADER_PATTERN}
     52     * Replies true if <code>errorHeader</code> matches with {@link #ERROR_HEADER_PATTERN}
    5353     *
    5454     * @param errorHeader the error header
    55      * @return true if <code>errorHeader</code> matches with {@see #ERROR_HEADER_PATTERN}
     55     * @return true if <code>errorHeader</code> matches with {@link #ERROR_HEADER_PATTERN}
    5656     */
    5757    static public boolean errorHeaderMatchesPattern(String errorHeader) {

  • trunk/src/org/openstreetmap/josm/io/ChangesetQuery.java

    r4902 r5266  
    6767     *
    6868     * Caveat: for historical reasons the username might not be unique! It is recommended to use
    69      * {@see #forUser(int)} to restrict the query to a specific user.
     69     * {@link #forUser(int)} to restrict the query to a specific user.
    7070     *
    7171     * @param username the username. Must not be null.
    … …  
    9494    /**
    9595     * Replies the user name which this query is restricted to. null, if this query isn't
    96      * restricted to a user name, i.e. if {@see #isRestrictedToPartiallyIdentifiedUser()} is false.
     96     * restricted to a user name, i.e. if {@link #isRestrictedToPartiallyIdentifiedUser()} is false.
    9797     *
    9898     * @return the user name which this query is restricted to
    … …  
    406406        /**
    407407         * Parses the changeset query given as URL query parameters and replies a
    408          * {@see ChangesetQuery}
     408         * {@link ChangesetQuery}
    409409         *
    410410         * <code>query</code> is the query part of a API url for querying changesets,

  • trunk/src/org/openstreetmap/josm/io/DefaultProxySelector.java

    r4196 r5266  
    2424public class DefaultProxySelector extends ProxySelector {
    2525    /**
    26      * The {@see ProxySelector} provided by the JDK will retrieve proxy information
     26     * The {@link ProxySelector} provided by the JDK will retrieve proxy information
    2727     * from the system settings, if the system property <tt>java.net.useSystemProxies</tt>
    2828     * is defined <strong>at startup</strong>. It has no effect if the property is set
    … …  
    4040
    4141    /**
    42      * The {@see ProxySelector} provided by the JDK will retrieve proxy information
     42     * The {@link ProxySelector} provided by the JDK will retrieve proxy information
    4343     * from the system settings, if the system property <tt>java.net.useSystemProxies</tt>
    4444     * is defined <strong>at startup</strong>. If the property is set later by the application,

  • trunk/src/org/openstreetmap/josm/io/DiffResultProcessor.java

    r4100 r5266  
    7070     *
    7171     * @param diffUploadResponse the response. Must not be null.
    72      * @param progressMonitor a progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null
     72     * @param progressMonitor a progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null
    7373     * @throws IllegalArgumentException thrown if diffUploadRequest is null
    7474     * @throws OsmDataParsingException thrown if the diffUploadRequest can't be parsed successfully
    … …  
    105105     *
    106106     * @param cs the current changeset. Ignored if null.
    107      * @param monitor the progress monitor. Set to {@see NullProgressMonitor#INSTANCE} if null
     107     * @param monitor the progress monitor. Set to {@link NullProgressMonitor#INSTANCE} if null
    108108     * @return the collection of processed primitives
    109109     */

  • trunk/src/org/openstreetmap/josm/io/MultiFetchServerObjectReader.java

    r4217 r5266  
    2929
    3030/**
    31  * Retrieves a set of {@see OsmPrimitive}s from an OSM server using the so called
     31 * Retrieves a set of {@link OsmPrimitive}s from an OSM server using the so called
    3232 * Multi Fetch API.
    3333 *
    … …  
    7777
    7878    /**
    79      * Remembers an {@see OsmPrimitive}'s id. The id will
     79     * Remembers an {@link OsmPrimitive}'s id. The id will
    8080     * later be fetched as part of a Multi Get request.
    8181     *
    … …  
    9494
    9595    /**
    96      * remembers an {@see OsmPrimitive}'s id. <code>ds</code> must include
    97      * an {@see OsmPrimitive} with id=<code>id</code>. The id will
     96     * remembers an {@link OsmPrimitive}'s id. <code>ds</code> must include
     97     * an {@link OsmPrimitive} with id=<code>id</code>. The id will
    9898     * later we fetched as part of a Multi Get request.
    9999     *
    … …  
    103103     * @param id  the id
    104104     * @exception IllegalArgumentException thrown, if ds is null
    105      * @exception NoSuchElementException thrown, if ds doesn't include an {@see OsmPrimitive} with
     105     * @exception NoSuchElementException thrown, if ds doesn't include an {@link OsmPrimitive} with
    106106     *   id=<code>id</code>
    107107     */
    … …  
    135135
    136136    /**
    137      * appends a {@see Node}s id to the list of ids which will be fetched from the server.
     137     * appends a {@link Node}s id to the list of ids which will be fetched from the server.
    138138     *
    139139     * @param node  the node (ignored, if null)
    … …  
    148148
    149149    /**
    150      * appends a {@see Way}s id and the list of ids of nodes the way refers to the list of ids which will be fetched from the server.
     150     * appends a {@link Way}s id and the list of ids of nodes the way refers to the list of ids which will be fetched from the server.
    151151     *
    152152     * @param way the way (ignored, if null)
    … …  
    167167
    168168    /**
    169      * appends a {@see Relation}s id to the list of ids which will be fetched from the server.
     169     * appends a {@link Relation}s id to the list of ids which will be fetched from the server.
    170170     *
    171171     * @param relation  the relation (ignored, if null)
    … …  
    204204
    205205    /**
    206      * appends a list of {@see OsmPrimitive} to the list of ids which will be fetched from the server.
     206     * appends a list of {@link OsmPrimitive} to the list of ids which will be fetched from the server.
    207207     *
    208208     * @param primitives  the list of primitives (ignored, if null)
    … …  
    223223
    224224    /**
    225      * extracts a subset of max {@see #MAX_IDS_PER_REQUEST} ids from <code>ids</code> and
     225     * extracts a subset of max {@link #MAX_IDS_PER_REQUEST} ids from <code>ids</code> and
    226226     * replies the subset. The extracted subset is removed from <code>ids</code>.
    227227     *
    … …  
    248248    /**
    249249     * builds the Multi Get request string for a set of ids and a given
    250      * {@see OsmPrimitiveType}.
     250     * {@link OsmPrimitiveType}.
    251251     *
    252252     * @param type the type
    … …  
    271271    /**
    272272     * builds the Multi Get request string for a single id and a given
    273      * {@see OsmPrimitiveType}.
     273     * {@link OsmPrimitiveType}.
    274274     *
    275275     * @param type the type
    … …  
    286286
    287287    /**
    288      * invokes a Multi Get for a set of ids and a given {@see OsmPrimitiveType}.
    289      * The retrieved primitives are merged to {@see #outputDataSet}.
     288     * invokes a Multi Get for a set of ids and a given {@link OsmPrimitiveType}.
     289     * The retrieved primitives are merged to {@link #outputDataSet}.
    290290     *
    291291     * @param type the type
    … …  
    309309
    310310    /**
    311      * invokes a Multi Get for a single id and a given {@see OsmPrimitiveType}.
    312      * The retrieved primitive is merged to {@see #outputDataSet}.
     311     * invokes a Multi Get for a single id and a given {@link OsmPrimitiveType}.
     312     * The retrieved primitive is merged to {@link #outputDataSet}.
    313313     *
    314314     * @param type the type
    … …  
    333333
    334334    /**
    335      * invokes a sequence of Multi Gets for individual ids in a set of ids and a given {@see OsmPrimitiveType}.
    336      * The retrieved primitives are merged to {@see #outputDataSet}.
     335     * invokes a sequence of Multi Gets for individual ids in a set of ids and a given {@link OsmPrimitiveType}.
     336     * The retrieved primitives are merged to {@link #outputDataSet}.
    337337     *
    338338     * This method is used if one of the ids in pkg doesn't exist (the server replies with return code 404).
    … …  
    380380
    381381    /**
    382      * merges the dataset <code>from</code> to {@see #outputDataSet}.
     382     * merges the dataset <code>from</code> to {@link #outputDataSet}.
    383383     *
    384384     * @param from the other dataset
    … …  
    391391
    392392    /**
    393      * fetches a set of ids of a given {@see OsmPrimitiveType} from the server
     393     * fetches a set of ids of a given {@link OsmPrimitiveType} from the server
    394394     *
    395395     * @param ids the set of ids
    … …  
    423423
    424424    /**
    425      * invokes one or more Multi Gets to fetch the {@see OsmPrimitive}s and replies
     425     * invokes one or more Multi Gets to fetch the {@link OsmPrimitive}s and replies
    426426     * the dataset of retrieved primitives. Note that the dataset includes non visible primitives too!
    427427     * In contrast to a simple Get for a node, a way, or a relation, a Multi Get always replies
    … …  
    429429     * visible==false).
    430430     *
    431      * Invoke {@see #getMissingPrimitives()} to get a list of primitives which have not been
     431     * Invoke {@link #getMissingPrimitives()} to get a list of primitives which have not been
    432432     * found on  the server (the server response code was 404)
    433433     *

  • trunk/src/org/openstreetmap/josm/io/OsmApi.java

    r5084 r5266  
    5959
    6060    /**
    61      * replies the {@see OsmApi} for a given server URL
     61     * replies the {@link OsmApi} for a given server URL
    6262     *
    6363     * @param serverUrl  the server URL
    … …  
    7575    }
    7676    /**
    77      * replies the {@see OsmApi} for the URL given by the preference <code>osm-server.url</code>
     77     * replies the {@link OsmApi} for the URL given by the preference <code>osm-server.url</code>
    7878     *
    7979     * @return the OsmApi
    … …  
    387387     *
    388388     * @param changeset the changeset to update. Must not be null.
    389      * @param monitor the progress monitor. If null, uses the {@see NullProgressMonitor#INSTANCE}.
     389     * @param monitor the progress monitor. If null, uses the {@link NullProgressMonitor#INSTANCE}.
    390390     *
    391391     * @throws OsmTransferException if something goes wrong.
    … …  
    428428     *
    429429     * @param changeset the changeset to be closed. Must not be null. changeset.getId() > 0 required.
    430      * @param monitor the progress monitor. If null, uses {@see NullProgressMonitor#INSTANCE}
     430     * @param monitor the progress monitor. If null, uses {@link NullProgressMonitor#INSTANCE}
    431431     *
    432432     * @throws OsmTransferException if something goes wrong.

  • trunk/src/org/openstreetmap/josm/io/OsmChangeReader.java

    r4532 r5266  
    100100     *
    101101     * @param source the source input stream. Must not be null.
    102      * @param progressMonitor  the progress monitor. If null, {@see NullProgressMonitor#INSTANCE} is assumed
     102     * @param progressMonitor  the progress monitor. If null, {@link NullProgressMonitor#INSTANCE} is assumed
    103103     *
    104104     * @return the dataset with the parsed data

  • trunk/src/org/openstreetmap/josm/io/OsmChangesetContentParser.java

    r4734 r5266  
    300300     * Parses the content
    301301     *
    302      * @param progressMonitor the progress monitor. Set to {@see NullProgressMonitor#INSTANCE}
     302     * @param progressMonitor the progress monitor. Set to {@link NullProgressMonitor#INSTANCE}
    303303     * if null
    304304     * @return the parsed data

  • trunk/src/org/openstreetmap/josm/io/OsmHistoryReader.java

    r4734 r5266  
    3232 * Parser for OSM history data.
    3333 *
    34  * It is slightly different from {@see OsmReader} because we don't build an internal graph of
    35  * {@see OsmPrimitive}s. We use objects derived from {@see HistoryOsmPrimitive} instead and we
    36  * keep the data in a dedicated {@see HistoryDataSet}.
     34 * It is slightly different from {@link OsmReader} because we don't build an internal graph of
     35 * {@link OsmPrimitive}s. We use objects derived from {@link HistoryOsmPrimitive} instead and we
     36 * keep the data in a dedicated {@link HistoryDataSet}.
    3737 *
    3838 */

  • trunk/src/org/openstreetmap/josm/io/OsmReader.java

    r5025 r5266  
    606606     *
    607607     * @param source the source input stream. Must not be null.
    608      * @param progressMonitor  the progress monitor. If null, {@see NullProgressMonitor#INSTANCE} is assumed
     608     * @param progressMonitor  the progress monitor. If null, {@link NullProgressMonitor#INSTANCE} is assumed
    609609     *
    610610     * @return the dataset with the parsed data

  • trunk/src/org/openstreetmap/josm/io/OsmServerBackreferenceReader.java

    r5251 r5266  
    2121/**
    2222 * OsmServerBackreferenceReader fetches the primitives from the OSM server which
    23  * refer to a specific primitive. For a {@see Node}, ways and relations are retrieved
    24  * which refer to the node. For a {@see Way} or a {@see Relation}, only relations are
     23 * refer to a specific primitive. For a {@link Node}, ways and relations are retrieved
     24 * which refer to the node. For a {@link Way} or a {@link Relation}, only relations are
    2525 * read.
    2626 *
    … …  
    2929 * of these calls is to reply incomplete primitives only.
    3030 *
    31  * If you set {@see #setReadFull(boolean)} to true this reader uses a {@see MultiFetchServerObjectReader}
     31 * If you set {@link #setReadFull(boolean)} to true this reader uses a {@link MultiFetchServerObjectReader}
    3232 * to complete incomplete primitives.
    3333 *
    … …  
    123123
    124124    /**
    125      * Reads referring ways from the API server and replies them in a {@see DataSet}
     125     * Reads referring ways from the API server and replies them in a {@link DataSet}
    126126     *
    127127     * @return the data set
    … …  
    160160
    161161    /**
    162      * Reads referring relations from the API server and replies them in a {@see DataSet}
     162     * Reads referring relations from the API server and replies them in a {@link DataSet}
    163163     *
    164164     * @param progressMonitor the progress monitor
    … …  
    203203     *
    204204     * <ul>
    205      *   <li>if this reader reads referers for a {@see Node}, referring ways are always
     205     *   <li>if this reader reads referers for a {@link Node}, referring ways are always
    206206     *     read individually from the server</li>
    207      *   <li>if this reader reads referers for an {@see Way} or a {@see Relation}, referring relations
    208      *    are only read fully if {@see #setReadFull(boolean)} is set to true.</li>
     207     *   <li>if this reader reads referers for an {@link Way} or a {@link Relation}, referring relations
     208     *    are only read fully if {@link #setReadFull(boolean)} is set to true.</li>
    209209     * </ul>
    210210     *
    … …  
    249249    /**
    250250     * Reads the referring primitives from the OSM server, parses them and
    251      * replies them as {@see DataSet}
    252      *
    253      * @param progressMonitor the progress monitor. Set to {@see NullProgressMonitor#INSTANCE} if null.
     251     * replies them as {@link DataSet}
     252     *
     253     * @param progressMonitor the progress monitor. Set to {@link NullProgressMonitor#INSTANCE} if null.
    254254     * @return the dataset with the referring primitives
    255255     * @exception OsmTransferException thrown if an error occurs while communicating with the server

  • trunk/src/org/openstreetmap/josm/io/OsmServerChangesetReader.java

    r3083 r5266  
    2222
    2323/**
    24  * Reads the history of an {@see OsmPrimitive} from the OSM API server.
     24 * Reads the history of an {@link OsmPrimitive} from the OSM API server.
    2525 *
    2626 */
    … …  
    4747     * Queries a list
    4848     * @param query  the query specification. Must not be null.
    49      * @param monitor a progress monitor. Set to {@see NullProgressMonitor#INSTANCE} if null
     49     * @param monitor a progress monitor. Set to {@link NullProgressMonitor#INSTANCE} if null
    5050     * @return the list of changesets read from the server
    5151     * @throws IllegalArgumentException thrown if query is null
    … …  
    8080     *
    8181     * @param id  the changeset id. id > 0 required.
    82      * @param monitor the progress monitor. Set to {@see NullProgressMonitor#INSTANCE} if null
     82     * @param monitor the progress monitor. Set to {@link NullProgressMonitor#INSTANCE} if null
    8383     * @return the changeset read
    8484     * @throws OsmTransferException thrown if something goes wrong
    … …  
    116116     *
    117117     * @param ids  the list of ids. Ignored if null. Only load changesets for ids > 0.
    118      * @param monitor the progress monitor. Set to {@see NullProgressMonitor#INSTANCE} if null
     118     * @param monitor the progress monitor. Set to {@link NullProgressMonitor#INSTANCE} if null
    119119     * @return the changeset read
    120120     * @throws OsmTransferException thrown if something goes wrong
    … …  
    165165     *
    166166     * @param id the changeset id. >0 required.
    167      * @param monitor the progress monitor. {@see NullProgressMonitor#INSTANCE} assumed if null.
     167     * @param monitor the progress monitor. {@link NullProgressMonitor#INSTANCE} assumed if null.
    168168     * @return the changeset content
    169169     * @throws IllegalArgumentException thrown if id <= 0

  • trunk/src/org/openstreetmap/josm/io/OsmServerHistoryReader.java

    r3083 r5266  
    1414
    1515/**
    16  * Reads the history of an {@see OsmPrimitive} from the OSM API server.
     16 * Reads the history of an {@link OsmPrimitive} from the OSM API server.
    1717 *
    1818 */

  • trunk/src/org/openstreetmap/josm/io/OsmServerObjectReader.java

    r4734 r5266  
    106106     * Downloads and parses the data.
    107107     *
    108      * @param progressMonitor the progress monitor. Set to {@see NullProgressMonitor#INSTANCE} if
     108     * @param progressMonitor the progress monitor. Set to {@link NullProgressMonitor#INSTANCE} if
    109109     * null
    110110     * @return the downloaded data

  • trunk/src/org/openstreetmap/josm/io/OsmServerWriter.java

    r4645 r5266  
    185185     * @param primitives list of objects to send
    186186     * @param changeset the changeset the data is uploaded to. Must not be null.
    187      * @param monitor the progress monitor. If null, assumes {@see NullProgressMonitor#INSTANCE}
     187     * @param monitor the progress monitor. If null, assumes {@link NullProgressMonitor#INSTANCE}
    188188     * @throws IllegalArgumentException thrown if changeset is null
    189189     * @throws IllegalArgumentException thrown if strategy is null

  • trunk/src/org/openstreetmap/josm/io/auth/CredentialsAgent.java

    r4690 r5266  
    1111 * A CredentialsAgent manages two credentials:
    1212 * <ul>
    13  *   <li>the credential for {@see RequestorType#SERVER} which is equal to the OSM API credentials
     13 *   <li>the credential for {@link RequestorType#SERVER} which is equal to the OSM API credentials
    1414 *   in JOSM</li>
    15  *   <li>the credential for {@see RequestorType#PROXY} which is equal to the credentials for an
     15 *   <li>the credential for {@link RequestorType#PROXY} which is equal to the credentials for an
    1616 *   optional HTTP proxy server a user may use</li>
    1717 *  </ul>
    … …  
    2424     * Looks up the credentials for a given type.
    2525     *
    26      * @param the type of service. {@see RequestorType#SERVER} for the OSM API server, {@see RequestorType#PROXY}
     26     * @param the type of service. {@link RequestorType#SERVER} for the OSM API server, {@link RequestorType#PROXY}
    2727     * for a proxy server
    2828     * @return the credentials
    … …  
    3434     * Saves the credentials in <code>credentials</code> for the given service type.
    3535     *
    36      * @param the type of service. {@see RequestorType#SERVER} for the OSM API server, {@see RequestorType#PROXY}
     36     * @param the type of service. {@link RequestorType#SERVER} for the OSM API server, {@link RequestorType#PROXY}
    3737     * for a proxy server
    3838     * @param credentials the credentials
    … …  
    4343    /**
    4444     *
    45      * @param requestorType  the type of service. {@see RequestorType#SERVER} for the OSM API server, {@see RequestorType#PROXY}
     45     * @param requestorType  the type of service. {@link RequestorType#SERVER} for the OSM API server, {@link RequestorType#PROXY}
    4646     * for a proxy server
    4747     * @param noSuccessWithLastResponse true, if the last request with the supplied credentials failed; false otherwise.

  • trunk/src/org/openstreetmap/josm/io/auth/CredentialsAgentResponse.java

    r4310 r5266  
    33
    44/**
    5  * CredentialsAgentResponse represents the response from {@see CredentialsAgent#getCredentials(java.net.Authenticator.RequestorType, boolean)}.
     5 * CredentialsAgentResponse represents the response from {@link CredentialsAgent#getCredentials(java.net.Authenticator.RequestorType, boolean)}.
    66 *
    77 * The response consists of the username and the password the requested credentials consists of.
    88 * In addition, it provides information whether authentication was canceled by the user, i.e.
    9  * because he or she canceled a username/password dialog (see {@see #isCanceled()}.
     9 * because he or she canceled a username/password dialog (see {@link #isCanceled()}.
    1010 *
    1111 */

  • trunk/src/org/openstreetmap/josm/io/auth/CredentialsManager.java

    r5111 r5266  
    1414 * CredentialManager is a factory for the single credential agent used.
    1515 *
    16  * Currently, it defaults to replying an instance of {@see JosmPreferencesCredentialAgent}.
     16 * Currently, it defaults to replying an instance of {@link JosmPreferencesCredentialAgent}.
    1717 *
    1818 */

  • trunk/src/org/openstreetmap/josm/io/auth/DefaultAuthenticator.java

    r4690 r5266  
    1212 * This is the default authenticator used in JOSM. It delegates lookup of credentials
    1313 * for the OSM API and an optional proxy server to the currently configured
    14  * {@see CredentialsManager}.
     14 * {@link CredentialsManager}.
    1515 *
    1616 */

  • trunk/src/org/openstreetmap/josm/plugins/PluginDownloadTask.java

    r4310 r5266  
    3030 * Asynchronous task for downloading a collection of plugins.
    3131 *
    32  * When the task is finished {@see #getDownloadedPlugins()} replies the list of downloaded plugins
    33  * and {@see #getFailedPlugins()} replies the list of failed plugins.
     32 * When the task is finished {@link #getDownloadedPlugins()} replies the list of downloaded plugins
     33 * and {@link #getFailedPlugins()} replies the list of failed plugins.
    3434 *
    3535 */
    … …  
    4545     * Creates the download task
    4646     *
    47      * @param parent the parent component relative to which the {@see PleaseWaitDialog} is displayed
     47     * @param parent the parent component relative to which the {@link PleaseWaitDialog} is displayed
    4848     * @param toUpdate a collection of plugin descriptions for plugins to update/download. Must not be null.
    49      * @param title the title to display in the {@see PleaseWaitDialog}
     49     * @param title the title to display in the {@link PleaseWaitDialog}
    5050     * @throws IllegalArgumentException thrown if toUpdate is null
    5151     */
    … …  
    5959     * Creates the task
    6060     *
    61      * @param monitor a progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null
     61     * @param monitor a progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null
    6262     * @param toUpdate a collection of plugin descriptions for plugins to update/download. Must not be null.
    63      * @param title the title to display in the {@see PleaseWaitDialog}
     63     * @param title the title to display in the {@link PleaseWaitDialog}
    6464     * @throws IllegalArgumentException thrown if toUpdate is null
    6565     */

  • trunk/src/org/openstreetmap/josm/plugins/PluginHandler.java

    r5194 r5266  
    519519     *
    520520     * @param plugins the list of plugins
    521      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null.
     521     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null.
    522522     */
    523523    public static void loadPlugins(Component parent,Collection<PluginInformation> plugins, ProgressMonitor monitor) {
    … …  
    564564
    565565    /**
    566      * Loads plugins from <code>plugins</code> which have the flag {@see PluginInformation#early}
     566     * Loads plugins from <code>plugins</code> which have the flag {@link PluginInformation#early}
    567567     * set to true.
    568568     *
    569569     * @param plugins the collection of plugins
    570      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null.
     570     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null.
    571571     */
    572572    public static void loadEarlyPlugins(Component parent, Collection<PluginInformation> plugins, ProgressMonitor monitor) {
    … …  
    581581
    582582    /**
    583      * Loads plugins from <code>plugins</code> which have the flag {@see PluginInformation#early}
     583     * Loads plugins from <code>plugins</code> which have the flag {@link PluginInformation#early}
    584584     * set to false.
    585585     *
    586586     * @param plugins the collection of plugins
    587      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null.
     587     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null.
    588588     */
    589589    public static void loadLatePlugins(Component parent, Collection<PluginInformation> plugins, ProgressMonitor monitor) {
    … …  
    601601     * plugin lists.
    602602     *
    603      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null.
     603     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null.
    604604     * @return the list of locally available plugin information
    605605     *
    … …  
    661661     * messages.
    662662     *
    663      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null.
     663     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null.
    664664     * @return the set of plugins to load (as set of plugin names)
    665665     */
    … …  
    731731     * @param parent the parent component for message boxes
    732732     * @param plugins the collection of plugins to update. Must not be null.
    733      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null.
     733     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null.
    734734     * @throws IllegalArgumentException thrown if plugins is null
    735735     */

  • trunk/src/org/openstreetmap/josm/plugins/ReadLocalPluginInformationTask.java

    r4737 r5266  
    2525 * in the local plugin repositories.
    2626 *
    27  * It scans the files in the local plugins repository (see {@see Preferences#getPluginsDirectory()}
     27 * It scans the files in the local plugins repository (see {@link Preferences#getPluginsDirectory()}
    2828 * and extracts plugin information from three kind of files:
    2929 * <ul>

  • trunk/src/org/openstreetmap/josm/plugins/ReadRemotePluginInformationTask.java

    r4721 r5266  
    7272     * Creates the task
    7373     *
    74      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null
     74     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null
    7575     * @param sites the collection of download sites. Defaults to the empty collection if null.
    7676     */

  • trunk/src/org/openstreetmap/josm/tools/CheckParameterUtil.java

    r3871 r5266  
    4141
    4242    /**
    43      * Ensures that <code>id</code> is non-null primitive id of type {@see OsmPrimitiveType#NODE}
     43     * Ensures that <code>id</code> is non-null primitive id of type {@link OsmPrimitiveType#NODE}
    4444     *
    4545     * @param id  the primitive  id

  • trunk/src/org/openstreetmap/josm/tools/ExceptionUtil.java

    r4821 r5266  
    438438
    439439    /**
    440      * Explains a {@see SecurityException} which has caused an {@see OsmTransferException}.
     440     * Explains a {@link SecurityException} which has caused an {@link OsmTransferException}.
    441441     * This is most likely happening when user tries to access the OSM API from within an
    442442     * applet which wasn't loaded from the API server.
    … …  
    461461
    462462    /**
    463      * Explains a {@see SocketException} which has caused an {@see OsmTransferException}.
     463     * Explains a {@link SocketException} which has caused an {@link OsmTransferException}.
    464464     * This is most likely because there's not connection to the Internet or because
    465465     * the remote server is not reachable.
    … …  
    477477
    478478    /**
    479      * Explains a {@see IOException} which has caused an {@see OsmTransferException}.
     479     * Explains a {@link IOException} which has caused an {@link OsmTransferException}.
    480480     * This is most likely happening when the communication with the remote server is
    481481     * interrupted for any reason.
    … …  
    495495
    496496    /**
    497      * Explains a {@see IllegalDataException} which has caused an {@see OsmTransferException}.
     497     * Explains a {@link IllegalDataException} which has caused an {@link OsmTransferException}.
    498498     * This is most likely happening when JOSM tries to load data in in an unsupported format.
    499499     *
    … …  
    510510
    511511    /**
    512      * Explains a {@see OsmApiException} which was thrown because of an internal server
     512     * Explains a {@link OsmApiException} which was thrown because of an internal server
    513513     * error in the OSM API server..
    514514     *
    … …  
    525525
    526526    /**
    527      * Explains a {@see OsmApiException} which was thrown because of a bad
     527     * Explains a {@link OsmApiException} which was thrown because of a bad
    528528     * request
    529529     *
    … …  
    548548   
    549549    /**
    550      * Explains a {@see OsmApiException} which was thrown because of
     550     * Explains a {@link OsmApiException} which was thrown because of
    551551     * bandwidth limit exceeded (HTTP error 509)
    552552     *
    … …  
    562562
    563563    /**
    564      * Explains a {@see OsmApiException} which was thrown because a resource wasn't found.
     564     * Explains a {@link OsmApiException} which was thrown because a resource wasn't found.
    565565     *
    566566     * @param e the exception
    … …  
    579579
    580580    /**
    581      * Explains a {@see UnknownHostException} which has caused an {@see OsmTransferException}.
     581     * Explains a {@link UnknownHostException} which has caused an {@link OsmTransferException}.
    582582     * This is most likely happening when there is an error in the API URL or when
    583583     * local DNS services are not working.
    … …  
    625625
    626626    /**
    627      * Explains an {@see OsmTransferException} to the user.
    628      *
    629      * @param e the {@see OsmTransferException}
     627     * Explains an {@link OsmTransferException} to the user.
     628     *
     629     * @param e the {@link OsmTransferException}
    630630     */
    631631    public static String explainOsmTransferException(OsmTransferException e) {
    … …  
    662662    /**
    663663     * explains the case of an error due to a delete request on an already deleted
    664      * {@see OsmPrimitive}, i.e. a HTTP response code 410, where we don't know which
    665      * {@see OsmPrimitive} is causing the error.
     664     * {@link OsmPrimitive}, i.e. a HTTP response code 410, where we don't know which
     665     * {@link OsmPrimitive} is causing the error.
    666666     *
    667667     * @param e the exception
    … …  
    680680
    681681    /**
    682      * Explains an {@see Exception} to the user.
    683      *
    684      * @param e the {@see Exception}
     682     * Explains an {@link Exception} to the user.
     683     *
     684     * @param e the {@link Exception}
    685685     */
    686686    public static String explainException(Exception e) {

  • trunk/src/org/openstreetmap/josm/tools/Geometry.java

    r5125 r5266  
    534534     * @param w the way to be checked.
    535535     * @return true if and only if way is oriented clockwise.
    536      * @throws IllegalArgumentException if way is not closed (see {@see Way#isClosed}).
     536     * @throws IllegalArgumentException if way is not closed (see {@link Way#isClosed}).
    537537     * @see http://paulbourke.net/geometry/polyarea/
    538538     */

  • trunk/src/org/openstreetmap/josm/tools/I18n.java

    r5245 r5266  
    132132     * For example, {@code tr("JOSM''s default value is ''{0}''.", val)}.
    133133     * <br/>
    134      * Use {@see #trn} for distinguishing singular from plural text, i.e.,
     134     * Use {@link #trn} for distinguishing singular from plural text, i.e.,
    135135     * do not use {@code tr(size == 1 ? "singular" : "plural")} nor
    136136     * {@code size == 1 ? tr("singular") : tr("plural")}
    … …  
    634634
    635635    /**
    636      * Sets the default locale (see {@see Locale#setDefault(Locale)} to the local
     636     * Sets the default locale (see {@link Locale#setDefault(Locale)} to the local
    637637     * given by <code>localName</code>.
    638638     *

  • trunk/src/org/openstreetmap/josm/tools/LanguageInfo.java

    r4212 r5266  
    5555     * Replies the locale code used by JOSM for a given locale.
    5656     *
    57      * In most cases JOSM uses the 2-character ISO 639 language code ({@see Locale#getLanguage()}
     57     * In most cases JOSM uses the 2-character ISO 639 language code ({@link Locale#getLanguage()}
    5858     * to identify the locale of a localized resource, but in some cases it may use the
    59      * programmatic name for locales, as replied by {@see Locale#toString()}.
     59     * programmatic name for locales, as replied by {@link Locale#toString()}.
    6060     *
    6161     * @param locale the locale. Replies "en" if null.

  • trunk/src/org/openstreetmap/josm/tools/OpenBrowser.java

    r4578 r5266  
    3131     * @return <code>null</code> for success or a string in case of an error.
    3232     * @throws IllegalStateException thrown if no platform is set to which opening the URL can be dispatched,
    33      * {@see Main#platform}
     33     * {@link Main#platform}
    3434     */
    3535    public static String displayUrl(URI uri) {

  • trunk/src/org/openstreetmap/josm/tools/Shortcut.java

    r5002 r5266  
    2929 *       finally manages loading and saving shortcuts to/from the preferences.
    3030 *
    31  * Action authors: You only need the {@see #registerShortcut} factory. Ignore everything
     31 * Action authors: You only need the {@link #registerShortcut} factory. Ignore everything
    3232 *                 else.
    3333 *
Note: See TracChangeset for help on using the changeset viewer.