summaryrefslogtreecommitdiffstats
path: root/android-changes.txt
diff options
context:
space:
mode:
authorTor Norbye <tnorbye@google.com>2012-02-29 07:50:52 -0800
committerTor Norbye <tnorbye@google.com>2012-02-29 07:50:52 -0800
commit73934887ea87fca353449f0fd476d6c07b349521 (patch)
treedfb64747ff6a0b4bc99fec4bbba02636727fefe4 /android-changes.txt
parent75b3d82c5c842e4be8e7d932e9dd6314b5e3b809 (diff)
downloadplatform_external_doclava-73934887ea87fca353449f0fd476d6c07b349521.tar.gz
platform_external_doclava-73934887ea87fca353449f0fd476d6c07b349521.tar.bz2
platform_external_doclava-73934887ea87fca353449f0fd476d6c07b349521.zip
Fix doclava to preserve annotations on fields and methods
The android.jar stubs file used in the SDK was missing @Deprecated annotations on methods and fields. This changeset updates doclava to write annotations on methods and fields as well, and to also add a @Deprecated annotation for APIs that were marked deprecated but missing an annotation (presumably because they only used the @deprecated doc comment; there are about 30 such APIs out of 800+ deprecation usages.) This fixes http://code.google.com/p/android/issues/detail?id=26173 Change-Id: Iad675d4cfdf650165bfb7050cdcc0978c3a72d55
Diffstat (limited to 'android-changes.txt')
-rw-r--r--android-changes.txt12
1 files changed, 12 insertions, 0 deletions
diff --git a/android-changes.txt b/android-changes.txt
new file mode 100644
index 0000000..025bcd8
--- /dev/null
+++ b/android-changes.txt
@@ -0,0 +1,12 @@
+Changes in this version relative to http://doclava.googlecode.com/
+------------------------------------------------------------------
+
+* Modified the Java stub generator code to write out annotations for
+ methods and fields as well, not just classes. This meant adding a
+ writeAnnotations call to writeMethod and to writeField
+
+* Modified the writeAnnotations method to take a "isDeprecated"
+ parameter, which when set adds a @Deprecated annotation if one
+ doesn't already exist. This ensures that APIs only marked with a
+ @deprecated documentation comment will also be marked as
+ @Deprecated. Also strips out @Override annotations.