[svn:perlfaq] r6677 - perlfaq/trunk

Author: comdog
Date: Tue Jul 18 08:33:08 2006
New Revision: 6677

Added:
   perlfaq/trunk/NEEDED_BUT_UNMADE_CHANGES
Modified:
   perlfaq/trunk/perlfaq7.pod

Log:
* perlfaq7 - rewrapped paragraph. No big whoop

* NEEDED_BUT_UNMADE_CHANGES - I have a list of requested changes, etc,
and I should start keeping a list of them somewhere that's not my computer.
I've proposed a little syntax for listing and categoriziung the changes,
and I need to fill in a little code to go through the list and make
nice reports.


Added: perlfaq/trunk/NEEDED_BUT_UNMADE_CHANGES
==============================================================================
--- (empty file)
+++ perlfaq/trunk/NEEDED_BUT_UNMADE_CHANGES	Tue Jul 18 08:33:08 2006
@@ -0,0 +1,52 @@
+#!/usr/bin/perl
+
+=pod
+
+This document sits aside the perlfaq files as a scratchpad for things
+that should change, but for some reason haven't. Please use this 
+syntax (and leave the committer annotation to subversion):
+
+	<severity>perlfaq<number> - <comment>
+
+	Severity
+
+		! - important change needed soon 
+		? - something that might need work, but not sure
+		. - change this at some point, but no big deal
+
+		& - needs a code change
+		" - needs a prose change
+
+		\ - backwards compatibility change (e.g. for 5.6)
+		/ - forwards compatibility change (e.g. for 5.10)
+
+		# - resolved, but keep in list anyway just in case
+
+		- - candidate for deletion
+		+ - candidate for addition
+
+For example:
+
+
+Important change to text:
+
+	!"perlfaq5 - The question says foo, but should say bar
+
+Is that code right:
+
+	?&perlfaq4 - Does that really calculate foo?
+		
+Delete this question:
+
+	-perlfaq3 - Question "How do I foo?" no longer needed with Perl5
+
+Add this question
+
+	+perlfaq1 - Add "Why Doens't anyone ever listen to me?"
+
+=cut
+
+# put some parsing, reporting code here
+
+__END__
+?perlfaq7 - remove Switch.pm mention

Modified: perlfaq/trunk/perlfaq7.pod
==============================================================================
--- perlfaq/trunk/perlfaq7.pod	(original)
+++ perlfaq/trunk/perlfaq7.pod	Tue Jul 18 08:33:08 2006
@@ -634,9 +634,9 @@
 This is explained in more depth in the L<perlsyn>.  Briefly, there's
 no official case statement, because of the variety of tests possible
 in Perl (numeric comparison, string comparison, glob comparison,
-regex matching, overloaded comparisons, ...).
-Larry couldn't decide how best to do this, so he left it out, even
-though it's been on the wish list since perl1.
+regex matching, overloaded comparisons, ...).  Larry couldn't decide 
+how best to do this, so he left it out, even though it's been on the 
+wish list since perl1.
 
 Starting from Perl 5.8 to get switch and case one can use the
 Switch extension and say: