diff --git a/CREDITS b/CREDITS index 255cbcf9..aeec8a6d 100644 --- a/CREDITS +++ b/CREDITS @@ -110,3 +110,6 @@ E: xsawyerx@cpan.org N: Paulo Custodio E: pscust@cpan.org + +N: Jean-Baptiste Mazon +E: ? diff --git a/sections/prototypes.pod b/sections/prototypes.pod index 0ceffb9b..a2d10176 100644 --- a/sections/prototypes.pod +++ b/sections/prototypes.pod @@ -44,20 +44,49 @@ array as a single unit so that C can operate on the array in place. X X -C takes the name of a function and returns a string representing its -prototype. If you cannot emulate that function (if it's a core keyword), -C will return C. To see the prototype of a built-in keyword, -use the C form: +The builtin C takes the name of a function and returns a string +representing its prototype.  To see the prototype of a built-in keyword, +use the C form: +  +=begin programlisting -=begin programlisting +    $ B +    \@@ +    $ B +    \% +    $ B +    *;$@ + +=end programlisting + +If you cannot emulate the prototype of a builtin (and some you can't!), +C will return C: + +=begin programlisting + +    $ B +    undef +    # You can't emulate builtin function C's calling convention. + +    $ B +    undef +    # Builtin function C has no prototype. +  +=end programlisting + +Look at C again: +  +=begin programlisting - $ B - \@@ +    $ B +    \@@ =end programlisting The C<@> character represents a list. The backslash forces the use of a -I to the corresponding argument. Thus C might be: +I to the corresponding argument. Thus this function takes a +reference to an array (because you can't take a reference to a list) and a list +of values. C might be: =begin programlisting diff --git a/sections/tie.pod b/sections/tie.pod index f72c7dea..198f678c 100644 --- a/sections/tie.pod +++ b/sections/tie.pod @@ -9,7 +9,7 @@ X Overloading (L) lets you give classes custom behavior for specific types of coercions and accesses. A similar mechanism exists for making variables act like built-in types (scalars, arrays, and hashes), but with more -specific behaviors. This mechanism uses the C keyword; it is C. +specific behaviors. This mechanism uses the C keyword; it is I. The original use of C was to produce a hash stored on disk, rather than in memory. This allowed the use of dbm files from Perl, as well as the ability to