Format and document.

- Format example indentation.
- Document null return type when negotiating fails.
- Fix example.

g11n/Locale.php

@@ -62,8 +62,8 @@ class Locale extends \lithium\core\StaticObject {
 	 * methods to parse and retrieve individual tags from a locale.
 	 *
 	 * ```
-	 *     Locale::language('en_US'); // returns 'en'
-	 *     Locale::territory('en_US'); // returns 'US'
+	 * Locale::language('en_US'); // returns 'en'
+	 * Locale::territory('en_US'); // returns 'US'
 	 * ```
 	 *
 	 * @see lithium\g11n\Locale::$_tags

net/http/Media.php

@@ -176,7 +176,7 @@ public static function to($format, $data, array $options = array()) {
 	 *   use the same template(s) or other settings. Therefore, when serving JSONP content, you
 	 *   can specify that the extension defined in the type must be present in the URL:
 	 *  ```
-	 *  Media::type('jsonp', array('text/html'), array(
+	 *  Media::type('jsonp', array('application/json'), array(
 	 *  	// template settings...
 	 *  	'conditions' => array('type' => true)
 	 *  ));
@@ -286,7 +286,8 @@ public static function type($type, $content = null, array $options = array()) {
 	 * @see lithium\action\Request
 	 * @param \lithium\action\Request $request The request which contains the details of
 	 *        the request to be content-negotiated.
-	 * @return string Returns the first matching type name, i.e. `'html'` or `'json'`.
+	 * @return string|null Returns the first matching type name, i.e. `'html'` or `'json'`. When
+	 *         no matching type is found returns `null`.
 	 */
 	public static function negotiate($request) {
 		$self = get_called_class();
@@ -851,6 +852,7 @@ protected static function _handle($handler, $data, &$response) {
 	 * Helper method for listing registered media types. Returns all types, or a single
 	 * content type if a specific type is specified.
 	 *
+	 * @todo Use fnmatch() to support wildcards.
 	 * @param string $type Type to return.
 	 * @return mixed Array of types, or single type requested.
 	 */