Implement a generic string translation function that will allow contrib modules to integrate with translation modules

Adding the stable release blocker tag, as this is critical for i18n.

The attached patch implements the strategy mentioned in the OP. This would allow the translator module to integrate with i18n and look something like the code below:

/**
 * Implements hook_facetapi_translate_string().
 */
function MODULE_facetapi_translate_string($name, $string, array $options) {
  return i18n_string($name, $string, $options);
}

The major benefit of this implementation is that is eliminates the need for logic surrounding the i18n module in core Facet API and allows a translator contrib to have different release cycles.

Requires a hook_facetapi_translate_string() definition in facetapi.api.php.

Added the hook definition to facetapi.api.inc, made some other minor improvements.

Marking as "needs review".

Comment improvements.

Ugh. Removed stray dsm().

Please excuse typos in comments.

Posted against wrong issue.

Committed at http://drupalcode.org/project/facetapi.git/commit/c01873d.