[Jifty-commit] r1917 - in jifty/trunk: .

[jifty-commit at lists.jifty.org]

Author: schwern
Date: Fri Sep  1 19:09:03 2006
New Revision: 1917

Modified:
   jifty/trunk/   (props changed)
   jifty/trunk/lib/Jifty/Manual/Style.pod

Log:
 r17780 at windhund:  schwern | 2006-09-01 19:06:23 -0400
 Shout out to my man Conway D!
 
 Mention that Shell::Command is battle hardened goodness.
 
 Case-insensitive matching style.


Modified: jifty/trunk/lib/Jifty/Manual/Style.pod
==============================================================================
--- jifty/trunk/lib/Jifty/Manual/Style.pod	(original)
+++ jifty/trunk/lib/Jifty/Manual/Style.pod	Fri Sep  1 19:09:03 2006
@@ -2,6 +2,13 @@
 
 Jifty::Manual::Style - Jifty coding style guide
 
+
+=head3 Default style
+
+When in doubt, default to whatever Damian Conway's I<Perl Best
+Practices> says.
+
+
 =head3 Private documentation
 
 When documenting a private method, or providing documentation which is
@@ -35,8 +42,9 @@
 
 =head3 Use Shell::Command
 
-Shell::Command has a number of functions which work like common shell file
-commands such as touch, cp and mv.  Use them instead of coding your own.
+Shell::Command has a number of functions which work like common shell
+file commands such as touch, cp and mv.  They are battle tested and
+cross-platform.  Use them instead of coding your own.
 
 For example, instead of this:
 
@@ -48,4 +56,17 @@
     use Shell::Command;
     touch $file;
 
+
+=head3 Case insensitive matching
+
+To check if a string equals another string case insensitively, do this
+
+    lc $foo eq lc $bar;
+    lc $foo eq 'bar';
+
+not this:
+
+    $foo =~ /^\Q$bar\E/i;
+    $foo =~ /^bar$/i;
+
 =cut