From 1e35563a537b4adfc8fe304382ca4593703e1a0e Mon Sep 17 00:00:00 2001 From: Father Chrysostomos Date: Thu, 1 Mar 2012 12:32:25 -0800 Subject: attributes.pm: Consistent spaces after dots in pod --- ext/attributes/attributes.pm | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/ext/attributes/attributes.pm b/ext/attributes/attributes.pm index e13bbb87de..1f6dbae7c8 100644 --- a/ext/attributes/attributes.pm +++ b/ext/attributes/attributes.pm @@ -199,8 +199,9 @@ So you want to know what C actually does? First of all C gets the type of the third parameter ('CODE' in this case). C checks if there is a subroutine called C<< MODIFY__ATTRIBUTES >> -in the caller's namespace (here: 'main'). In this case a subroutine C is -required. Then this method is called to check if you have used a "bad attribute". +in the caller's namespace (here: 'main'). In this case a +subroutine C is required. Then this +method is called to check if you have used a "bad attribute". The subroutine call in this example would look like MODIFY_CODE_ATTRIBUTES( 'main', \&foo, 'method' ); @@ -219,7 +220,7 @@ The following are the built-in attributes for subroutines: =item lvalue Indicates that the referenced subroutine is a valid lvalue and can -be assigned to. The subroutine must return a modifiable value such +be assigned to. The subroutine must return a modifiable value such as a scalar variable, as described in L. This module allows one to set this attribute on a subroutine that is @@ -233,12 +234,14 @@ what you are doing. You have been warned. =item method -Indicates that the referenced subroutine is a method. A subroutine so marked +Indicates that the referenced subroutine +is a method. A subroutine so marked will not trigger the "Ambiguous call resolved as CORE::%s" warning. =item locked -The "locked" attribute has no effect in 5.10.0 and later. It was used as part +The "locked" attribute has no effect in +5.10.0 and later. It was used as part of the now-removed "Perl 5.005 threads". =back @@ -488,7 +491,8 @@ not your own. print "foo\n"; } -This example runs. At compile time C is called. In that +This example runs. At compile time +C is called. In that subroutine, we check if any attribute is disallowed and we return a list of these "bad attributes". @@ -510,7 +514,8 @@ As we return an empty list, everything is fine. } This example is aborted at compile time as we use the attribute "Test" which -isn't allowed. C returns a list that contains a single +isn't allowed. C +returns a list that contains a single element ('Test'). =back -- cgit v1.2.1