gps: Unhide GpsStatus.NmeaListener interface for receiving NMEA sentences

Signed-off-by: Mike Lockwood <lockwood@android.com>

2 files changed, 8 insertions, 9 deletions

diff --git a/location/java/android/location/GpsStatus.java b/location/java/android/location/GpsStatus.java
index 883ee4f..ce69ac1 100644
--- a/location/java/android/location/GpsStatus.java
+++ b/location/java/android/location/GpsStatus.java
@@ -116,9 +116,12 @@ public final class GpsStatus {
     }
 
     /**
-     * Used for receiving NMEA data from the GPS.
-     *
-     * {@hide}
+     * Used for receiving NMEA sentences from the GPS.
+     * NMEA 0183 is a standard for communicating with marine electronic devices
+     * and is a common method for receiving data from a GPS, typically over a serial port.
+     * See <a href="http://en.wikipedia.org/wiki/NMEA_0183">NMEA 0183</a> for more details.
+     * You can implement this interface and call {@link LocationManager#addNmeaListener}
+     * to receive NMEA data from the GPS engine.
      */
     public interface NmeaListener {
         void onNmeaReceived(long timestamp, String nmea);
diff --git a/location/java/android/location/LocationManager.java b/location/java/android/location/LocationManager.java
index 8f17e78..8f0352d 100644
--- a/location/java/android/location/LocationManager.java
+++ b/location/java/android/location/LocationManager.java
@@ -1276,13 +1276,11 @@ public class LocationManager {
     /**
      * Adds an NMEA listener.
      *
-     * @param listener NMEA listener object to register
+     * @param listener a {#link GpsStatus.NmeaListener} object to register
      *
      * @return true if the listener was successfully added
      *
      * @throws SecurityException if the ACCESS_FINE_LOCATION permission is not present
-     *
-     * {@hide}
      */
     public boolean addNmeaListener(GpsStatus.NmeaListener listener) {
         boolean result;
@@ -1308,9 +1306,7 @@ public class LocationManager {
     /**
      * Removes an NMEA listener.
      *
-     * @param listener NMEA listener object to remove
-     *
-     * {@hide}
+     * @param listener a {#link GpsStatus.NmeaListener} object to remove
      */
     public void removeNmeaListener(GpsStatus.NmeaListener listener) {
         try {