Re^3: Request for an update to: What shortcuts can I use for linking to other information?

Yes, marto. I think it's fair to say, I was so focused on the tree. I was unable to see the forest. I regret not having stepped away, as I normally would have. Before responding. :/

But then again. I also think that clarity works both ways. IMHO the man page shortcut thing should at least be better clarified on the What shortcuts can I use for linking to other information? page. Even if no other changes to it, are on the horizon. No?

Best wishes.

--Chris

#!/usr/bin/perl -Tw
use Perl::Always or die;
my $perl_version = (5.12.5);
print $perl_version;

Comment on Re^3: Request for an update to: What shortcuts can I use for linking to other information?

Replies are listed 'Best First'.
Re^4: Request for an update to: What shortcuts can I use for linking to other information? by marto (Cardinal) on Dec 04, 2013 at 20:40 UTC
I agree, IMHO the existing functionality should be better documented. Perhaps the logic of what `[man://foo]` does could be addressed.	[reply] [d/l]
Re^5: Request for an update to: What shortcuts can I use for linking to other information? by jdporter (Paladin) on Dec 06, 2013 at 15:15 UTC
As someone who stands ready and willing to make the suggested corrections, I have to tell you both that I have not been able to glean what is wanted, from this thread. Please, one of you, write up a very concise statement of the fix(es) wanted. I am not inclined to go reading all of the references you've given, even the other thread(s?) here on PerlMonks, in order to make sense of what you're talking about. And taint, I strongly encourage you to finish your research and thoughts before posting. Writing things like "just a sec, I'll check...better, I'll list them..never mind" doesn't help anyone, including you. Remember that these posts will be here for years. If your post is barely comprehensible now, it will be entirely incomprehensible in 5 years. Thanks. I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.	[reply]
Re^6: Request for an update to: What shortcuts can I use for linking to other information? by marto (Cardinal) on Dec 06, 2013 at 15:27 UTC
This was indeed a struggle. taint discovered that using `[man://cmdname]` did not do the same thing as typing `man cmdname` on their freeBSD box, which surprised them. They had not noticed that the `[man://]` links generate a url with `&manpath=SuSE+Linux/i386+11.3`, specifying the OS/distro man pages to display results for. In What shortcuts can I use for linking to other information? it states "Unix man pages:". For the sake of reducing any ambiguity I think that the text associated with this section should state that the lookup will check for a particular OS/distro, and name it explicitly. A more complicated change would be to alter how `[man://]` links work so that users could specify which OS/distro was linked to, however since this could be achieved using the current method for linking e.g. `[http://foo.com?bar=baz\|man baz]`, this is overkill IMHO.	[reply] [d/l] [select]
Re^7: Request for an update to: What shortcuts can I use for linking to other information? by jdporter (Paladin) on Dec 06, 2013 at 18:44 UTC
Re^8: Request for an update to: What shortcuts can I use for linking to other information? by marto (Cardinal) on Dec 06, 2013 at 22:54 UTC
Re^8: Request for an update to: What shortcuts can I use for linking to other information? (default OS) by tye (Sage) on Dec 06, 2013 at 23:09 UTC
Some notes below your chosen depth have not been shown here
Re^8: Request for an update to: What shortcuts can I use for linking to other information? by taint (Chaplain) on Dec 06, 2013 at 22:53 UTC
Some notes below your chosen depth have not been shown here


Come for the quick hacks, stay for the epiphanies.
	PerlMonks