Add "deprecated:" flag to the spec files.

Also cleanup of the documentation found in the header and html files.

Change-Id: I8a606d1af93b0fd0f912ac23aabdb73aa99233b4
diff --git a/scriptc/rs_allocation_data.rsh b/scriptc/rs_allocation_data.rsh
index 578e73c..12d62a0 100644
--- a/scriptc/rs_allocation_data.rsh
+++ b/scriptc/rs_allocation_data.rsh
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-// Don't edit this file!  It is auto-generated by frameworks/rs/api/gen_runtime.
+// Don't edit this file!  It is auto-generated by frameworks/rs/api/generate.sh.
 
 /*
  * rs_allocation_data.rsh: Allocation routines
@@ -24,6 +24,7 @@
  * Functions that can be used to query the characteristics of an allocation,
  * to set and get elements of the allocation.
  */
+
 #ifndef RENDERSCRIPT_RS_ALLOCATION_DATA_RSH
 #define RENDERSCRIPT_RS_ALLOCATION_DATA_RSH
 
@@ -36,13 +37,13 @@
  * the same allocation yields undefined results.
  *
  * Parameters:
- *   dstAlloc Allocation to copy data into.
- *   dstOff The offset of the first element to be copied in the destination allocation.
- *   dstMip Mip level in the destination allocation.
- *   count The number of elements to be copied.
- *   srcAlloc The source data allocation.
- *   srcOff The offset of the first element in data to be copied in the source allocation.
- *   srcMip Mip level in the source allocation.
+ *   dstAlloc: Allocation to copy data into.
+ *   dstOff: The offset of the first element to be copied in the destination allocation.
+ *   dstMip: Mip level in the destination allocation.
+ *   count: The number of elements to be copied.
+ *   srcAlloc: The source data allocation.
+ *   srcOff: The offset of the first element in data to be copied in the source allocation.
+ *   srcMip: Mip level in the source allocation.
  */
 #if (defined(RS_VERSION) && (RS_VERSION >= 14))
 extern void __attribute__((overloadable))
@@ -59,18 +60,18 @@
  * the same allocation yields undefined results.
  *
  * Parameters:
- *   dstAlloc Allocation to copy data into.
- *   dstXoff X offset of the region to update in the destination allocation.
- *   dstYoff Y offset of the region to update in the destination allocation.
- *   dstMip Mip level in the destination allocation.
- *   dstFace Cubemap face of the destination allocation, ignored for allocations that aren't cubemaps.
- *   width Width of the incoming region to update.
- *   height Height of the incoming region to update.
- *   srcAlloc The source data allocation.
- *   srcXoff X offset in data of the source allocation.
- *   srcYoff Y offset in data of the source allocation.
- *   srcMip Mip level in the source allocation.
- *   srcFace Cubemap face of the source allocation, ignored for allocations that aren't cubemaps.
+ *   dstAlloc: Allocation to copy data into.
+ *   dstXoff: X offset of the region to update in the destination allocation.
+ *   dstYoff: Y offset of the region to update in the destination allocation.
+ *   dstMip: Mip level in the destination allocation.
+ *   dstFace: Cubemap face of the destination allocation, ignored for allocations that aren't cubemaps.
+ *   width: Width of the incoming region to update.
+ *   height: Height of the incoming region to update.
+ *   srcAlloc: The source data allocation.
+ *   srcXoff: X offset in data of the source allocation.
+ *   srcYoff: Y offset in data of the source allocation.
+ *   srcMip: Mip level in the source allocation.
+ *   srcFace: Cubemap face of the source allocation, ignored for allocations that aren't cubemaps.
  */
 #if (defined(RS_VERSION) && (RS_VERSION >= 14))
 extern void __attribute__((overloadable))
@@ -2475,10 +2476,10 @@
  * For 2D, use the float2 variant.
  *
  * Parameters:
- *   a allocation to sample from
- *   s sampler state
- *   location location to sample from
- *   lod mip level to sample from, for fractional values mip levels will be interpolated if RS_SAMPLER_LINEAR_MIP_LINEAR is used
+ *   a: allocation to sample from
+ *   s: sampler state
+ *   location: location to sample from
+ *   lod: mip level to sample from, for fractional values mip levels will be interpolated if RS_SAMPLER_LINEAR_MIP_LINEAR is used
  */
 #if (defined(RS_VERSION) && (RS_VERSION >= 16))
 extern float4 __attribute__((overloadable))