Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Mark Overmeer
* Damian Conway ([EMAIL PROTECTED]) [070621 01:45]: > Mark Overmeer wrote: > >This is exactly the form of documentation you do *not* want the > >user to write, for various reasons: > Well, I agree it is the form that "you" (singular, specific) do not want; > but I'm not sure it's bad for "you" (p

Re: [svn:parrot-pdd] r19204 - trunk/docs/pdds

2007-06-21 Thread Jonathan Worthington
chromatic wrote: Classes are PMCs. Are there benefits to pushing them one step further and making them Objects as well? A PDD15 class is an object in so far as it's an instance of a PMC. A PMC is a class, just written in C rather than PIR. Jonathan

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Damian Conway
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 the

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Juerd Waalboer
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. If we are to ever have consisten

Fwd: r19207 - in trunk: compilers/imcc config/gen/makefiles tools/build

2007-06-21 Thread jerry gay
-- Forwarded message -- From: [EMAIL PROTECTED] Date: Jun 20, 8:59 pm Subject: r19207 - in trunk: compilers/imcc config/gen/makefiles tools/ build To: perl.cvs.parrot Author: petdance Date: Wed Jun 20 20:58:59 2007 New Revision: 19207 Modified: trunk/compilers/imcc/imcparser.c

Re: r19207 - in trunk: compilers/imcc config/gen/makefiles tools/build

2007-06-21 Thread Andy Lester
On Jun 21, 2007, at 8:57 AM, jerry gay wrote: remember the days when we were C89 compliant? i do. in fact, my compiler still lives in those days. 'inline' is a swear word. Sorry 'bout that. I thought it was a leftover. Bad Andy for not checking his assumptions, or even asking. I updated

Re: memcpy

2007-06-21 Thread Andy Lester
On Jun 21, 2007, at 1:39 AM, Allison Randal wrote: Andy Lester wrote: I guess I don't see the need to document a standard C behavior with a macro. If you had read all the way through the message, you would see that the biggest benefit is the ability to hang debugging hooks off the macro

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread brian d foy
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 u

Struct copying

2007-06-21 Thread Andy Lester
We now have STRUCT_COPY(dest,src) and STRUCT_COPY_N(dest,src,n) for all your struct-copying needs. xoxo, Andy -- Andy Lester => [EMAIL PROTECTED] => www.petdance.com => AIM:petdance

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Paul Seamons
> > 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 > > then publish your proposal for consideration here? > > Couldn't most of this be figured out by making Pod6 extensible (or > whatever the right te

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Paul Seamons
> 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

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Paul Seamons
> 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

Re: Struct copying

2007-06-21 Thread Mark J. Reed
On 6/21/07, Andy Lester <[EMAIL PROTECTED]> wrote: We now have STRUCT_COPY(dest,src) and STRUCT_COPY_N(dest,src,n) for all your struct-copying needs. Wait! Wait! It should be src, THEN dest! -- Mark J. Reed <[EMAIL PROTECTED]>

Re: Referring to source code within Perldoc

2007-06-21 Thread David Green
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, t

ANNOUNCE - Muldis::DB v0.0.0 released, in p5+p6

2007-06-21 Thread Darren Duncan
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 tempor

Re: Struct copying

2007-06-21 Thread Joshua Isom
On Jun 21, 2007, at 12:57 PM, Mark J. Reed wrote: On 6/21/07, Andy Lester <[EMAIL PROTECTED]> wrote: We now have STRUCT_COPY(dest,src) and STRUCT_COPY_N(dest,src,n) for all your struct-copying needs. Wait! Wait! It should be src, THEN dest! -- Mark J. Reed <[EMAIL PROTECTED]> Are you a

Re: Struct copying

2007-06-21 Thread Mark J. Reed
On 6/21/07, Joshua Isom <[EMAIL PROTECTED]> wrote: > Wait! Wait! It should be src, THEN dest! Are you an AT&T guy or an Intel guy? Neither! 68k assembly FTW! -- Mark J. Reed <[EMAIL PROTECTED]>

Re: Quirky comments

2007-06-21 Thread Smylers
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 Po

Re: = at Start of Line ([svn:perl6-synopsis] r14421 - doc/trunk/design/syn)

2007-06-21 Thread Smylers
Mark Overmeer writes: > * Smylers ([EMAIL PROTECTED]) [070616 08:44]: > > > With these new Pod rules it's possible to entirely remove Pod from a > > file without knowing _anything_ about the host language. That > > permits Pod to be used to document just about anything; all you need > > to allow

Re: [svn:perl6-synopsis] r14421 - doc/trunk/design/syn

2007-06-21 Thread Smylers
Mark Overmeer writes: > * Jonathan Scott Duff ([EMAIL PROTECTED]) [070616 20:15]: > > > You mention OOP. For Perl 5 we have a standard, if very general, > > syntax and "open" semantics that have allowed people to implement > > OOP in a variety of ways. This was all well and good for a while > >

Re: Web Module (Was: Perl6 new features)

2007-06-21 Thread Smylers
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

Re: [svn:perl6-synopsis] r14421 - doc/trunk/design/syn

2007-06-21 Thread Smylers
Chaddaï Fouché writes: > I'm quite surprised by this debate... To me it seems a clear rule that > state that "if a line begin with "=" then it starts a POD section" is > way easier to understand than "a line beginning by = will start a POD > section except if it is in a Perl statement, or in a :to

Re: = at Start of Line ([svn:perl6-synopsis] r14421 - doc/trunk/design/syn)

2007-06-21 Thread Smylers
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 Po

Re: [svn:perl6-synopsis] r14421 - doc/trunk/design/syn

2007-06-21 Thread Smylers
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 citize

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Damian Conway
Smylers reported: I was with you right up until the mention of C<=encoding>; what's that got to do with anything? C&P bug. Patched. Thanks! Damian

Re: Web Module (Was: Perl6 new features)

2007-06-21 Thread Darren Duncan
At 6:37 PM +0100 6/21/07, 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 o

Re: Request for kp6 compiler architecture review

2007-06-21 Thread Flavio S. Glock
This is a summary of the responses I've got on #perl6 irc. I'm sending the follow up to perl6-compiler only; I guess this is off-topic in perl6-language. 2007/6/19, Flavio S. Glock <[EMAIL PROTECTED]>: I'm looking for comments on how to improve the compiler internals. For example: - One of my

Re: Web Module (Was: Perl6 new features)

2007-06-21 Thread Smylers
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

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Smylers
Damian Conway writes: > Here's the first draft (documented in Pod 6, of course ;-). > > =head3 Ambient aliases > > The C> formatting code specifies an B antecedent>. Please can you explain the reasoning for choosing antecedent, rather than successor? I'm not disagreeing with your choice, merel

Re: Quirky comments

2007-06-21 Thread Smylers
Jonathan Lang writes: > The only other thing that I'll continue to lobby for is that the line > starting with a block comment's termination tag should _not_ be > considered part of the comment, save for the termination tag itself. > Programmers are likely to be surprised when text that follows a >

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Smylers
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 I an instance of an > L. Hence there is no paragraph > or delimited fo

ANNOUNCE - Muldis::DB v0.0.0 released, in p5+p6

2007-06-21 Thread Darren Duncan
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 tempor

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Juerd Waalboer
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

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Smylers
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 > heavil

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Smylers
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

Re: Web Module (Was: Perl6 new features)

2007-06-21 Thread Smylers
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 th

Re: Web Module (Was: Perl6 new features)

2007-06-21 Thread Juerd Waalboer
Smylers skribis 2007-06-21 23:23 (+0100): > Of course. But there's a big difference between the attitude of 'let's > do the best we can right now' and 'this is our one chance to do this > right'. I think that for some things, mainly for setting community standards (Web, POD, ...), this is our one

Re: Web Module (Was: Perl6 new features)

2007-06-21 Thread Moritz Lenz
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

Re: Web Module (Was: Perl6 new features)

2007-06-21 Thread Darren Duncan
At 11:23 PM +0100 6/21/07, Smylers wrote: Has Larry yet decreed whether Web will be bundled with Perl 6? I believe that what Larry has said is that there are no official core modules, but that people who distribute Perl can bundle whatever they want, and that such choice was to be encouraged.

parrot question and stacked patches

2007-06-21 Thread pancake
I have sent two PRs for pdb and I have a third one not yet commited. http://rt.perl.org/rt3//Ticket/Display.html?id=31159 http://rt.perl.org/rt3//Ticket/Display.html?id=37287 My third patch is about http://rt.perl.org/rt3//Ticket/Display.html?id=31163 (list breakpoints). Ok, after the presentati

Configuration steps: RT tickets for units tests forthcoming

2007-06-21 Thread James E Keenan
In the next few days I will be creating a number of new RT [TODO] tickets -- 56, to be precise, one for each of Parrot's current configuration steps. These RT tickets will track progress in writing unit tests for the Perl 5 packages under the config/ directory which govern the individual step

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Larry Wall
On Thu, Jun 21, 2007 at 09:21:13PM +0100, Smylers wrote: : Damian Conway writes: : : > Here's the first draft (documented in Pod 6, of course ;-). : > : > =head3 Ambient aliases : > : > The C> formatting code specifies an B antecedent>. : : Please can you explain the reasoning for choosing ante

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread David Green
On 6/21/07, Smylers wrote: Please can you explain the reasoning for choosing antecedent, rather than successor? I assume because it's easier for someone to refer to something that was just written in the preceding line(s) than something that hasn't been written yet. Of course, documentation

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Damian Conway
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 completel

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Damian Conway
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 has

Re: Referring to source code within Perldoc: the new A<> code

2007-06-21 Thread Damian Conway
Hi Larry. You wrote: : Please can you explain the reasoning for choosing antecedent, rather : than successor? I think having to pick either one or the other is likely a design smell. Maybe it would be better to have predeclared extractors than to have a search strategy baked half-heartedly int

Re: documentation standards (was "[svn:perl6-synopsis] r14421 - doc/trunk/design/syn")

2007-06-21 Thread David Green
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

Re: [svn:parrot] r19231 - trunk/languages/perl6/src/pmc

2007-06-21 Thread chromatic
On Thursday 21 June 2007 12:05:35 [EMAIL PROTECTED] wrote: > Log: > [perl6]: > * Fix incorrect get_string() value in perl6bool.pmc (Infinoid++) > > > Modified: trunk/languages/perl6/src/pmc/perl6bool.pmc > === >=== --- trunk/l

Re: [svn:parrot] r19231 - trunk/languages/perl6/src/pmc

2007-06-21 Thread Mark Glines
On Thu, 21 Jun 2007 17:38:15 -0700 chromatic <[EMAIL PROTECTED]> wrote: > > -return string_from_cstring(INTERP, "Str", 3); > > +return string_from_cstring(INTERP, "Bool", 3); > > return SUPER(); > > } > > That 3 looks like it should be 4. Yep, fixed in r19238

Summary of today's digging into t/compiler/pge/06-grammar.t

2007-06-21 Thread Andy Lester
pmichaud and I figured today that the segfaulting in 06-grammar.t is caused by optimization, with the --optimize flag. However, it's not all the fault of --optimize. I've been working on valgrind, and there's some invalid memory accessing going on. There's a dump following. The key is in

Re: [svn:parrot] r19231 - trunk/languages/perl6/src/pmc

2007-06-21 Thread chromatic
On Thursday 21 June 2007 17:44:38 Mark Glines wrote: > On Thu, 21 Jun 2007 17:38:15 -0700 > > chromatic <[EMAIL PROTECTED]> wrote: > > > -return string_from_cstring(INTERP, "Str", 3); > > > +return string_from_cstring(INTERP, "Bool", 3); > > > return SUPER(); > > >

Re: Summary of today's digging into t/compiler/pge/06-grammar.t

2007-06-21 Thread chromatic
On Thursday 21 June 2007 22:19:42 Andy Lester wrote: > pmichaud and I figured today that the segfaulting in 06-grammar.t is > caused by optimization, with the --optimize flag. > > However, it's not all the fault of --optimize. I've been working on > valgrind, and there's some invalid memory acces