Index: /trunk/src/org/openstreetmap/josm/gui/dialogs/DeleteFromRelationConfirmationDialog.java =================================================================== --- /trunk/src/org/openstreetmap/josm/gui/dialogs/DeleteFromRelationConfirmationDialog.java (revision 12300) +++ /trunk/src/org/openstreetmap/josm/gui/dialogs/DeleteFromRelationConfirmationDialog.java (revision 12301) @@ -183,5 +183,4 @@ /** * The table model which manages the list of relation-to-child references - * */ public static class RelationMemberTableModel extends DefaultTableModel { @@ -213,4 +212,8 @@ } + /** + * Sets the data that should be displayed in the list. + * @param references A list of references to display + */ public void populate(Collection references) { data.clear(); @@ -222,4 +225,8 @@ } + /** + * Gets the list of children that are currently displayed. + * @return The children. + */ public Set getObjectsToDelete() { Set ret = new HashSet<>(); @@ -230,8 +237,16 @@ } + /** + * Gets the number of elements {@link #getObjectsToDelete()} would return. + * @return That number. + */ public int getNumObjectsToDelete() { return getObjectsToDelete().size(); } + /** + * Gets the set of parent relations + * @return All parent relations of the references + */ public Set getParentRelations() { Set ret = new HashSet<>(); @@ -242,4 +257,8 @@ } + /** + * Gets the number of elements {@link #getParentRelations()} would return. + * @return That number. + */ public int getNumParentRelations() { return getParentRelations().size(); Index: /trunk/src/org/openstreetmap/josm/gui/dialogs/LatLonDialog.java =================================================================== --- /trunk/src/org/openstreetmap/josm/gui/dialogs/LatLonDialog.java (revision 12300) +++ /trunk/src/org/openstreetmap/josm/gui/dialogs/LatLonDialog.java (revision 12301) @@ -34,7 +34,13 @@ import org.openstreetmap.josm.tools.WindowGeometry; +/** + * A dialog that lets the user add a node at the coordinates he enters. + */ public class LatLonDialog extends ExtendedDialog { private static final Color BG_COLOR_ERROR = new Color(255, 224, 224); + /** + * The tabs that define the coordinate mode. + */ public JTabbedPane tabs; private JosmTextField tfLatLon, tfEastNorth; @@ -155,4 +161,10 @@ } + /** + * Creates a new {@link LatLonDialog} + * @param parent The parent + * @param title The title of this dialog + * @param help The help text to use + */ public LatLonDialog(Component parent, String title, String help) { super(parent, title, tr("Ok"), tr("Cancel")); @@ -164,8 +176,16 @@ } + /** + * Check if lat/lon mode is active + * @return true iff the user selects lat/lon coordinates + */ public boolean isLatLon() { return tabs.getModel().getSelectedIndex() == 0; } + /** + * Sets the coordinate fields to the given coordinates + * @param ll The lat/lon coordinates + */ public void setCoordinates(LatLon ll) { LatLon llc = Optional.ofNullable(ll).orElse(LatLon.ZERO); @@ -180,4 +200,8 @@ } + /** + * Gets the coordinates that are entered by the user. + * @return The coordinates + */ public LatLon getCoordinates() { if (isLatLon()) { @@ -189,8 +213,16 @@ } + /** + * Gets the coordinates that are entered in the lat/lon field + * @return The lat/lon coordinates + */ public LatLon getLatLonCoordinates() { return latLonCoordinates; } + /** + * Gets the coordinates that are entered in the east/north field + * @return The east/north coordinates + */ public EastNorth getEastNorthCoordinates() { return eastNorthCoordinates; @@ -320,4 +352,9 @@ } + /** + * Parses a east/north coordinate string + * @param s The coordinates + * @return The east/north coordinates or null on error. + */ public static EastNorth parseEastNorth(String s) { String[] en = s.split("[;, ]+"); @@ -332,16 +369,32 @@ } + /** + * Gets the text entered in the lat/lon text field. + * @return The text the user entered + */ public String getLatLonText() { return tfLatLon.getText(); } + /** + * Set the text in the lat/lon text field. + * @param text The new text + */ public void setLatLonText(String text) { tfLatLon.setText(text); } + /** + * Gets the text entered in the east/north text field. + * @return The text the user entered + */ public String getEastNorthText() { return tfEastNorth.getText(); } + /** + * Set the text in the east/north text field. + * @param text The new text + */ public void setEastNorthText(String text) { tfEastNorth.setText(text); Index: /trunk/src/org/openstreetmap/josm/gui/dialogs/LayerListPopup.java =================================================================== --- /trunk/src/org/openstreetmap/josm/gui/dialogs/LayerListPopup.java (revision 12300) +++ /trunk/src/org/openstreetmap/josm/gui/dialogs/LayerListPopup.java (revision 12301) @@ -32,4 +32,8 @@ public class LayerListPopup extends JPopupMenu { + /** + * An action that displays the layer information. + * @see Layer#getInfoComponent() + */ public static final class InfoAction extends AbstractAction { private final transient Layer layer; Index: /trunk/src/org/openstreetmap/josm/gui/dialogs/OsmIdSelectionDialog.java =================================================================== --- /trunk/src/org/openstreetmap/josm/gui/dialogs/OsmIdSelectionDialog.java (revision 12300) +++ /trunk/src/org/openstreetmap/josm/gui/dialogs/OsmIdSelectionDialog.java (revision 12301) @@ -52,12 +52,33 @@ protected final transient GroupLayout layout = new GroupLayout(panel); + /** + * Creates a new OsmIdSelectionDialog + * @param parent The parent element that will be used for position and maximum size + * @param title The text that will be shown in the window titlebar + * @param buttonTexts String Array of the text that will appear on the buttons. The first button is the default one. + */ public OsmIdSelectionDialog(Component parent, String title, String... buttonTexts) { super(parent, title, buttonTexts); } + /** + * Creates a new OsmIdSelectionDialog + * @param parent The parent element that will be used for position and maximum size + * @param title The text that will be shown in the window titlebar + * @param buttonTexts String Array of the text that will appear on the buttons. The first button is the default one. + * @param modal Set it to {@code true} if you want the dialog to be modal + */ public OsmIdSelectionDialog(Component parent, String title, String[] buttonTexts, boolean modal) { super(parent, title, buttonTexts, modal); } + /** + * Creates a new OsmIdSelectionDialog + * @param parent The parent element that will be used for position and maximum size + * @param title The text that will be shown in the window titlebar + * @param buttonTexts String Array of the text that will appear on the buttons. The first button is the default one. + * @param modal Set it to {@code true} if you want the dialog to be modal + * @param disposeOnClose whether to call {@link #dispose} when closing the dialog + */ public OsmIdSelectionDialog(Component parent, String title, String[] buttonTexts, boolean modal, boolean disposeOnClose) { super(parent, title, buttonTexts, modal, disposeOnClose); Index: /trunk/src/org/openstreetmap/josm/gui/dialogs/ValidatorDialog.java =================================================================== --- /trunk/src/org/openstreetmap/josm/gui/dialogs/ValidatorDialog.java (revision 12300) +++ /trunk/src/org/openstreetmap/josm/gui/dialogs/ValidatorDialog.java (revision 12301) @@ -529,4 +529,7 @@ } + /** + * A visitor that is used to compute the bounds of an error. + */ public static class ValidatorBoundingXYVisitor extends BoundingXYVisitor implements ValidatorVisitor { @Override @@ -560,4 +563,8 @@ } + /** + * Called when the selection was changed to update the list of displayed errors + * @param newSelection The new selection + */ public void updateSelection(Collection newSelection) { if (!Main.pref.getBoolean(ValidatorPreference.PREF_FILTER_BY_SELECTION, false))