develooper Front page | perl.perl5.porters | Postings from August 2017

Re: perldoc rewrite

Thread Previous | Thread Next
herbert breunung
August 15, 2017 18:30
Re: perldoc rewrite
Message ID:

>> I posted here some weeks ago  my wish for function and var index page but
>> including damian and sawyer.
> How would this index be used?

it would be normal pod page like the one called by perldoc perl
which I also consider a index page.

it would be an enhanced version of

even the table of content of
works as an index but for starter I would like see the 3 for core functions
special var and installed modules.

> This sounds like a terrible idea.  Why can't you pick a different letter?

I understand that you feel that way, but please see the whole picture (what
features we want and how sanely compromise between what is and where we want
to go). To search for module documentation will be used much more often by a
wide margin and -M for module makes much more sense than any other letter.
Alternative could be -p like package but thats awkward.

I think Brians idea for a --..  flag that enables sanely renamed option flags.
after some time people can get used the saner names without breaking anything.
but still i wanted know your opinion.

>There are plenty of users of the Pod::Perldoc API, both as a library
>and as extensions.  This sounds like a lot of potential breakage for a
>change that is not well explained.

sure its a core lib but frankly thats why i want to rewrite it because in
current state no one can touch it. I try to break as little as possible
and i posted here the worst two cases that I see absolutely necessary.
Soon there will be on a post which explains the plan in much
more details.


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