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_debug.rsh b/scriptc/rs_debug.rsh
index b6a6fb2..d52590e 100644
--- a/scriptc/rs_debug.rsh
+++ b/scriptc/rs_debug.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_debug.rsh: Utility debugging routines
@@ -23,6 +23,7 @@
  * not be used in shipping applications.  All print a string and value pair to
  * the standard log.
  */
+
 #ifndef RENDERSCRIPT_RS_DEBUG_RSH
 #define RENDERSCRIPT_RS_DEBUG_RSH