Improve documentation of drupal_get_schema() and drupal_get_schema_unprocessed()

1. +++ b/includes/bootstrap.inc
   @@ -2954,10 +2954,15 @@ function ip_address() {
     * The returned schema will include any modifications made by any
     * module that implements hook_schema_alter().
     *
   + * To retrieve the raw schema as defined by the module use
   + * drupal_get_schema_unprocessed() instead.
   + *
   

   These two sentences are so closely related they should follow one another immediately (No paragraph break.)

   In the added sentence, "the module" is ambiguous. (What module?) And as I'm unable to find any other reference in the codebase to a schema as "raw", I would propose alternative language. Perhaps something like, "To get the schema without modifications, use drupal_get_schema_unprocessed()."

2. +++ b/includes/bootstrap.inc
   @@ -2954,10 +2954,15 @@ function ip_address() {
   + *
   + * @see drupal_get_schema_unprocessed()
   

   Since you're already mentioning the function above with explanation, it's probably not necessary to also add an @see reference.

3. +++ b/includes/common.inc
   @@ -7099,6 +7099,8 @@ function drupal_uninstall_schema($module) {
   + *
   + * @see drupal_get_schema()
   

   This could use an explanation parallel to the one proposed for drupal_get_schema_unprocessed() above in drupal_get_schema(). I would remove the @see reference and add a sentence at the end of the second paragraph: "...and these unprocessed definitions won't be cached."

Looks good!

+1, thanks! Quick note: these functions do not exist, apparently, in Drupal8.

Committed to 7.x - thanks!

In Drupal 8 this has been renamed to drupal_get_module_schema() and slightly changed (see https://www.drupal.org/node/2467521) but since there's only one function there rather than two, this change would not be relevant for Drupal 8.