merlyn,
From my experience on #perl (Freenode), my biggest explanation for "on-line" documentation is the ability to search for what you are looking for. It doesn't help to have the documentation locally if you don't know what document you are looking for.

Personally, I don't have any trouble using perldoc perltoc and perldoc -q "question" to help find what I want, but I have seen where the search function helped others. Admittedly, I have not played with my local documentation all that much to determine how easy/hard it would be to set up similar local functionality.

---

---

• 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.