NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.
All the Perl that's Practical to Extract and Report
Stories, comments, journals, and other submissions on use Perl; are Copyright 1998-2006, their respective owners.
Ignorance is bliss (Score:1)
Marcel
Re:Ignorance is bliss (Score:1)
If we find out why, rather than treating the datum as an outlier, we can apply what we find to Perl.
For instance, several different people have told me that the PHP core documentation is organized better and available in other languages.
A lot of other people have also told me that the PHP documentation is more pragmatic,
Re:Domain specific language (Score:2, Insightful)
Perhaps Perl needs better CGI specific documentation. Perl, being a general purpose language, has a broad range of problems it can be used for. PHP, baring the mutant server-side version, is a CGI-only language. It is a lot easier to write documentation for PHP that tells users how to process CGI args, maintain session state, read client environment variables than to do the same for Perl, for which there are a great many ways to do it (and more are invented everyday). There are reams of paper dedicated to P
Documentation proposal (Score:2)
What happens when you type
perldoc perlcgi? Nothing. My point exactly.Maybe someone should write a manpage-length introduction to programming CGI with Perl and Apache that could be included in the core distribution. It could show the "right" way to do things (taint, strict, and CGI.pm) without having to comprehensively cover all of the alternatives. It could show how to accomplish common tasks. It wouldn't have to follow the usual maxim of, "That's a CGI issue, not a Perl issue, so it doesn't belong
J. David works really hard, has a passion for writing good software, and knows many of the world's best Perl programmers
Re:Documentation proposal (Score:1)
Maybe, but there are a lot of arguments even at that level. Do you use CGI to write your HTML? I, and a lot of others, consider that a bad practice, mixing code with HTML. Others, including a number of very talented programmers, feel differently.
So how do you document even a hello world cgi script? Do you teach them with CGI's commands, heredocs, outside files, or perhaps one of the many templating systems?
Sure, it's jus
Re:Documentation proposal (Score:1)
Reply to This
Parent