Author: chromatic
Date: Fri Mar 30 22:37:45 2007
New Revision: 17873
Modified:
trunk/docs/pdds/pdd07_codingstd.pod
Changes in other areas also in this revision:
Modified:
trunk/ (props changed)
Log:
[EMAIL PROTECTED]: chromatic | 2007-03-30 22:37:22 -0700
Minor typo fixes, courtesy of Sartak.
Modified: trunk/docs/pdds/pdd07_codingstd.pod
==============================================================================
--- trunk/docs/pdds/pdd07_codingstd.pod (original)
+++ trunk/docs/pdds/pdd07_codingstd.pod Fri Mar 30 22:37:45 2007
@@ -368,7 +368,7 @@
=head3 Pass only C<unsigned char> to C<isxxx()> and C<toxxx()>
-Pass only values in the range of C<unsigend char> (and the special value -1,
+Pass only values in the range of C<unsigned char> (and the special value -1,
a.k.a. C<EOF>) to the isxxx() and toxxx() library functions. Passing signed
characters to these functions is a very common error and leads to incorrect
behavior at best and crashes at worst. And under most of the compilers Parrot
@@ -399,8 +399,8 @@
be modified.
Wango * const w = get_current_wango();
- w->min = 0;
- w->max = 14;
+ w->min = 0;
+ w->max = 14;
w->name = "Ted";
This prevents you from modifying C<w> inadvertantly.
@@ -562,7 +562,7 @@
=item foo.h
This contains all the declarations needed for external users of that API (and
-nothing more), ie it defines the API. It is permissible for the API to include
+nothing more), i.e. it defines the API. It is permissible for the API to
include
different or extra functionality when used by other parts of the core, compared
with its use in extensions and embeddings. In this case, the extra stuff within
the file is enabled by testing for the macro C<PERL_IN_CORE>.
@@ -714,10 +714,10 @@
=item *
A macro that may declare stuff and thus needs to be at the start of a block
-should be prefixed with C<DECL_>, e.g. C<DECL_SAVE_STACK>. Note that macros
which
-implicitly declare and then use variables are strongly discouraged, unless it
-is essential for portability or extensibility. The following are in decreasing
-preference style-wise, but increasing preference extensibility-wise.
+should be prefixed with C<DECL_>, e.g. C<DECL_SAVE_STACK>. Note that macros
+which implicitly declare and then use variables are strongly discouraged,
+unless it is essential for portability or extensibility. The following are in
+decreasing preference style-wise, but increasing preference extensibility-wise.
{ Stack sp = GETSTACK; x = POPSTACK(sp) ... /* sp is an auto variable */
{ DECL_STACK(sp); x = POPSTACK(sp); ... /* sp may or may not be auto */
@@ -1004,7 +1004,7 @@
=head1 REFERENCES
-The section on coding style is based on Perl5's F<Porting/patching.pod> by
+The section on coding style is based on Perl 5's F<Porting/patching.pod> by
Daniel Grisinger. The section on naming conventions grew from some suggestions
by Paolo Molaro <[EMAIL PROTECTED]>. Other snippets came from various
P5Pers.
