Re: Gripes about Pod6 (S26)

2010-02-12 Thread John Gabriele
On Fri, Feb 12, 2010 at 7:57 PM, Timothy S. Nelson wrote: > On Wed, 10 Feb 2010, Jon Lang wrote: > >> I definitely prefer Markdown's approach to "inline markup" over POD's >> approach: e.g., _italic_ strikes me as much more legible than >> I. > >        That's one of the things that's always annoy

Re: Gripes about Pod6 (S26)

2010-02-12 Thread jason switzer
On Fri, Feb 12, 2010 at 10:12 PM, Timothy S. Nelson wrote: > There's a school of thought, common among printing/publishing types, that >> insists that underline was intended solely to replace italics when they >> couldn't be represented (i.e. no fonts, as with ASCII terminals and >> printers). Th

Re: Gripes about Pod6 (S26)

2010-02-12 Thread Timothy S. Nelson
On Fri, 12 Feb 2010, Brandon S. Allbery KF8NH wrote: On Feb 12, 2010, at 19:57 , Timothy S. Nelson wrote: On Wed, 10 Feb 2010, Jon Lang wrote: John Gabriele wrote: Personally, I've always thought that Perl has a very natural feel to it, and deserves a doc markup format that's also natural: [M

Re: Gripes about Pod6 (S26)

2010-02-12 Thread Brandon S. Allbery KF8NH
On Feb 12, 2010, at 19:57 , Timothy S. Nelson wrote: On Wed, 10 Feb 2010, Jon Lang wrote: John Gabriele wrote: Personally, I've always thought that Perl has a very natural feel to it, and deserves a doc markup format that's also natural: [Markdown] (and [Pandoc]'s Markdown has just the right ad

Re: Gripes about Pod6 (S26)

2010-02-12 Thread Timothy S. Nelson
On Wed, 10 Feb 2010, Jon Lang wrote: John Gabriele wrote: Personally, I've always thought that Perl has a very natural feel to it, and deserves a doc markup format that's also natural: [Markdown] (and [Pandoc]'s Markdown has just the right additions, IMO). [Markdown]: http://daringfireball.net

Re: Gripes about Pod6 (S26)

2010-02-12 Thread chromatic
On Wednesday 10 February 2010 at 13:49, Patrick R wrote: > Actually, it's worth noting that (a slightly modified version of) > Perl 5 POD has indeed been used to write several substantial > books. I'd be very sad if (Perl 6) POD couldn't be easily used > or converted into something that can be u

Re: Gripes about Pod6 (S26)

2010-02-12 Thread Jan Ingvoldstad
On Fri, Feb 12, 2010 at 14:57, Carl Mäsak wrote: > Again, thanks for your efforts so far. The discussions over the years > have shown at least me what an ungrateful task it is to be redesigning > Pod for Perl 6. > Yep, thanks, Damian! Fortunately, doing _whatever_ for Perl 6 seems to be mostly

Re: Gripes about Pod6 (S26)

2010-02-12 Thread Carl Mäsak
Damian (>), Carl (>>): >> Partly that is because documentation isn't at the forefront of things >> that need to be implemented for Perl 6 to be useful, so it's kind of >> lagging behind the rest. >> >> Partly it's because Damian is the "owner" of that synopsis, and he >> practices a kind of "drive-

Re: Gripes about Pod6 (S26)

2010-02-12 Thread Richard Hainsworth
a) How many of the gripes are affected by Damian's new draft ? I found many of my pet irritations were eliminated by the new one. b) I suggest that Damian's new draft is committed as S-26 forthwith and development begin on it. c) Some of the comments in threads on documentation have been more