Add documentation for the parking package

src/com/uncc/gameday/parking/ParkingClient.java

@@ -14,13 +14,13 @@ import com.uncc.gameday.rest.GamedayService;
  */
 public class ParkingClient {
 
-	/** The gds. */
+	/** The GamedayService reference */
 	private GamedayService gds;
 	
 	/**
 	 * Instantiates a new parking client.
 	 *
-	 * @param c the c
+	 * @param c - The context used to access the Resource file
 	 */
 	public ParkingClient(Context c) {
 		RestAdapter ra = new RestAdapter.Builder()
@@ -30,7 +30,7 @@ public class ParkingClient {
 	}
 	
 	/**
-	 * List lots.
+	 * List all parking lots
 	 *
 	 * @return the list
 	 */
@@ -81,7 +81,7 @@ public class ParkingClient {
 	}
 	
 	/**
-	 * List lot location.
+	 * Get the coordinates for a specific parking lot
 	 *
 	 * @param p the p
 	 * @return the parking lot
@@ -93,7 +93,7 @@ public class ParkingClient {
 	}
 	
 	/**
-	 * List lot location.
+	 * Get the coordinates for a specific parking lot
 	 *
 	 * @param c the c
 	 * @return the parking lot

src/com/uncc/gameday/parking/ParkingLot.java

@@ -1,8 +1,9 @@
 package com.uncc.gameday.parking;
 
-// TODO: Auto-generated Javadoc
 /**
  * The Class ParkingLot.
+ * Basic POJO used for communicating information about each Parking lot
+ * between the Gameday app and server-side implementation
  */
 public class ParkingLot {
 	

src/com/uncc/gameday/parking/ParkingLotCallback.java

@@ -5,9 +5,11 @@ import retrofit.Callback;
 import retrofit.RetrofitError;
 import retrofit.client.Response;
 
-// TODO: Auto-generated Javadoc
 /**
- * The Class ParkingLotCallback.
+ * Utility class used by Retrofit for implementing a callback on POST.
+ * Why they can't use a synchronous POST is beyond me.
+ * This class is likely un-needed, but allows for easy change in the future
+ * if needed.
  */
 public class ParkingLotCallback implements Callback<ParkingLot> {
 

src/com/uncc/gameday/parking/RatingChoices.java

@@ -6,16 +6,16 @@ package com.uncc.gameday.parking;
  */
 public enum RatingChoices {
 	
-	/** The emp. */
+	/** An Empty rating (0% full) */
 	EMP ("EMPTY"),
 	
-	/** The sct. */
+	/** A Scattered rating (33% full) */
 	SCT ("SCATTERED"),
 	
-	/** The bsy. */
+	/** A Busy rating (66% full) */
 	BSY ("BUSY"),
 	
-	/** The fll. */
+	/** A Full rating (100% full) */
 	FLL ("FULL");
 	
 	/** The choice. */