Not a joke, I find this to be a very valuable rule. No comments,
no check-ins.
I would define a relatively strict and standard way to do this so that
the documentation can be extracted out.
References: see perlapi and perlintern in the current development releases.
A related matter is that currently we have a central .pl file that is
used to generate the appropriate prototype headers and various cpp
magic incantations e.g. creating the threaded versions. I find this
to be curious direction: I would expect the .c files to be the master
files for function signatures, from which the prototype headers are
generated.
--
$jhi++; # http://www.iki.fi/jhi/
# There is this special biologist word we use for 'stable'.
# It is 'dead'. -- Jack Cohen
