Made major improvements to the project's Javadoc:

- Disabled warnings for non-standard tags used in blockslib.
- Modified in-line Javadoc to eliminate errors.
- Set up links to external Android documentation.

appinventor/appengine/src/com/google/appinventor/server/util/BuildData.java

@@ -11,8 +11,6 @@ import java.util.Date;
  * Return timestamp information for when this server was last deployed
  *
  * @author sharon@google.com (Sharon Perl)
- *
- * @see com.google.appinventor.common.version.MercurialBuildId
  */
 public class BuildData {
 

appinventor/build.xml

@@ -80,12 +80,27 @@
         <!-- app engine libs -->
         <pathelement location="lib/appengine/appengine-java-sdk-1.6.2.1/lib/user/appengine-api-1.0-sdk-1.6.2.1.jar"/>
         <pathelement location="lib/appengine/appengine-java-sdk-1.6.2.1/lib/user/orm/geronimo-jpa_3.0_spec-1.1.1.jar"/>
+	<!-- prevent error importing MercurialBuildId if it has been generated -->
+        <pathelement location="common/build/classes/CommonVersion" />
       </classpath>
-      <link href="http://download.oracle.com/javase/6/docs/api/"/>
-      <link href="http://google-web-toolkit.googlecode.com/svn/javadoc/2.3/"/>
+      <!-- Ignore non-standard tags used in blockslib.  -->
+      <tag name="assumptions" />
+      <tag name="effect" />
+      <tag name="effects" />
+      <tag name="expects" />
+      <tag name="modifies" />
+      <tag name="override" />
+      <tag name="requires" />
+      <tag name="specfield" />
+      <tag name="warning" />
       <!-- TODO(opensource) - Add more <link> elements that correspond to the jars on the
            classpath above,so our javadoc will link appropriate online javadoc for libraries we
            depend on. -->
+      <link href="http://download.oracle.com/javase/6/docs/api/"/>
+      <link href="http://google-web-toolkit.googlecode.com/svn/javadoc/2.3/"/>
+      <link href="http://d.android.com/reference"
+	    offline="true"
+	    packagelistLoc="lib/android"/>
     </javadoc>
   </target>
 

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

@@ -61,9 +61,7 @@ import java.util.List;
  * To the user, the first three layers are all the background, in terms
  * of the behavior of {@link #SetBackgroundPixelColor(int,int,int)} and
  * {@link #GetBackgroundPixelColor(int,int)}.  For historical reasons,
- * changing the background color or image clears the drawing layer
- * (@link #clearDrawingLayer()}.
- *
+ * changing the background color or image clears the drawing layer.
  */
 @DesignerComponent(version = YaVersion.CANVAS_COMPONENT_VERSION,
     description = "<p>A two-dimensional touch-sensitive rectangular panel on " +

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

@@ -727,7 +727,7 @@ public class Form extends Activity
    * Display a new form and pass a startup value to the new form.
    *
    * @param nextFormName the name of the new form to display
-   * @param startupValue the startup value to pass to the new form
+   * @param startValue the start value to pass to the new form
    */
   // This is called from runtime.scm when a "open another screen with start value" block is
   // executed.  Note that startNewForm will JSON encode the start value

appinventor/components/src/com/google/appinventor/components/runtime/util/BluetoothReflection.java

@@ -6,6 +6,7 @@ package com.google.appinventor.components.runtime.util;
 import android.bluetooth.BluetoothAdapter;
 import android.bluetooth.BluetoothClass;
 import android.bluetooth.BluetoothDevice;
+import android.bluetooth.BluetoothServerSocket;
 import android.bluetooth.BluetoothSocket;
 
 import java.io.IOException;
@@ -124,7 +125,7 @@ public class BluetoothReflection {
 
   /**
    * Invokes the method
-   * {@link android.bluetooth.BluetoothAdapter#listenUsingInsecureRfcommWithServiceRecord(String,UUID)}.
+   * {@link android.bluetooth.BluetoothAdapter#listenUsingInsecureRfcommWithServiceRecord(String, UUID)}.
    *
    * @param bluetoothAdapter a {@link android.bluetooth.BluetoothAdapter} object
    * @param name  service name for SDP record

appinventor/lib/android/README

+It was necessary to create a local copy of the Android package list because it
+is not accessible in the ordinary location
+(http://d.android.com/reference/package-list).  The file package-list was
+downloaded from "http://libs-for-android.googlecode.com/git-history/45f08023b849769aee6c0560ab70f2ceff6b9996/docs/android/package-list".
+It is not in the 2.2 subdirectory because I believe it is for a later version
+of Android.

appinventor/lib/android/package-list

+android
+android.accessibilityservice
+android.accounts
+android.animation
+android.app
+android.app.admin
+android.app.backup
+android.appwidget
+android.bluetooth
+android.content
+android.content.pm
+android.content.res
+android.database
+android.database.sqlite
+android.drm
+android.gesture
+android.graphics
+android.graphics.drawable
+android.graphics.drawable.shapes
+android.hardware
+android.hardware.usb
+android.inputmethodservice
+android.location
+android.media
+android.media.audiofx
+android.media.effect
+android.mtp
+android.net
+android.net.http
+android.net.rtp
+android.net.sip
+android.net.wifi
+android.net.wifi.p2p
+android.nfc
+android.nfc.tech
+android.opengl
+android.os
+android.os.storage
+android.
+android.provider
+android.renderscript
+android.sax
+android.security
+android.service.textservice
+android.service.wallpaper
+android.speech
+android.speech.tts
+android.support.v13.app
+android.support.v4.accessibilityservice
+android.support.v4.app
+android.support.v4.content
+android.support.v4.content.pm
+android.support.v4.database
+android.support.v4.os
+android.support.v4.util
+android.support.v4.view
+android.support.v4.view.accessibility
+android.support.v4.widget
+android.telephony
+android.telephony.cdma
+android.telephony.gsm
+android.test
+android.test.mock
+android.test.suitebuilder
+android.test.suitebuilder.annotation
+android.text
+android.text.format
+android.text.method
+android.text.style
+android.text.util
+android.util
+android.view
+android.view.accessibility
+android.view.animation
+android.view.inputmethod
+android.view.textservice
+android.webkit
+android.widget
+dalvik.annotation
+dalvik.bytecode
+dalvik.system
+java.awt.font
+java.beans
+java.io
+java.lang
+java.lang.annotation
+java.lang.ref
+java.lang.reflect
+java.math
+java.net
+java.nio
+java.nio.channels
+java.nio.channels.spi
+java.nio.charset
+java.nio.charset.spi
+java.security
+java.security.acl
+java.security.cert
+java.security.interfaces
+java.security.spec
+java.sql
+java.text
+java.util
+java.util.concurrent
+java.util.concurrent.atomic
+java.util.concurrent.locks
+java.util.jar
+java.util.logging
+java.util.prefs
+java.util.regex
+java.util.zip
+javax.crypto
+javax.crypto.interfaces
+javax.crypto.spec
+javax.microedition.khronos.egl
+javax.microedition.khronos.opengles
+javax.net
+javax.net.ssl
+javax.security.auth
+javax.security.auth.callback
+javax.security.auth.login
+javax.security.auth.x500
+javax.security.cert
+javax.sql
+javax.xml
+javax.xml.datatype
+javax.xml.namespace
+javax.xml.parsers
+javax.xml.transform
+javax.xml.transform.dom
+javax.xml.transform.sax
+javax.xml.transform.stream
+javax.xml.validation
+javax.xml.xpath
+junit.framework
+junit.runner
+org.apache.http
+org.apache.http.auth
+org.apache.http.auth.params
+org.apache.http.client
+org.apache.http.client.entity
+org.apache.http.client.methods
+org.apache.http.client.params
+org.apache.http.client.protocol
+org.apache.http.client.utils
+org.apache.http.conn
+org.apache.http.conn.params
+org.apache.http.conn.routing
+org.apache.http.conn.scheme
+org.apache.http.conn.ssl
+org.apache.http.conn.util
+org.apache.http.cookie
+org.apache.http.cookie.params
+org.apache.http.entity
+org.apache.http.impl
+org.apache.http.impl.auth
+org.apache.http.impl.client
+org.apache.http.impl.conn
+org.apache.http.impl.conn.tsccm
+org.apache.http.impl.cookie
+org.apache.http.impl.entity
+org.apache.http.impl.io
+org.apache.http.io
+org.apache.http.message
+org.apache.http.params
+org.apache.http.protocol
+org.apache.http.util
+org.json
+org.w3c.dom
+org.w3c.dom.ls
+org.xml.sax
+org.xml.sax.ext
+org.xml.sax.helpers
+org.xmlpull.v1
+org.xmlpull.v1.sax2