Adam Turoff <[EMAIL PROTECTED]> writes:
> On Thu, Jul 24, 2003 at 10:55:42AM -0600, Nick Pinckernell wrote:
>> I agree with the first three items right out of
>> http://dev.perl.org/rfc/5.pod
>> 1. IT'S NOT INTUITIVE
>
> "Intuitive" is one of those meaningless buzzwords like "maintainable".
>
On Thu, Jul 24, 2003 at 10:55:42AM -0600, Nick Pinckernell wrote:
> I agree with the first three items right out of
> http://dev.perl.org/rfc/5.pod
> 1. IT'S NOT INTUITIVE
"Intuitive" is one of those meaningless buzzwords like "maintainable".
It sounds good, but it's meaningless. See MJD's ta
At 10:55 AM 2003-07-24 -0600, Nick Pinckernell wrote, of Pod:
1. IT'S NOT INTUITIVE
IT ISN'T? You can take normal English sentences alternating with
codeblocks, put "=pod" before and =cut after, and it's got a 99% chance of
being good as Pod. That's pretty intuitive, for an intuitively intuit
Ok, wow, didn't think I'd generate this much feedback.
First of all, let me say that yes, I agree, the perldoc name
for the sourceforge project is bad--I was going to change it.
Second, I was originally thinking about this for Perl 5.
However, after reading some of the Perl 6 RFC's I would want
t
> "David" == David Storrs <[EMAIL PROTECTED]> writes:
David> Other than that, I think (and have always thought) that POD is pretty
David> close to perfect.
I've written 175 magazine articles and my latest best-selling book
in Pod. I rarely find it lacking for typical documentation.
--
Rand
On Wed, Jul 23, 2003 at 10:49:40PM -0600, Nick Pinckernell wrote:
> Hello All,
> My name is Nick Pinckernell.
Hi Nick,
Other people have already commented on most of your points, so I won't
repeat, except to say that I agree that the name "perldoc" is already
taken, and that POD really is pretty
On Wed, Jul 23, 2003 at 10:49:40PM -0600, Nick Pinckernell wrote:
> The idea is: a structured Javadoc style system for Perl. It would be very
> dependant on multiline comments (I've seen the Perl 6 RFC).
>
> I think this idea would be really good for Perl 6, because, in my opinion,
> POD is lacki
[EMAIL PROTECTED] (Nick Pinckernell) wrote on Wed, 23 Jul 2003 22:49:40 -0600:
I have just recently taken over the sourceforge project
perldoc. However, currently, there is not much there. It was started
about a year ago, and no work was ever done on the idea by the previous
project owner.
Th
Luke Palmer <[EMAIL PROTECTED]> writes:
> Iain Truskett wrote:
>> * Nick Pinckernell ([EMAIL PROTECTED]) [24 Jul 2003 14:50]:
>>
>> [...]
>> > The idea is: a structured Javadoc style system for Perl. It would be
>> > very dependant on multiline comments (I've seen the Perl 6 RFC).
>>
>> Why so?
>
Iain Truskett wrote:
> * Nick Pinckernell ([EMAIL PROTECTED]) [24 Jul 2003 14:50]:
>
> [...]
> > The idea is: a structured Javadoc style system for Perl. It would be
> > very dependant on multiline comments (I've seen the Perl 6 RFC).
>
> Why so?
>
> > I think this idea would be really good for
* Nick Pinckernell ([EMAIL PROTECTED]) [24 Jul 2003 14:50]:
[...]
> The idea is: a structured Javadoc style system for Perl. It would be
> very dependant on multiline comments (I've seen the Perl 6 RFC).
Why so?
> I think this idea would be really good for Perl 6,
> because, in my opinion, POD i
Hello All,
My name is Nick Pinckernell.
I have just recently taken over the sourceforge project perldoc. However,
currently, there is not much there. It was started about a year ago, and
no work was ever done on the idea by the previous project owner.
The idea is: a structured Javadoc style s
12 matches
Mail list logo