Index: trunk/src/org/openstreetmap/josm/actions/audio/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/audio/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/actions/audio/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM audio playback actions.
+ */
+package org.openstreetmap.josm.actions.audio;
Index: trunk/src/org/openstreetmap/josm/actions/downloadtasks/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/downloadtasks/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/actions/downloadtasks/package-info.java	(revision 10747)
@@ -0,0 +1,7 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM {@link org.openstreetmap.josm.actions.downloadtasks.DownloadTask download tasks} .
+ * They are used to download geographic data (OSM data, GPX tracks, etc.) for a given URL or geographic area.
+ */
+package org.openstreetmap.josm.actions.downloadtasks;
Index: trunk/src/org/openstreetmap/josm/actions/mapmode/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/mapmode/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/actions/mapmode/package-info.java	(revision 10747)
@@ -0,0 +1,7 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM {@link org.openstreetmap.josm.actions.mapmode.MapMode map modes}.
+ * Map modes are different ways to edit the map (select, draw, etc.).
+ */
+package org.openstreetmap.josm.actions.mapmode;
Index: trunk/src/org/openstreetmap/josm/actions/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/package-info.java	(revision 10746)
+++ trunk/src/org/openstreetmap/josm/actions/package-info.java	(revision 10747)
@@ -3,5 +3,5 @@
 /**
  * Provides the classes for JOSM user actions.
- * All of them inherit from {@code JosmAction}.
+ * All of them inherit from {@link org.openstreetmap.josm.actions.JosmAction JosmAction}.
  */
 package org.openstreetmap.josm.actions;
Index: trunk/src/org/openstreetmap/josm/actions/relation/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/relation/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/actions/relation/package-info.java	(revision 10747)
@@ -0,0 +1,7 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM actions that work with {@link org.openstreetmap.josm.data.osm.Relation relations}.
+ * @see org.openstreetmap.josm.actions.relation.AbstractRelationAction
+ */
+package org.openstreetmap.josm.actions.relation;
Index: trunk/src/org/openstreetmap/josm/actions/search/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/search/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/actions/search/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM {@link org.openstreetmap.josm.actions.search.SearchAction search action}.
+ */
+package org.openstreetmap.josm.actions.search;
Index: trunk/src/org/openstreetmap/josm/actions/upload/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/actions/upload/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/actions/upload/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM {@link org.openstreetmap.josm.actions.UploadAction upload action}.
+ */
+package org.openstreetmap.josm.actions.upload;
Index: trunk/src/org/openstreetmap/josm/corrector/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/corrector/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/corrector/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM {@link org.openstreetmap.josm.corrector.TagCorrector tag correctors}.
+ */
+package org.openstreetmap.josm.corrector;
Index: trunk/src/org/openstreetmap/josm/data/cache/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/cache/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/cache/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM cache of imagery tiles, backed up by JCS.
+ */
+package org.openstreetmap.josm.data.cache;
Index: trunk/src/org/openstreetmap/josm/data/conflict/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/conflict/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/conflict/package-info.java	(revision 10747)
@@ -0,0 +1,7 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for edition {@link org.openstreetmap.josm.data.conflict.Conflict conflicts}
+ * between {@link org.openstreetmap.josm.data.osm.OsmPrimitive OsmPrimitive}s
+ */
+package org.openstreetmap.josm.data.conflict;
Index: trunk/src/org/openstreetmap/josm/data/coor/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/coor/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/coor/package-info.java	(revision 10747)
@@ -0,0 +1,7 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for geographic {@link org.openstreetmap.josm.data.coor.Coordinate coordinates}
+ * (east/north and lat/lon systems).
+ */
+package org.openstreetmap.josm.data.coor;
Index: trunk/src/org/openstreetmap/josm/data/gpx/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/gpx/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/gpx/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM {@link org.openstreetmap.josm.data.gpx.GpxData GPX data} (points, tracks, routes).
+ */
+package org.openstreetmap.josm.data.gpx;
Index: trunk/src/org/openstreetmap/josm/data/imagery/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/imagery/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/imagery/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM imagery sources, coupled with {@code JMapViewer} classes.
+ */
+package org.openstreetmap.josm.data.imagery;
Index: trunk/src/org/openstreetmap/josm/data/notes/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/notes/package-info.java	(revision 10746)
+++ trunk/src/org/openstreetmap/josm/data/notes/package-info.java	(revision 10747)
@@ -2,5 +2,6 @@
 
 /**
- * Provides the classes for OSM notes. See <a href="https://wiki.openstreetmap.org/wiki/Notes">Notes</a>.
+ * Provides the classes for OSM {@link org.openstreetmap.josm.data.notes.Note notes}.
+ * See <a href="https://wiki.openstreetmap.org/wiki/Notes">Notes on OSM wiki</a>.
  */
 package org.openstreetmap.josm.data.notes;
