better descriptions for accepts method and helper

mojolicious · Jan 29, 2014 · 93165cf · 93165cf
1 parent 4f6e1e3
commit 93165cf
Show file tree

Hide file tree

Showing 3 changed files with 4 additions and 7 deletions.
diff --git a/lib/Mojolicious/Guides/Rendering.pod b/lib/Mojolicious/Guides/Rendering.pod
@@ -367,7 +367,7 @@ used or an empty C<204> response rendered automatically.
   }
 
 For even more advanced negotiation logic you can also use the helper
-L<Mojolicious::DefaultHelpers/"accepts"> directly.
+L<Mojolicious::DefaultHelpers/"accepts">.
 
 =head2 Rendering C<exception> and C<not_found> pages
 

diff --git a/lib/Mojolicious/Plugin/DefaultHelpers.pm b/lib/Mojolicious/Plugin/DefaultHelpers.pm
@@ -129,15 +129,12 @@ L<Mojolicious::Plugin::DefaultHelpers> implements the following helpers.
 =head2 accepts
 
   %= accepts->[0] // 'html'
-  %= accepts('html', 'json', 'txt')
+  %= accepts('html', 'json', 'txt') // 'html'
 
 Select best possible representation for resource from C<Accept> request
 header, C<format> stash value or C<format> GET/POST parameter with
 L<Mojolicious::Types/"accepts">, defaults to returning the first extension if
-no preference could be detected. 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>.
+no preference could be detected.
 
   return $self->render(json => {hello => 'world'}) if $self->accepts('json');
 

diff --git a/lib/Mojolicious/Types.pm b/lib/Mojolicious/Types.pm
@@ -153,7 +153,7 @@ the following new ones.
 
 Select best possible representation for resource from C<Accept> request
 header, C<format> stash value or C<format> GET/POST parameter, defaults to
-returning the first extension if no preference could be detected.. Since
+returning the first extension if no preference could be detected. 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>.