develooper Front page | perl.perl5.porters | Postings from December 2004

Re: perlpodtut

Thread Previous | Thread Next
Michael G Schwern
December 25, 2004 12:23
Re: perlpodtut
Message ID:
On Fri, Dec 24, 2004 at 10:56:09PM +0100, Juerd wrote:
> Different people learn in different ways. For many, including myself, it
> helps to see a name in one place and the same name used elsewhere. It
> makes it easier to realise that the same thing is discussed.
> Also, if I see where a word comes from, that helps me remember why the
> word is used for what it's used for. You're not taking these pointers
> away from me :)

Let's keep it firmly in mind that none of us are the target for this 

> They are:
> * I<command paragraphs>
> * "see together"
> * I<verbatim paragraph>
> * I<formatting code>
> * I<indentlevel>

I agree that the paragraph terms should be mentioned in this document
because they will be seen throughout the rest of the POD documentation and
are often misunderstood.  POD has a very special meaning for "paragraph"
that isn't quite what most people expect.

However, I do think providing the greek derivation of SYNOPSIS is not 
terribly useful to explain what its used for.  This is a concise tutorial
and that sort of thing just doesn't seem very utilitarian.

Michael G Schwern
Abandon failing tactics.

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About