Clean code.

src/main/org/insa/graphics/drawing/components/BasicDrawing.java

@@ -449,11 +449,15 @@ public class BasicDrawing extends JPanel implements Drawing {
      * Return the longitude and latitude corresponding to the given position of the
      * MouseEvent.
      * 
-     * @param event
+     * @param event MouseEvent from which longitude/latitude should be retrieved.
      * 
-     * @return
+     * @return Point representing the projection of the MouseEvent position in the
+     *         graph/map.
+     * 
+     * @throws NoninvertibleTransformException if the actual transformation is
+     *         invalid.
      */
-    public Point getLongitudeLatitude(MouseEvent event) throws NoninvertibleTransformException {
+    protected Point getLongitudeLatitude(MouseEvent event) throws NoninvertibleTransformException {
         // Get the point using the inverse transform of the Zoom/Pan object, this gives
         // us
         // a point within the drawing box (between [0, 0] and [width, height]).

src/main/org/insa/graphics/drawing/components/MapZoomControls.java

@@ -111,7 +111,7 @@ public class MapZoomControls {
     /**
      * Add a zoom-in listener.
      * 
-     * @param listener
+     * @param listener Zoom-in listener to add to this MapZoomControls instance.
      */
     public void addZoomInListener(ActionListener listener) {
         this.zoomInListeners.add(listener);
@@ -120,7 +120,7 @@ public class MapZoomControls {
     /**
      * Add a zoom-out listener.
      * 
-     * @param listener
+     * @param listener Zoom-out listener to add to this MapZoomControls instance.
      */
     public void addZoomOutListener(ActionListener listener) {
         this.zoomOutListeners.add(listener);
@@ -134,9 +134,9 @@ public class MapZoomControls {
     }
 
     /**
-     * Set the current zoom level.
+     * Set the current zoom level without requesting a redraw.
      * 
-     * @param level
+     * @param level Zoom level to set.
      */
     public void setZoomLevel(int level) {
         this.currentLevel = level;
@@ -161,10 +161,10 @@ public class MapZoomControls {
      * Check if a point is contained inside an element of this zoom controls, useful
      * to avoid spurious click listeners.
      * 
-     * @param point
+     * @param point Point to check.
      * 
      * @return true if the given point correspond to an element of this zoom
-     * controls.
+     *         controls.
      */
     public boolean contains(Point point) {
         return zoomInRect.contains(point) || zoomOutRect.contains(point);