Utils doc patch from ningu

[catagits/Catalyst-Runtime.git] / lib / Catalyst / Utils.pm

diff --git a/lib/Catalyst/Utils.pm b/lib/Catalyst/Utils.pm
index c0eeefe..c3145d3 100644 (file)
--- a/lib/Catalyst/Utils.pm
+++ b/lib/Catalyst/Utils.pm
@@ -1,7 +1,6 @@
 package Catalyst::Utils;
 
 use strict;
-use attributes ();
 use Catalyst::Exception;
 use File::Spec;
 use HTTP::Request;
@@ -24,8 +23,6 @@ See L<Catalyst>.
 
 =item appprefix($class)
 
-Returns the application prefix for the class.
-
        MyApp::Foo becomes myapp_foo
 
 =cut
@@ -37,18 +34,8 @@ sub appprefix {
     return $class;
 }
 
-=item attrs($coderef)
-
-Returns attributes for coderef in a arrayref
-
-=cut
-
-sub attrs { attributes::get( $_[0] ) || [] }
-
 =item class2appclass($class);
 
-Returns the appclass for class.
-
     MyApp::C::Foo::Bar becomes MyApp
     My::App::C::Foo::Bar becomes My::App
 
@@ -65,8 +52,6 @@ sub class2appclass {
 
 =item class2classprefix($class);
 
-Returns the classprefix for class.
-
     MyApp::C::Foo::Bar becomes MyApp::C
     My::App::C::Foo::Bar becomes My::App::C
 
@@ -83,8 +68,6 @@ sub class2classprefix {
 
 =item class2classsuffix($class);
 
-Returns the classsuffix for class.
-
     MyApp::C::Foo::Bar becomes C::Foo::Bar
 
 =cut
@@ -113,9 +96,9 @@ sub class2env {
 
 =item class2prefix( $class, $case );
 
-Returns the prefix for class.
+Returns the uri prefix for a class. If case is false the prefix is converted to lowercase.
 
-    My::App::C::Foo::Bar becomes /foo/bar
+    My::App::C::Foo::Bar becomes foo/bar
 
 =cut
 
@@ -132,7 +115,7 @@ sub class2prefix {
 
 =item class2tempdir( $class [, $create ] );
 
-Returns a tempdir for class. If create is true it will try to create the path.
+Returns a tempdir for a class. If create is true it will try to create the path.
 
     My::App becomes /tmp/my/app
     My::App::C::Foo::Bar becomes /tmp/my/app/c/foo/bar
@@ -196,7 +179,7 @@ sub home {
 
 Returns a prefixed action.
 
-    MyApp::C::Foo::Bar, yada becomes /foo/bar/yada
+    MyApp::C::Foo::Bar, yada becomes foo/bar/yada
 
 =cut
 
@@ -207,28 +190,9 @@ sub prefix {
     return $name;
 }
 
-=item reflect_actions($class);
-
-Returns an arrayref containing all actions of a component class.
-
-=cut
-
-sub reflect_actions {
-    my $class   = shift;
-    my $actions = [];
-    eval '$actions = $class->_action_cache';
-
-    if ($@) {
-        Catalyst::Exception->throw( message =>
-              qq/Couldn't reflect actions of component "$class", "$@"/ );
-    }
-
-    return $actions;
-}
-
-=item request($request)
+=item request($uri)
 
-Returns a HTTP::Request object.
+Returns an L<HTTP::Request> object for a uri.
 
 =cut