In perl.git, the branch blead has been updated

<http://perl5.git.perl.org/perl.git/commitdiff/0865247fee6a3b07e9b17ec10a45c3426d101b56?hp=7720cfb228a3063e9c4516012cd689ae4713389b>

- Log -----------------------------------------------------------------
commit 0865247fee6a3b07e9b17ec10a45c3426d101b56
Author: Karl Williamson <[email protected]>
Date:   Thu Jan 24 09:59:47 2013 -0700

    Porting/todo.pod: Add task to clean up pods
-----------------------------------------------------------------------

Summary of changes:
 Porting/todo.pod |   14 ++++++++++++++
 1 files changed, 14 insertions(+), 0 deletions(-)

diff --git a/Porting/todo.pod b/Porting/todo.pod
index cce90df..64f8267 100644
--- a/Porting/todo.pod
+++ b/Porting/todo.pod
@@ -23,6 +23,20 @@ not, but if your patch is incorporated, then we'll add your 
name to the
 F<AUTHORS> file, which ships in the official distribution. How many other
 programming languages offer you 1 line of immortality?
 
+=head1 Tasks that need only a little Perl knowledge
+
+=head2 Fix POD errors in Perl documentation
+
+Perl documentation is furnished in POD (Plain Old Documentation); see
+L<perlpod>.  We also have a utility that checks for various errors in
+this documentation: F<t/porting/podcheck.t>.  Unfortunately many files
+have errors in them, and there is a database of known problems, kept in
+F<t/porting/known_pod_issues.dat>.  The most prevalent errors are lines
+too wide to fit in a standard terminal window, but there are more
+serious problems as well; and there are items listed there that are not
+in fact errors.  The task would be to go through and clean up the
+documentation.  This would be a good way to learn more about Perl.
+
 =head1 Tasks that only need Perl knowledge
 
 =head2 Migrate t/ from custom TAP generation

--
Perl5 Master Repository

Reply via email to