Added doclet and changed comments in PApplet.java

Author: Anadroid

core/src/processing/core/PApplet.java

@@ -0,0 +1,26 @@
+Writing a custom doclet. The problem is including a custom jar (for json). 
+
+I'm running ant in the command line (ant compile) to build the doclet first and there are 2 options for running the doclet. 
+
+1. by running the processingrefBuild.sh 
+
+	```
+	./processingrefBuild.sh 
+	```
+
+	this gives "javadoc: error - In doclet class ProcessingWeblet,  method start has thrown an exception java.lang.reflect.InvocationTargetException
+	java.lang.NoClassDefFoundError: org/json/JSONObject..." which I think means that the json jar needs to be included in the classpath also when running the javadoc comamand in the processingrefBuild.sh and I tried adding -classpath lib/ to the javadoc command and adding the lib to CLASSPATH in the terminal but didn't work. But maybe something else is a problem and not adding the lib to the classpath (this post https://javarevisited.blogspot.com/2011/06/noclassdeffounderror-exception-in.html has a bunch of reasons why this might be happening but nothing seems to be applicable or i tried it in a wrong way). 
+
+2. through ant by running the command 
+
+	```
+	ant rundoc
+	```
+
+	this gives an error "javadoc: error - invalid flag: -d" so I'm guessing that the javadoc and doclet is not written correctly. If I remove the destdir from the javadoc tag it "works" in a sense that it doesn't give the flag error but then obviously there is no destdir so nothing happens 
+
+	(this would also be the prefered option to do this in order to have everything in one place)
+
+
+Additional info:
+- Using JAVA 1.8 and Ant 1.10.8

doclet/README.md

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="src" path="src"/>
+	<classpathentry kind="src" path="Tools"/>
+	<classpathentry exported="true" kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
+	<classpathentry exported="true" kind="lib" path="lib/org.json.jar"/>
+	<classpathentry kind="lib" path="Tools/tools.jar"/>
+	<classpathentry kind="output" path="bin"/>
+</classpath>

doclet/ReferenceGenerator/.classpath

@@ -0,0 +1,3 @@
+JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_202.jdk/Contents/Home/
+export JAVA_HOME;
+

doclet/ReferenceGenerator/.profile

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>ReferenceGenerator</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+	</natures>
+	<linkedResources>
+		<link>
+			<name>Tools</name>
+			<type>2</type>
+			<location>/Library/Java/JavaVirtualMachines/jdk1.8.0_202.jdk/Contents/Home/lib</location>
+		</link>
+	</linkedResources>
+</projectDescription>

doclet/ReferenceGenerator/.project

@@ -0,0 +1,12 @@
+#Wed Sep 12 09:51:20 EDT 2012
+eclipse.preferences.version=1
+org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode=enabled
+org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.6
+org.eclipse.jdt.core.compiler.codegen.unusedLocal=preserve
+org.eclipse.jdt.core.compiler.compliance=1.6
+org.eclipse.jdt.core.compiler.debug.lineNumber=generate
+org.eclipse.jdt.core.compiler.debug.localVariable=generate
+org.eclipse.jdt.core.compiler.debug.sourceFile=generate
+org.eclipse.jdt.core.compiler.problem.assertIdentifier=error
+org.eclipse.jdt.core.compiler.problem.enumIdentifier=error
+org.eclipse.jdt.core.compiler.source=1.6

doclet/ReferenceGenerator/.settings/org.eclipse.jdt.core.prefs

@@ -0,0 +1,32 @@
+#!/bin/sh
+#remove everything old
+rm -rf ../tmp
+#generate everything anew
+javadoc -doclet ProcessingWeblet -docletpath bin/ -public \
+	-webref ../tmp/web-android \
+	-localref ../tmp/local-android \
+	-includeXMLTag android \
+	-templatedir ../templates \
+	-examplesdir ../api_examples \
+	-includedir ../api_examples/include \
+	-imagedir images \
+	-corepackage processing.xml \
+	-rootclass PGraphics \
+	-rootclass PConstants \
+    ../../../processing/android/core/src/processing/android/core/*.java \
+	../../../processing/android/core/src/processing/android/xml/*.java \
+    ../../../processing/net/src/processing/net/*.java \
+	../../../processing/serial/src/processing/serial/*.java
+    # ../../../processing/video/src/processing/video/*.java \
+
+#copy over the css and sample images
+cp -r ../../css	 ../tmp/web-android
+cp -r ../../css	 ../tmp/local-android
+mkdir ../tmp/web-android/images
+mkdir ../tmp/local-android/images
+cp -r ../../content/api_media/*.jpg ../tmp/web-android/images/
+cp -r ../../content/api_media/*.gif ../tmp/web-android/images/
+cp -r ../../content/api_media/*.png ../tmp/web-android/images/
+cp -r ../../content/api_media/*.jpg ../tmp/local-android/images/
+cp -r ../../content/api_media/*.gif ../tmp/local-android/images/
+cp -r ../../content/api_media/*.png ../tmp/local-android/images/