Front page | perl.perl5.porters |
Postings from August 2017
perldoc rewrite
Thread Next
From:
herbert breunung
Date:
August 11, 2017 15:49
Subject:
perldoc rewrite
Message ID:
trinity-bbc6dafe-4297-4eb8-861d-f664b03f7fc4-1502466550905@3c-app-webde-bs52
<html><head></head><body><div style="font-family: Verdana;font-size: 12.0px;"><div>Dear Porters</div>
<div> </div>
<div>I posted here some weeks ago my wish for function and var index page but the issue behind it turned out to be much bigger.</div>
<div>Thats why I currently plan a rewrite of perldoc tool. mark and brian are on board and i just had fruitful discussions and input on and off YAPC including damian and sawyer.</div>
<div> </div>
<div>Even it will take some time to get even a functionaly equivalent replacement (first before I can add features),</div>
<div>I already want to discuss with you some changes that will be needed.</div>
<div>An detailed featurelsit will be posted later on blogs.perl but for now i want to announce the stuff that might be most disturbing from your point.</div>
<div> </div>
<div>1. I want make parameter parsing of perldoc stricter, so only input that completely makes sense will be run.</div>
<div> </div>
<div>2. at some point searchable keywords have to be included in the pod via X<> tags and in the main perl.POD the references to oterh pages has to be converted to</div>
<div>L<...> so i can categorize them by the X<in front> to get sensible search categories without guessing too much,</div>
<div>plus it would make it more similar what perldoc.org shows.</div>
<div> </div>
<div>3. I need the -M key (CLI option) for module related stuff. Since sawyer already told me I can't have the -m</div>
<div> the -M sems a good candidate since its very rarely used (alt formatter Module) and the we have good precedent of changing one very seldom used flag of perldoc by mark in past.(sorry but details to that are at home at my main machine).</div>
<div> </div>
<div>Thanks</div>
<div>Herbert</div></div></body></html>
Thread Next
-
perldoc rewrite
by herbert breunung