Index: trunk/src/org/openstreetmap/josm/data/oauth/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/oauth/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/oauth/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for OAuth authentication to OSM.
+ */
+package org.openstreetmap.josm.data.oauth;
Index: trunk/src/org/openstreetmap/josm/data/osm/event/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/event/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/osm/event/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for OSM dataset events.
+ */
+package org.openstreetmap.josm.data.osm.event;
Index: trunk/src/org/openstreetmap/josm/data/osm/history/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/history/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/osm/history/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for OSM primitives {@link org.openstreetmap.josm.data.osm.history.History history} (edition revisions).
+ */
+package org.openstreetmap.josm.data.osm.history;
Index: trunk/src/org/openstreetmap/josm/data/osm/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/osm/package-info.java	(revision 10747)
@@ -0,0 +1,15 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for OSM data:<ul>
+ * <li>{@link org.openstreetmap.josm.data.osm.IPrimitive Primitives}:
+ *     {@link org.openstreetmap.josm.data.osm.Node Node},
+ *     {@link org.openstreetmap.josm.data.osm.Way Way},
+ *     {@link org.openstreetmap.josm.data.osm.Relation Relation}</li>
+ * <li>{@link org.openstreetmap.josm.data.osm.User Users}</li>
+ * <li>{@link org.openstreetmap.josm.data.osm.Tag Tags}</li>
+ * <li>{@link org.openstreetmap.josm.data.osm.Changeset Changesets}</li>
+ * <li>Utilities classes</li>
+ * </ul>
+ */
+package org.openstreetmap.josm.data.osm;
Index: trunk/src/org/openstreetmap/josm/data/osm/visitor/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/visitor/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/osm/visitor/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for performing actions on OSM primitives using Visitor design pattern.
+ */
+package org.openstreetmap.josm.data.osm.visitor;
Index: trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/package-info.java	(revision 10747)
@@ -0,0 +1,8 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for painting (rendering) OSM primitives on the map. Two renderers are builtin:
+ * {@link org.openstreetmap.josm.data.osm.visitor.paint.StyledMapRenderer StyledMapRenderer} and
+ * {@link org.openstreetmap.josm.data.osm.visitor.paint.WireframeMapRenderer WireframeMapRenderer}.
+ */
+package org.openstreetmap.josm.data.osm.visitor.paint;
Index: trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/relations/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/relations/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/relations/package-info.java	(revision 10747)
@@ -0,0 +1,7 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for painting and caching
+ * {@link org.openstreetmap.josm.data.osm.visitor.paint.relations.Multipolygon Multipolygon} relations.
+ */
+package org.openstreetmap.josm.data.osm.visitor.paint.relations;
Index: trunk/src/org/openstreetmap/josm/data/preferences/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/preferences/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/preferences/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for storing JOSM user preferences.
+ */
+package org.openstreetmap.josm.data.preferences;
Index: trunk/src/org/openstreetmap/josm/data/projection/datum/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/projection/datum/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/projection/datum/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for datums used in map projections.
+ */
+package org.openstreetmap.josm.data.projection.datum;
Index: trunk/src/org/openstreetmap/josm/data/projection/proj/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/projection/proj/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/projection/proj/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM map projections implementations.
+ */
+package org.openstreetmap.josm.data.projection.proj;
Index: trunk/src/org/openstreetmap/josm/data/validation/tests/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/validation/tests/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/validation/tests/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides the classes for JOSM data validation tests.
+ */
+package org.openstreetmap.josm.data.validation.tests;
Index: trunk/src/org/openstreetmap/josm/data/validation/util/package-info.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/validation/util/package-info.java	(revision 10747)
+++ trunk/src/org/openstreetmap/josm/data/validation/util/package-info.java	(revision 10747)
@@ -0,0 +1,6 @@
+// License: GPL. For details, see LICENSE file.
+
+/**
+ * Provides utilities classes for JOSM data validation.
+ */
+package org.openstreetmap.josm.data.validation.util;