Front page | perl.perl5.porters |
Postings from December 2009
RE: [PATCH] perlpod updates
Thread Previous
|
Thread Next
From:
Jan Dubois
Date:
December 7, 2009 18:30
Subject:
RE: [PATCH] perlpod updates
Message ID:
001501ca77ae$5551a7b0$fff4f710$@activestate.com
On Mon, 07 Dec 2009, Ricardo Signes wrote:
> * David Golden <xdaveg@gmail.com> [2009-12-07T19:10:12]
> > On Mon, Dec 7, 2009 at 6:36 PM, Ricardo Signes
> > <perl.p5p@rjbs.manxome.org> wrote:
> > >
> > > These three patches implement minor but important changes to the Pod
> > > specification and documentation, discussed and approved on the pod-people
> > > list.
> >
> > I like the changes, but on principle, given the feature freeze, I
> > think these ought to wait until 5.13 unless all the Pod tools in core
> > already implement them. If they are implemented, great, then this is
> > just harmonizing docs with tools. Otherwise, the spec tells people
> > that something is legal that they can't actually use yet, which isn't
> > user friendly.
>
> The changes are all implemented in the latest Pod::Simple (and, mostly, in
> previous Pod::Simple -- which implemented more than the spec allowed!)
Yes, but (unless I'm confused) pod2html doesn't yet use Pod::Simple, so
the changes wouldn't actually work for translation into HTML, right?
I know there is Pod::Simple::HTML, but the documentation is littered with
TODO markers, and there doesn't seem to be a commandline interface for it,
so I always assumed it isn't ready for real use yet (and the Pod::Simple
README also confirms that isn't what it should be yet).
Cheers,
-Jan
Thread Previous
|
Thread Next