From: David Golden <dagolden@cpan.org>
Date: Tue, 6 Oct 2009 18:13:31 +0000 (-0400)
Subject: Add perltodo: write an XS cookbook
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=e851c10581f8b45e99ba164a13a07381402b7e64;p=p5sagit%2Fp5-mst-13.2.git

Add perltodo: write an XS cookbook
---

diff --git a/pod/perltodo.pod b/pod/perltodo.pod
index a857e77..b17ad9f 100644
--- a/pod/perltodo.pod
+++ b/pod/perltodo.pod
@@ -569,6 +569,14 @@ These tasks would need C knowledge, and roughly the level of knowledge of
 the perl API that comes from writing modules that use XS to interface to
 C.
 
+=head2 Write an XS cookbook
+
+Create pod/perlxscookbook.pod with short, task-focused 'recipes' in XS that
+demonstrate common tasks and good practices.  (Some of these might be
+extracted from perlguts.) The target audience should be XS novices, who need
+more examples than perlguts but something less overwhelming than perlapi.
+Recipes should provide "one pretty good way to do it" instead of TIMTOWTDI.
+
 =head2 Remove the use of SVs as temporaries in dump.c
 
 F<dump.c> contains debugging routines to dump out the contains of perl data