long =item
Robin Barker [Thu, 7 Jun 2001 12:34:08 +0000 (13:34 +0100)]
Message-Id: <200106071134.MAA10288@tempest.npl.co.uk>

p4raw-id: //depot/perl@10469

README.amiga
lib/Attribute/Handlers.pm
lib/ExtUtils/Constant.pm
lib/Locale/Maketext.pod

index b59f535..709fcc8 100644 (file)
@@ -103,14 +103,22 @@ deficiencies in the UNIX-emulation, most notably:
 
 =over 6
 
-=item fork()
+=item *
 
-=item some features of the UNIX filesystem regarding link count and file dates
+fork()
 
-=item inplace operation (the -i switch) without backup file
+=item * 
 
-=item umask() works, but the correct permissions are only set when the file is
-      finally close()d
+some features of the UNIX filesystem regarding link count and file dates
+
+=item *
+
+inplace operation (the -i switch) without backup file
+
+=item *
+
+umask() works, but the correct permissions are only set when the file is
+finally close()d
 
 =back
 
index 96d4f68..a0a57fe 100644 (file)
@@ -596,27 +596,35 @@ Let's you write:
 
 =over
 
-=item C<Bad attribute type: ATTR(%s)>
+=item *
+
+C<Bad attribute type: ATTR(%s)>
 
 An attribute handler was specified with an C<:ATTR(I<ref_type>)>, but the
 type of referent it was defined to handle wasn't one of the five permitted:
 C<SCALAR>, C<ARRAY>, C<HASH>, C<CODE>, or C<ANY>.
 
-=item C<Attribute handler %s doesn't handle %s attributes>
+=item *
+
+ C<Attribute handler %s doesn't handle %s attributes>
 
 A handler for attributes of the specified name I<was> defined, but not
 for the specified type of declaration. Typically encountered whe trying
 to apply a C<VAR> attribute handler to a subroutine, or a C<SCALAR>
 attribute handler to some other type of variable.
 
-=item C<Declaration of %s attribute in package %s may clash with future reserved word>
+=item *
+
+C<Declaration of %s attribute in package %s may clash with future reserved word>
 
 A handler for an attributes with an all-lowercase name was declared. An
 attribute with an all-lowercase name might have a meaning to Perl
 itself some day, even though most don't yet. Use a mixed-case attribute
 name, instead.
 
-=item C<Internal error: %s symbol went missing>
+=item *
+
+C<Internal error: %s symbol went missing>
 
 Something is rotten in the state of the program. An attributed
 subroutine ceased to exist between the point it was declared and the end
index 7bdf585..4efccfe 100644 (file)
@@ -294,7 +294,9 @@ sub params {
   return ($use_iv, $use_nv, $use_pv);
 }
 
-=item dump_names  PACKAGE, SUBNAME, DEFAULT_TYPE, TYPES, INDENT, ITEM...
+=item dump_names  
+
+dump_names  PACKAGE, SUBNAME, DEFAULT_TYPE, TYPES, INDENT, ITEM...
 
 An internal function to generate the embedded perl code that will regenerate
 the constant subroutines.  Parameters are the same as for C_constant, except
@@ -404,7 +406,9 @@ __END__
   $result;
 }
 
-=item C_constant PACKAGE, SUBNAME, DEFAULT_TYPE, TYPES, INDENT, NAMELEN, ITEM...
+=item C_constant 
+
+C_constant PACKAGE, SUBNAME, DEFAULT_TYPE, TYPES, INDENT, NAMELEN, ITEM...
 
 A function that returns a B<list> of C subroutine definitions that return
 the value and type of constants when passed the name by the XS wrapper.
index b28a9d8..d32f9d5 100644 (file)
@@ -110,7 +110,9 @@ These are to do with constructing a language handle:
 
 =over
 
-=item $lh = YourProjClass->get_handle( ...langtags... ) || die "lg-handle?";
+=item *
+
+$lh = YourProjClass->get_handle( ...langtags... ) || die "lg-handle?";
 
 This tries loading classes based on the language-tags you give (like
 C<("en-US", "sk", "kon", "es-MX", "ja", "i-klingon")>, and for the first class
@@ -131,7 +133,9 @@ then if nothing comes of that, we use classes named by
 YourProjClass->fallback_language_classes().  Then in the (probably
 quite unlikely) event that that fails, we just return undef.
 
-=item $lh = YourProjClass->get_handleB<()> || die "lg-handle?";
+=item * 
+
+$lh = YourProjClass->get_handleB<()> || die "lg-handle?";
 
 When C<get_handle> is called with an empty parameter list, magic happens: