Mark Overmeer wrote:
[...yet another honest and heartfelt plea for Pod 6 to be something
entirely different from what it is currently designed to be.]
The solution is simple, you know, Mark. Why not just write up your own
alternate S26, redesigning Pod 6 the way you think it should work, and
In article
[EMAIL PROTECTED], Damian
Conway [EMAIL PROTECTED] wrote:
Mark Overmeer wrote:
[...yet another honest and heartfelt plea for Pod 6 to be something
entirely different from what it is currently designed to be.]
The solution is simple, you know, Mark. Why not just write up your
The outcome is that poddoc can be Pod6 pure and perldoc can be (as its
name suggests) documentation for Perl.
I failed to mention that it also has the benefit that developers can read the
perldoc if they care about method details - or they could read poddoc if they
only want a 7000 ft view
The outcome is that poddoc can be Pod6 pure and perldoc can be (as its
name suggests) documentation for Perl.
Sorry to reply to myself twice.
Making poddoc independent of Perl 6 opens the doors a little further for
having pythondoc and phpdoc and yourlanguageheredoc which extract the POD
On 6/21/07, brian d foy wrote:
Couldn't most of this be figured out by making Pod6 extensible (or
whatever the right term is). Pod6 would be more of the syntax and
basic operation, but other people could have custom directives that
their Pod6 translators and formatters could then use.
Yeah,
All,
I am pleased to announce the release of Muldis::DB version 0.0.0 for
Perl 5 on CPAN. You can see it now, with nicely HTMLized
documentation, at:
http://search.cpan.org/dist/Muldis-DB/
This is the first formal release of Muldis::DB, which began
development last year (under the
Larry Wall writes:
I have a problem with both extremes, and I want to solve it with a
dose of postmodern apathy. It may seem a bit insane, but I think that
in
print qq:to/END/
=for whatever
END
I would prefer that the =for is considered Pod by any standard Pod
parser,
Mark Overmeer writes:
* Smylers ([EMAIL PROTECTED]) [070616 09:09]:
You're concerned that an aspect of Perl 6 might have too much
freedom? Isn't Perl all about giving users freedom to choose their
own way of doing something?
Why treat documentation as a second-class citizen all the
Moritz Lenz writes:
You could help by contributing some suggestions to what the new Web
module should be able to do, and how so. Web is hopefully CGI done
right, and still in its early planning stage.
Web module? This is the first I've heard of it. Where is it being
planned, if not on this
brian d foy writes:
In article [EMAIL PROTECTED], Smylers
[EMAIL PROTECTED] wrote:
brian d foy writes:
In article
[EMAIL PROTECTED], Damian
Conway [EMAIL PROTECTED] wrote:
No. It's Pod. *Any* line that begins with '=begin' always starts a Pod
block. Always.
As
Damian Conway writes:
Here's the first draft (documented in Pod 6, of course ;-).
Feedback and suggestions are most welcome.
Note that C=alias is a fundamental Perldoc directive, like C=begin
or C=for; it is Inot an instance of an
Labbreviated block|#Abbreviated blocks. Hence there is no
Smylers reported:
I was with you right up until the mention of C=encoding; what's that
got to do with anything?
CP bug. Patched. Thanks!
Damian
Darren Duncan writes:
At 6:37 PM +0100 6/21/07, Smylers wrote:
Web module? This is the first I've heard of it. Where is it being
planned, if not on this list?
It was being discussed on the perl6-users list, last year.
Thanks.
Smylers
Damian Conway writes:
Here's the first draft (documented in Pod 6, of course ;-).
=head3 Ambient aliases
The CA formatting code specifies an Balias to an ambient
antecedent.
Please can you explain the reasoning for choosing antecedent, rather
than successor?
I'm not disagreeing with
Juerd Waalboer writes:
Damian Conway skribis 2007-06-21 11:45 (+1000):
A dedicated OO documentation tool could certainly do a better job in
that case, I heartily agree. I'm looking forward to using one.
This dedicated OO documentation must be core, because Perl itself is
heavily OO.
Smylers skribis 2007-06-21 21:33 (+0100):
That doesn't follow.
It's an opinion.
I disagree. perldoc.perl.org was started by JJ, gained popularity, and
then got awarded the official blessing of the onion. Over the years
there have many several sites with Perl documenation.
That's not a way
Smylers wrote:
Moritz Lenz writes:
You could help by contributing some suggestions to what the new Web
module should be able to do, and how so. Web is hopefully CGI done
right, and still in its early planning stage.
Web module? This is the first I've heard of it. Where is it being
Juerd Waalboer writes:
Smylers skribis 2007-06-21 21:33 (+0100):
I disagree. perldoc.perl.org was started by JJ, gained popularity,
and then got awarded the official blessing of the onion. Over the
years there have many several sites with Perl documenation.
That's not a way of
Moritz Lenz writes:
Smylers wrote:
Moritz Lenz writes:
Web is hopefully CGI done right
... why are we hoping that it will be done right?
Because we hope we learned from the past. There are several other
modules that fullfill most of CGI's tasks, some of them do most of it
Juerd wrote:
Damian Conway skribis 2007-06-21 11:45 (+1000):
A dedicated OO documentation tool could certainly do a better job in that
case, I heartily agree. I'm looking forward to using one.
This dedicated OO documentation must be core, because Perl itself is
heavily OO.
Yes. I
brian asked:
Couldn't most of this be figured out by making Pod6 extensible (or
whatever the right term is). Pod6 would be more of the syntax and basic
operation, but other people could have custom directives that their
Pod6 translators and formatters could then use. That is, not all of
this
On 6/21/07, Smylers wrote:
Mark Overmeer writes:
The boundary between freedom and anacharchy is faint.
Indeed. And I'd much rather we err on the side of anarchy.
I'd much rather we didn't err at all! Just because something isn't
perfect doesn't mean it's an error, or that it's not worth
22 matches
Mail list logo