documentation tweaks

mojolicious · Dec 14, 2012 · 2a0bfb7 · 2a0bfb7
1 parent 0c38458
commit 2a0bfb7
Show file tree

Hide file tree

Showing 3 changed files with 7 additions and 6 deletions.
diff --git a/Changes b/Changes
@@ -3,6 +3,7 @@
   - Added support for MIME type prioritization to Mojolicious::Types.
   - Improved respond_to to prioritize multiple MIME types if the
     X-Requested-With header is set to the value "XMLHttpRequest".
+  - Improved documentation.
 
 3.66  2012-12-14
   - Added request_ok method to Test::Mojo.

diff --git a/lib/Mojolicious/Controller.pm b/lib/Mojolicious/Controller.pm
@@ -788,10 +788,10 @@ Get L<Mojo::Message::Response> object from L<Mojo::Transaction/"res">.
 
 Automatically select best possible representation for resource from C<Accept>
 request header, C<format> stash value or C<format> GET/POST parameter,
-defaults to rendering an empty C<204> response. Unspecific C<Accept> request
-headers that contain more than one MIME type are currently ignored, unless the
-C<X-Requested-With> header is set to the value C<XMLHttpRequest>, since
-browsers often don't really know what they actually want.
+defaults to rendering an empty C<204> response. Since browsers often don't
+really know what they actually want, unspecific C<Accept> request headers with
+more than one MIME type will be ignored, unless the C<X-Requested-With> header
+is set to the value C<XMLHttpRequest>.
 
   $c->respond_to(
     json => sub { $c->render_json({just => 'works'}) },

diff --git a/lib/Mojolicious/Types.pm b/lib/Mojolicious/Types.pm
@@ -135,8 +135,8 @@ the following ones.
 Detect file extensions from C<Accept> header value, prioritization of
 unspecific values that contain more than one MIME type is disabled by default.
 
-  # List detected extensions
-  say for @{$types->detect('application/json')};
+  # List detected extensions prioritized
+  say for @{$types->detect('application/json, text/xml;q=0.1', 1)};
 
 =head2 C<type>