@@ -19,14 +19,44 @@
 import android.content.Intent;
 import android.os.Bundle;
 
+/**
+ * Base class for generated {@link android.app.Activity Activity} {@link Intent}
+ * builders, which provide a fluent API to build {@link Intent}s and start the
+ * generated {@link android.app.Activity Activity}.
+ *
+ * @param <I>
+ *            The actual class, so method chain can return the generated class
+ *            and provide generated methods
+ */
 public abstract class ActivityIntentBuilder<I extends ActivityIntentBuilder<I>> extends IntentBuilder<I> implements ActivityStarter {
 
 	protected Bundle lastOptions;
 
+	/**
+	 * Creates a builder for a given {@link android.app.Activity Activity}
+	 * class.
+	 * 
+	 * @param context
+	 *            A {@link Context} of the application package implementing this
+	 *            class.
+	 * @param clazz
+	 *            The component class that is to be used for the {@link Intent}.
+	 */
 	public ActivityIntentBuilder(Context context, Class<?> clazz) {
 		super(context, clazz);
 	}
 
+	/**
+	 * Creates a builder which will append to a previously created
+	 * {@link android.content.Intent Intent}.
+	 * 
+	 * @param context
+	 *            A {@link Context} of the application package implementing this
+	 *            class.
+	 * @param intent
+	 *            The previously created {@link Intent} to append to.
+	 * 
+	 */
 	public ActivityIntentBuilder(Context context, Intent intent) {
 		super(context, intent);
 	}
@@ -39,6 +69,13 @@ public final void start() {
 	@Override
 	public abstract void startForResult(int requestCode);
 
+	/**
+	 * Adds additional options {@link Bundle} to the start method.
+	 * 
+	 * @param options
+	 *            the {@link android.app.Activity Activity} options
+	 * @return an {@link ActivityStarter} instance to provide starter methods
+	 */
 	public ActivityStarter withOptions(Bundle options) {
 		lastOptions = options;
 		return this;
 
@@ -1,8 +1,33 @@
 package org.androidannotations.api.builder;
 
+/**
+ * Provides methods for starting an {@link android.app.Activity Activity}.
+ */
 public interface ActivityStarter {
 
+	/**
+	 * Starts the {@link android.app.Activity Activity}, by calling
+	 * {@link android.app.Activity#startActivity(android.content.Intent)
+	 * Activity#startActivity(android.content.Intent)} for the previously given
+	 * {@link android.content.Context Context} or Fragment or support Fragment
+	 * objects. It also passes the given extras, the options
+	 * {@link android.os.Bundle Bundle}, if new methods are available which
+	 * accept that.
+	 */
 	void start();
 
+	/**
+	 * Starts the {@link android.app.Activity Activity} for result, by calling
+	 * {@link android.app.Activity#startActivityForResult(android.content.Intent, int)
+	 * Activity#startActivityForResult(android.content.Intent, int)} for the
+	 * previously given {@link android.content.Context Context} or Fragment or
+	 * support Fragment objects. It also passes the given extras, the options
+	 * {@link android.os.Bundle Bundle}, if new methods are available which
+	 * accept that.
+	 * 
+	 * @param requestCode
+	 *            this code will be returned in onActivityResult() when the
+	 *            activity exits.
+	 */
 	void startForResult(int requestCode);
 }
@@ -15,5 +15,8 @@
  */
 package org.androidannotations.api.builder;
 
+/**
+ * Base class for fluent builders.
+ */
 public abstract class Builder {
 }
Original file line number	Diff line number	Diff line change
`@@ -15,5 +15,8 @@`
`15`	`15`	`*/`
`16`	`16`	`package org.androidannotations.api.builder;`
`17`	`17`
	`18`	`+/**`
	`19`	`+ * Base class for fluent builders.`
	`20`	`+ */`
`18`	`21`	`public abstract class Builder {`
`19`	`22`	`}`