Front page | perl.perl5.porters |
Postings from December 2004
Re: perlpodtut
Thread Previous
|
Thread Next
From:
Michael G Schwern
Date:
December 25, 2004 12:23
Subject:
Re: perlpodtut
Message ID:
20041225202311.GB5837@windhund.schwern.org
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
documenation.
> 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 schwern@pobox.com http://www.pobox.com/~schwern/
Abandon failing tactics.
Thread Previous
|
Thread Next