Add missing block descriptions

Change-Id: Iac1c8f6162fc718ebac82d4036f5b7844770a8e7

appinventor/components/src/com/google/appinventor/components/runtime/NearField.java

@@ -89,6 +89,9 @@ implements OnStopListener, OnResumeListener, OnPauseListener, OnNewIntentListene
     EventDispatcher.dispatchEvent(this, "TagRead", message);
   }
 
+  /**
+   * Indicates that a tag has come into range of the NFC sensor and has been written.
+   */
   @SimpleEvent
   public void TagWritten() {
     Log.d(TAG, "Tag written: " + textToWrite);

appinventor/components/src/com/google/appinventor/components/runtime/Pedometer.java

@@ -447,51 +447,53 @@ public class Pedometer extends AndroidNonvisibleComponent
   // that has them is loaded.
 
   @Deprecated
-  @SimpleEvent
+  @SimpleEvent(description = "This event has been deprecated.")
   public void StartedMoving() {
   }
 
   @Deprecated
-  @SimpleEvent
+  @SimpleEvent(description = "This event has been deprecated.")
   public void StoppedMoving() {
 
   }
 
   @Deprecated
-  @SimpleProperty(category = PropertyCategory.BEHAVIOR)
+  @SimpleProperty(category = PropertyCategory.BEHAVIOR,
+      description = "This property has been deprecated.")
   public void UseGPS(boolean gps) {
   }
 
   @Deprecated
-  @SimpleEvent
+  @SimpleEvent(description = "This event has been deprecated.")
   public void CalibrationFailed() {
   }
 
   @Deprecated
-  @SimpleEvent
+  @SimpleEvent(description = "This event has been deprecated.")
   public void GPSAvailable() {
   }
 
   @Deprecated
-  @SimpleEvent
+  @SimpleEvent(description = "This event has been deprecated.")
   public void GPSLost() {
   }
 
   // Properties
 
   @Deprecated
-  @SimpleProperty(category = PropertyCategory.BEHAVIOR)
+  @SimpleProperty(category = PropertyCategory.BEHAVIOR,
+      description = "This property has been deprecated.")
   public void CalibrateStrideLength(boolean cal) {
   }
 
   @Deprecated
-  @SimpleProperty
+  @SimpleProperty(description = "This property has been deprecated.")
   public boolean CalibrateStrideLength() {
     return false;
   }
 
   @Deprecated
-  @SimpleProperty
+  @SimpleProperty(description = "This property has been deprecated.")
   public boolean Moving() {
     return false;
   }

appinventor/docs/html/reference/components/sensors.html

@@ -481,7 +481,7 @@ Valid values for the month field are 1-12 and 1-31 for the day field.</dd>
  Currently this is only a plain text tag, as specified in the
  manifest.  See Compiler.java.</dd>
   <dt id="NearField.TagWritten">TagWritten()</dt>
-  <dd>Event for TagWritten</dd>
+  <dd>Indicates that a tag has come into range of the NFC sensor and has been written.</dd>
 </dl>
 
 <h2 id="OrientationSensor">OrientationSensor</h2>
@@ -544,13 +544,13 @@ Valid values for the month field are 1-12 and 1-31 for the day field.</dd>
 
 <dl class="properties">
   <dt id="Pedometer.CalibrateStrideLength" class="boolean bo"><em>CalibrateStrideLength</em></dt>
-  <dd></dd>
+  <dd>This property has been deprecated.</dd>
   <dt id="Pedometer.Distance" class="number ro bo"><em>Distance</em></dt>
   <dd>The approximate distance traveled in meters.</dd>
   <dt id="Pedometer.ElapsedTime" class="number ro bo"><em>ElapsedTime</em></dt>
   <dd>Time elapsed in milliseconds since the pedometer was started.</dd>
   <dt id="Pedometer.Moving" class="boolean ro bo"><em>Moving</em></dt>
-  <dd></dd>
+  <dd>This property has been deprecated.</dd>
   <dt id="Pedometer.SimpleSteps" class="number ro bo"><em>SimpleSteps</em></dt>
   <dd>The number of simple steps taken since the pedometer has started.</dd>
   <dt id="Pedometer.StopDetectionTimeout" class="number"><em>StopDetectionTimeout</em></dt>
@@ -558,7 +558,7 @@ Valid values for the month field are 1-12 and 1-31 for the day field.</dd>
   <dt id="Pedometer.StrideLength" class="number"><em>StrideLength</em></dt>
   <dd>Set the average stride length in meters.</dd>
   <dt id="Pedometer.UseGPS" class="boolean wo bo"><em>UseGPS</em></dt>
-  <dd></dd>
+  <dd>This property has been deprecated.</dd>
   <dt id="Pedometer.WalkSteps" class="number ro bo"><em>WalkSteps</em></dt>
   <dd>the number of walk steps taken since the pedometer has started.</dd>
 </dl>
@@ -567,17 +567,17 @@ Valid values for the month field are 1-12 and 1-31 for the day field.</dd>
 
 <dl class="events">
   <dt id="Pedometer.CalibrationFailed">CalibrationFailed()</dt>
-  <dd>Event for CalibrationFailed</dd>
+  <dd>This event has been deprecated.</dd>
   <dt id="Pedometer.GPSAvailable">GPSAvailable()</dt>
-  <dd>Event for GPSAvailable</dd>
+  <dd>This event has been deprecated.</dd>
   <dt id="Pedometer.GPSLost">GPSLost()</dt>
-  <dd>Event for GPSLost</dd>
+  <dd>This event has been deprecated.</dd>
   <dt id="Pedometer.SimpleStep">SimpleStep(<em class="number">simpleSteps</em>,<em class="number">distance</em>)</dt>
   <dd>This event is run when a raw step is detected</dd>
   <dt id="Pedometer.StartedMoving">StartedMoving()</dt>
-  <dd>Event for StartedMoving</dd>
+  <dd>This event has been deprecated.</dd>
   <dt id="Pedometer.StoppedMoving">StoppedMoving()</dt>
-  <dd>Event for StoppedMoving</dd>
+  <dd>This event has been deprecated.</dd>
   <dt id="Pedometer.WalkStep">WalkStep(<em class="number">walkSteps</em>,<em class="number">distance</em>)</dt>
   <dd>This event is run when a walking step is detected. A walking step is a step that appears to be involved in forward motion.</dd>
 </dl>

appinventor/docs/markdown/reference/components/sensors.md

@@ -435,7 +435,7 @@ Valid values for the month field are 1-12 and 1-31 for the day field.
  manifest.  See Compiler.java.
 
 {:id="NearField.TagWritten"} TagWritten()
-: Event for TagWritten
+: Indicates that a tag has come into range of the NFC sensor and has been written.
 
 ## OrientationSensor  {#OrientationSensor}
 
@@ -494,7 +494,7 @@ Valid values for the month field are 1-12 and 1-31 for the day field.
 {:.properties}
 
 {:id="Pedometer.CalibrateStrideLength" .boolean .bo} *CalibrateStrideLength*
-: 
+: This property has been deprecated.
 
 {:id="Pedometer.Distance" .number .ro .bo} *Distance*
 : The approximate distance traveled in meters.
@@ -503,7 +503,7 @@ Valid values for the month field are 1-12 and 1-31 for the day field.
 : Time elapsed in milliseconds since the pedometer was started.
 
 {:id="Pedometer.Moving" .boolean .ro .bo} *Moving*
-: 
+: This property has been deprecated.
 
 {:id="Pedometer.SimpleSteps" .number .ro .bo} *SimpleSteps*
 : The number of simple steps taken since the pedometer has started.
@@ -515,7 +515,7 @@ Valid values for the month field are 1-12 and 1-31 for the day field.
 : Set the average stride length in meters.
 
 {:id="Pedometer.UseGPS" .boolean .wo .bo} *UseGPS*
-: 
+: This property has been deprecated.
 
 {:id="Pedometer.WalkSteps" .number .ro .bo} *WalkSteps*
 : the number of walk steps taken since the pedometer has started.
@@ -525,22 +525,22 @@ Valid values for the month field are 1-12 and 1-31 for the day field.
 {:.events}
 
 {:id="Pedometer.CalibrationFailed"} CalibrationFailed()
-: Event for CalibrationFailed
+: This event has been deprecated.
 
 {:id="Pedometer.GPSAvailable"} GPSAvailable()
-: Event for GPSAvailable
+: This event has been deprecated.
 
 {:id="Pedometer.GPSLost"} GPSLost()
-: Event for GPSLost
+: This event has been deprecated.
 
 {:id="Pedometer.SimpleStep"} SimpleStep(*simpleSteps*{:.number},*distance*{:.number})
 : This event is run when a raw step is detected
 
 {:id="Pedometer.StartedMoving"} StartedMoving()
-: Event for StartedMoving
+: This event has been deprecated.
 
 {:id="Pedometer.StoppedMoving"} StoppedMoving()
-: Event for StoppedMoving
+: This event has been deprecated.
 
 {:id="Pedometer.WalkStep"} WalkStep(*walkSteps*{:.number},*distance*{:.number})
 : This event is run when a walking step is detected. A walking step is a step that appears to be involved in forward motion.