develooper Front page | perl.perl5.porters | Postings from March 2009

Re: [PATCH] Markup in the NAME section is not portable

Thread Previous
Michael G Schwern
March 6, 2009 10:19
Re: [PATCH] Markup in the NAME section is not portable
Message ID:
Russ Allbery wrote:
> Michael G Schwern <> writes:
>> Russ Allbery wrote:
>>> I can try to tackle a perlpodstyle documentation page, which I can
>>> either ship with podlators or hand off to the Perl core team as makes
>>> the most sense.  I'm somewhat handicapped by not having time to read
>>> perl5-porters, although I do read pod-people.
>> Maybe so we can rapidly get chunks of information in there some sort of
>> wiki?  Some sort of podwiki?
> I personally would prefer not to do text editing in a web browser.  I'd be
> happy to use a wiki such as ikiwiki where I can check out the pages with a
> real revision control system and edit them with my regular editor, though.

This might make you happy.  I know it makes me happy.

> However, before going down that path, I wonder if such a document might be
> only a minor modification of what's in the pod2man man page now, under the
> NOTES section.  It's fairly easy for me to start with that and then add
> the requirements for NAME and mail the results (to pod-people?
> perl5-porters?) and invite comment.

Yep, that would be a good place to start.  Rather than mail it, I'd just throw
it into version control somewhere.  Patch-by-mail is tedious at best, horrible
when it comes to documentation.  Throw it up on github or something.

The past has a vote, but not a veto.
    -- Mordecai M. Kaplan

Thread Previous Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About