Re^3: Bookmarklet to show deeplinks in perldoc.perl.org
by choroba (Cardinal) on Jun 17, 2019 at 14:36 UTC
|
See for example Reddit or GitHub for some discussions. It's probably too early to judge the new beta version of perldoc.org. perldoc.pl has been, on the other hand, mature for some time already.
map{substr$_->[0],$_->[1]||0,1}[\*||{},3],[[]],[ref qr-1,-,-1],[{}],[sub{}^*ARGV,3]
| [reply] [Watch: Dir/Any] [d/l] |
Re^3: Bookmarklet to show deeplinks in perldoc.perl.org
by LanX (Saint) on Jun 17, 2019 at 15:07 UTC
|
> If I can be convinced that perldoc.pl is a better choice for our (PM) needs, I'll switch it.
some thoughts:
- If switching means that old doc-links will refer to perldoc.pl I'm not sure if URL paths are consistent.
- We used to have a [metacpan:://...] alternative to [cpan://..] . ( [docpl://..] might be an option but I'm not too convinced.)
- you may add a user setting such that users like Choroba can choose jumping perldoc.pl for each ... link
Personally I prefer direct auto-linking of bare http-URLs. My wikisyntax does this.
> It was claimed that perldoc.perl.org was moribund,
I only had minor issues with perldoc.perl.org. (like the need to scroll up after a deeplink, because the first lines where covered by the navbar.)
And like already mentioned in the OP are possible deep-targets not easily accessible.
What I have trouble to understand is why they suddenly replaced it with a worse beta-version of something else.
| [reply] [Watch: Dir/Any] [d/l] [select] |
|
If switching means that old doc-links will refer to perldoc.pl I'm not sure if URL paths are consistent.
OTOH, not switching would have the same problem, as perldoc.perl.org is messing with their own stuff.
But I'm not sure this is in fact a problem. [doc://open] has no URL paths.
direct auto-linking of bare http-URLs.
I have no idea what that means. Can you clarify? TIA.
I reckon we are the only monastery ever to have a dungeon stuffed with 16 ,000 zombies.
| [reply] [Watch: Dir/Any] [d/l] |
|
| [reply] [Watch: Dir/Any] [d/l] [select] |
|
|
|
|
> why they suddenly replaced it
Because the old one was out of date (it hadn't been updated for more than a year, so it didn't show the latest Perl version's documentation, it was stuck at 5.26 IIRC) and there was no one to maintain it in its current state.
Another question is, why they suddenly replaced it when a replacement had already existed at perldoc.pl. I don't know the answer.
map{substr$_->[0],$_->[1]||0,1}[\*||{},3],[[]],[ref qr-1,-,-1],[{}],[sub{}^*ARGV,3]
| [reply] [Watch: Dir/Any] [d/l] |
|
Am I mislead or did the old version allow to be downloaded with an embedded JS search engine?
| [reply] [Watch: Dir/Any] |
|
Any URL paths to actual documentation pages should still work. Index pages are an invention of perldoc.perl.org and won't, though I could be convinced to add forwarding for them.
-Grinnz
| [reply] [Watch: Dir/Any] |
|
| [reply] [Watch: Dir/Any] [d/l] [select] |
|
|
Re^3: Bookmarklet to show deeplinks in perldoc.perl.org
by marto (Cardinal) on Jun 17, 2019 at 14:11 UTC
|
| [reply] [Watch: Dir/Any] |
|
There's no longer an obvious search function? I have to go digging through, and think about whether my issue is a function, syntax, or special variable? I prefer the other.
-QM
--
Quantum Mechanics: The dreams stuff is made of
| [reply] [Watch: Dir/Any] |
|
| [reply] [Watch: Dir/Any] |
Re^3: Bookmarklet to show deeplinks in perldoc.perl.org
by Anonymous Monk on Jun 18, 2019 at 19:47 UTC
|
At the time, the last evidence of maintenance was adding Perl 5.26 at the end of 2017, and there was no evidence of anyone fixing bugs since 2011 (several of which have yet to be fixed so far, and many new ones now added, but we'll see what the next iteration brings). The revamp work was entirely unknown aside from vague promises of "an update" until last week; so until then I would have agreed with "moribund", and indeed that was the motivation for perldoc.pl, but that is clearly no longer apt. | [reply] [Watch: Dir/Any] |
|
| [reply] [Watch: Dir/Any] |