I was thinking for specific-version links, allowing doc://5.8.3/perlre, and making a drop-down in user settings to set your default.
There is a defined behavior for use on any string not matching /^perl/: assuming it is a function. Thus, Time::Local links to the documentation of the (nonexistant) function Time::Local; if you wanted the documentation of that module, you should have said Time::Local. (Core modules are on cpan.) I may change that to output some plain ol text, as it's pretty clearly an error. I may even extend the DWYMery to link to the POD for that module, though I'm worried that we'll get into places where we are unable to do what you meant: is doc://open documentation on the module open, or the function open? (Yes, there is one of each.)
Warning: Unless otherwise stated, code is untested. Do not use without understanding. Code is posted in the hopes it is useful, but without warranty. All copyrights are relinquished into the public domain unless otherwise stated. I am not an angel. I am capable of error, and err on a fairly regular basis. If I made a mistake, please let me know (such as by replying to this node).
-
Are you posting in the right place? Check out Where do I post X? to know for sure.
-
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big>
<blockquote> <br /> <dd>
<dl> <dt> <em> <font>
<h1> <h2> <h3> <h4>
<h5> <h6> <hr /> <i>
<li> <nbsp> <ol> <p>
<small> <strike> <strong>
<sub> <sup> <table>
<td> <th> <tr> <tt>
<u> <ul>
-
Snippets of code should be wrapped in
<code> tags not
<pre> tags. In fact, <pre>
tags should generally be avoided. If they must
be used, extreme care should be
taken to ensure that their contents do not
have long lines (<70 chars), in order to prevent
horizontal scrolling (and possible janitor
intervention).
-
Want more info? How to link
or How to display code and escape characters
are good places to start.
|