more work on docs
John Napiorkowski [Thu, 26 Mar 2015 01:27:25 +0000 (20:27 -0500)]
Changes
lib/Catalyst/Delta.pod
t/arg_constraints.t

diff --git a/Changes b/Changes
index e1eaea0..3bcb925 100644 (file)
--- a/Changes
+++ b/Changes
@@ -4,7 +4,11 @@
   - New Feature: Type Constraints on Args/CapturArgs.  ALlows you to declare
     a Moose, MooseX::Types or Type::Tiny named constraint on your Arg or 
     CaptureArg.
-  - New top level document on Route matching. (Catalyst::RouteMatching).
+  - When using $c->uri_for (or the derived $c->uri_for_action) and the target
+    action has type constrainted args (or captures), verify that the proposed
+    URL matches the defined args.
+  - New top level document on Route matching. (Catalyst::RouteMatching).  This
+    document is still in development, but is worth review and comments, please!
 
 5.90085 - 2015-03-25
   - Small change to Catalyst::Action to prevent autovivication of Args value (dim1++)
index 0f0d4f2..f480a87 100755 (executable)
@@ -7,6 +7,23 @@ Catalyst::Delta - Overview of changes between versions of Catalyst
 This is an overview of the user-visible changes to Catalyst between major
 Catalyst releases.
 
+=head2 VERSION 5.90090+
+
+=head2 Type constraints on Args and CaptureArgs.
+
+You may now use a type constraint (using L<Moose>, L<MooseX::Types> or preferably
+L<Type::Tiny) in your Args or CaptureArgs action attributes.  This can be used
+to restrict the value of the Arg.  For example:
+
+    sub myaction :Local Args(Int) { ... }
+
+Would match '.../myaction/5' but not '.../myaction/string'.
+
+When an action (or action chain) has Args (or CaptureArgs) that declare type constraints
+your arguments to $c->uri_for(...) must match those constraints.
+
+See L<Catalyst::RouteMatching> for more.
+
 =head2 VERSION 5.90080+
 
 The biggest change in this release is that UTF8 encoding is now enabled by
index 8d74aa8..505d069 100644 (file)
@@ -362,10 +362,6 @@ SKIP: {
 
 =cut
 
-
-done_testing;
-
-__END__
 {
   # URI testing
   my ($res, $c) = ctx_request '/';
@@ -376,3 +372,8 @@ __END__
   warn $url2;
 }
 
+done_testing;
+
+__END__
+
+