summaryrefslogtreecommitdiff
path: root/pod/perltodo.pod
diff options
context:
space:
mode:
authorDavid Golden <dagolden@cpan.org>2009-10-06 14:13:31 -0400
committerDavid Golden <dagolden@cpan.org>2009-10-06 14:13:31 -0400
commite851c10581f8b45e99ba164a13a07381402b7e64 (patch)
tree6860623239e7f2b8ceb8b8ae3775854395c1bcf3 /pod/perltodo.pod
parent5dcd9c27efd1a82beb36a2791a7929cc9e8cb55d (diff)
downloadperl-e851c10581f8b45e99ba164a13a07381402b7e64.tar.gz
Add perltodo: write an XS cookbook
Diffstat (limited to 'pod/perltodo.pod')
-rw-r--r--pod/perltodo.pod8
1 files changed, 8 insertions, 0 deletions
diff --git a/pod/perltodo.pod b/pod/perltodo.pod
index a857e77fcc..b17ad9f5b0 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