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

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

Thread Previous | Thread Next
From:
Russ Allbery
Date:
March 5, 2009 16:22
Subject:
Re: [PATCH] Markup in the NAME section is not portable
Message ID:
878wnj8pqe.fsf@windlord.stanford.edu
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.

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.

-- 
Russ Allbery (rra@stanford.edu)             <http://www.eyrie.org/~eagle/>

Thread Previous | Thread Next


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