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<mark_special> > > 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<mark_special> applies two levels of > presentation of documentation when we simply don't know how we want > it presented. > > Paul, please hold off on changing any more FUNCDOC. The only value > in having embedded POD in C source code is the ability to say > "pod2html foo.c > foo.html", and that's just not much of a benefit > when you consider the amount of boilerplate we'd be re-adding.
Ok. Consider the conversion held off. Allison had decided we should just use pod in the source and so to replace any other form of markup. Functions as =item C<> lists were written as what to do in the coding standards pod ages ago, hence the use of this markup here. Paul
