Add Weed out needless PERL_UNUSED_ARG to perltodo. It's a good

"cage cleaner" task.

p4raw-id: //depot/perl@32993

1 files changed, 21 insertions, 0 deletions

diff --git a/pod/perltodo.pod b/pod/perltodo.pod
index c6ab0652b8..caa1a833e5 100644
--- a/pod/perltodo.pod
+++ b/pod/perltodo.pod
@@ -365,6 +365,27 @@ Make F<pod/roffitall> be updated by F<pod/buildtoc>.
 These tasks would need a little C knowledge, but don't need any specific
 background or experience with XS, or how the Perl interpreter works
 
+=head2 Weed out needless PERL_UNUSED_ARG
+
+The C code uses the macro C<PERL_UNUSED_ARG> to stop compilers warning about
+unused arguments. Often the arguments can't be removed, as there is an
+external constraint that determines the prototype of the function, so this
+approach is valid. However, there are some cases where C<PERL_UNUSED_ARG>
+could be removed. Specifically
+
+=over 4
+
+=item *
+
+The prototypes of (nearly all) static functions can be changed
+
+=item *
+
+Unused arguments generated by short cut macros are wasteful - the short cut
+macro used can be changed.
+
+=back
+
 =head2 Modernize the order of directories in @INC
 
 The way @INC is laid out by default, one cannot upgrade core (dual-life)