diff --git a/core/includes/bootstrap.inc b/core/includes/bootstrap.inc
index 9e2c875..8454b53 100644
--- a/core/includes/bootstrap.inc
+++ b/core/includes/bootstrap.inc
@@ -1971,9 +1971,29 @@ function drupal_anonymous_user() {
  * automatically runs the earlier phases as well. To access the Drupal
  * database from a script without loading anything else, include bootstrap.inc
  * and call drupal_bootstrap(DRUPAL_BOOTSTRAP_DATABASE).
+ * 
+ * In order to bootstrap Drupal from another PHP script, you can use this code:
+ * @code
+ *   define('DRUPAL_ROOT', '/path/to/drupal');
+ *   require_once DRUPAL_ROOT . '/includes/bootstrap.inc';
+ *   drupal_boostrap(DRUPAL_BOOTSTRAP_FULL);
+ * @endcode
+ * In this example the Drupal installation to bootstrap is located at 
+ * '/path/to/drupal'. If you only want to bootstrap the Drupal database you can
+ * use DRUPAL_BOOTSTRAP_DATABASE instead of DRUPAL_BOOTSTRAP_FULL. For a full
+ * description of the different bootstrap levels see the $phase argument below.
  *
  * @param $phase
- *   A constant. Allowed values are the DRUPAL_BOOTSTRAP_* constants.
+ *   A Drupal bootstrap constant. The possible bootstrap levels are:
+ *   - DRUPAL_BOOTSTRAP_CONFIGURATION: Initializes configuration.
+ *   - DRUPAL_BOOTSTRAP_PAGE_CACHE: Tries to server a cached page.
+ *   - DRUPAL_BOOTSTRAP_DATABASE: Initializes the database layer.
+ *   - DRUPAL_BOOTSTRAP_VARIABLES: Initializes the variable system.
+ *   - DRUPAL_BOOTSTRAP_SESSION: Initializes session handling.
+ *   - DRUPAL_BOOTSTRAP_PAGE_HEADER: Sets up the page header.
+ *   - DRUPAL_BOOTSTRAP_LANGUAGE: Finds out the language of the page.
+ *   - DRUPAL_BOOTSTRAP_FULL: Fully loads Drupal. Validates and fixes input
+ *   data.
  * @param $new_phase
  *   A boolean, set to FALSE if calling drupal_bootstrap from inside a
  *   function called from drupal_bootstrap (recursion).