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

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

Thread Previous
From:
Michael G Schwern
Date:
March 6, 2009 10:19
Subject:
Re: [PATCH] Markup in the NAME section is not portable
Message ID:
49B16928.3040001@pobox.com
Russ Allbery wrote:
> Michael G Schwern <schwern@pobox.com> 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?
>> http://www.daemon.de/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.
https://addons.mozilla.org/en-US/firefox/addon/4125


> 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


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