From: Rafael Garcia-Suarez <rgarciasuarez@gmail.com>
Date: Fri, 9 Nov 2007 09:08:09 +0000 (+0000)
Subject: A couple of bite-sized TODO for the pod/* tools
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=8537f02106cbf9808225cec27f1c514932dcc80c;p=p5sagit%2Fp5-mst-13.2.git

A couple of bite-sized TODO for the pod/* tools

p4raw-id: //depot/perl@32250
---

diff --git a/pod/buildtoc b/pod/buildtoc
index 705317a..3238c5a 100644
--- a/pod/buildtoc
+++ b/pod/buildtoc
@@ -33,6 +33,7 @@ $masterpodfile = File::Spec->catdir($Up, "pod.lst");
      podmak => File::Spec->catdir($Up, "win32", "pod.mak"),
      # plan9 =>  File::Spec->catdir($Up, "plan9", "mkfile"),
      unix => File::Spec->catdir($Up, "Makefile.SH"),
+     # TODO: add roffitall
     );
 
 {
@@ -273,7 +274,7 @@ close MASTER;
   }
 }
 
-# OK. Now a lot of ancillay function definitions follow
+# OK. Now a lot of ancillary function definitions follow
 # Main program returns at "Do stuff"
 
 sub path2modname {
@@ -627,7 +628,7 @@ sub do_perlpod {
 		   )+
 		  }
 	  {$1 . join "", &generate_perlpod}mxe) {
-    die "$0: Failed to insert ammendments in do_perlpod";
+    die "$0: Failed to insert amendments in do_perlpod";
   }
   $pod;
 }
diff --git a/pod/perltodo.pod b/pod/perltodo.pod
index e7441f1..e9cfa79 100644
--- a/pod/perltodo.pod
+++ b/pod/perltodo.pod
@@ -49,6 +49,13 @@ is needed to improve the cross-linking.
 The addition of C<Pod::Simple> and its related modules may make this task
 easier to complete.
 
+=head2 merge checkpods and podchecker
+
+F<pod/checkpods.PL> (and C<make check> in the F<pod/> subdirectory)
+implements a very basic check for pod files, but the errors it discovers
+aren't found by podchecker. Add this check to podchecker, get rid of
+checkpods and have C<make check> use podchecker.
+
 =head2 Parallel testing
 
 (This probably impacts much more than the core: also the Test::Harness
@@ -336,6 +343,10 @@ cross-compilation/execution environments the HOST and the TARGET do
 not see the same filesystem(s), the $Config{run} may need to do some
 file/directory copying back and forth.
 
+=head2 roffitall
+
+Make F<pod/roffitall> be updated by F<pod/buildtoc>.
+
 =head1 Tasks that need a little C knowledge
 
 These tasks would need a little C knowledge, but don't need any specific