Re: please stop converting FUNCDOC headings to POD.

2007-09-18 Thread Allison Randal
Andy Lester wrote: We decided to remove FUNCDOC in May soon after it appeared. At the time it only appeared in a couple of files, so I was surprised to it now scattered over a couple of dozen files. Who is "we"? I was entirely unaware of it. I've yanked POD on every file that I've headerized

Re: please stop converting FUNCDOC headings to POD.

2007-09-18 Thread chromatic
On Tuesday 18 September 2007 12:38:49 Andy Lester wrote: > > We decided to remove FUNCDOC in May soon after it appeared. At the time > > it only appeared in a couple of files, so I was surprised to it now > > scattered over a couple of dozen files. > Who is "we"? I was entirely unaware of it. I

Re: please stop converting FUNCDOC headings to POD.

2007-09-18 Thread Andy Lester
> We decided to remove FUNCDOC in May soon after it appeared. At the time > it only appeared in a couple of files, so I was surprised to it now > scattered over a couple of dozen files. Who is "we"? I was entirely unaware of it. I've yanked POD on every file that I've headerized, which is all

Re: please stop converting FUNCDOC headings to POD.

2007-09-18 Thread Allison Randal
Andy Lester wrote: On Sep 18, 2007, at 9:04 AM, [EMAIL PROTECTED] wrote: -FUNCDOC: mark_special +=item C This is a perfect example of why I want us to use FUNCDOC and not POD. Who says that we are presenting functions as =item lists? Why is it presented in C<>? =item C applies two levels

Re: please stop converting FUNCDOC headings to POD.

2007-09-18 Thread Paul Cochrane
On 18/09/2007, Andy Lester <[EMAIL PROTECTED]> wrote: > > On Sep 18, 2007, at 9:04 AM, [EMAIL PROTECTED] wrote: > > > -FUNCDOC: mark_special > > +=item C > > This is a perfect example of why I want us to use FUNCDOC and not > POD. Who says that we are presenting functions as =item lists? Why > is

please stop converting FUNCDOC headings to POD.

2007-09-18 Thread Andy Lester
On Sep 18, 2007, at 9:04 AM, [EMAIL PROTECTED] wrote: -FUNCDOC: mark_special +=item C This is a perfect example of why I want us to use FUNCDOC and not POD. Who says that we are presenting functions as =item lists? Why is it presented in C<>? =item C applies two levels of presentatio