develooper Front page | perl.perl6.language | Postings from March 2005

Re: [Fwd: Re: [RFC] A more extensible/flexible POD (ROUGH-DRAFT)]

Thread Previous | Thread Next
From:
Aaron Sherman
Date:
March 16, 2005 11:57
Subject:
Re: [Fwd: Re: [RFC] A more extensible/flexible POD (ROUGH-DRAFT)]
Message ID:
1111002995.5105.4933.camel@pps
On Wed, 2005-03-16 at 14:24, Brian Ingerson wrote:

> vs Kwid:
> 
>         `$x > $y` is about as *easy* as it gets in [Perl]
> 
> Did you really read `perlkwid.kwid`? 

Yes, and can you please stop asking that question? I read it several
times, and you're starting to get just this side of insulting. If I got
something wrong, fine, say so. Stop trying to dismiss everything else
I've said by suggesting that I'm completely uninformed.

> There is simply no mention
> of `[=...]` as a markup option, which makes me wonder where you
> got it from?


I got it from that document.... or so I thought. Since it's now deleted,
I'm no longer sure. Having a reference again would be nice. It's hard to
have a conversation about a document that does not exist.

Ok, that said PLEASE DO NOT USE UNBALANCED CHARACTERS TO DELIMIT!
Please, for the love of all that is valid input to any scanner / parser
anywhere, do not re-introduce quoting hell. Really. Please. Don't. I'll
buy you a beer. I swear, just put the unbalanced operator down and step
back.

Sorry, but I use POD specifically because it makes my life simple.
Introducing unbalanced quotes into it would remove that functionality. A
few examples:

	"And then I says, `Mabel,' I says, `shut up.'"

	The ``` character is no longer used.

And of course, TONS of Gnu documentation which uses the TeX-friendly:

	This is the way you ``quote'' things.

which means cutting-and-pasting such docs is now much more
labor-intensive.

-- 
Aaron Sherman <ajs@ajs.com>
Senior Systems Engineer and Toolsmith
"It's the sound of a satellite saying, 'get me down!'" -Shriekback



Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About