The Wednesday 2004-11-03 at 14:51 -0600, Danny Sauer wrote:
No documentation found for "perlinfo".
It doesn't work. And 'pin' doesn't find it.
Argh. I typed perlinfo a bunch of times when I meant perlintro... Whoops. Sorry 'bout that.
Ah, ok, found that one :-)
If you do a "man perl", you'll get a list of lots of other docs that are also included, those sections are further described under "perldoc perltoc".
Ok - this document is 12858 lines long, a long, long plain file. It can not be searched easily, no _links_.
I like the '/' key, mostly because I live in vim. Surely your pager lets you search like that? The lack of links does suck, though. Read on...
Ah, yes, I know. '/' searches forward, '?' searches backwards, as in "less". By the way, the choice is quite counterintuitive on a non US keyboard. Linux still needs more internationalization effort... but that is a different issue :-) [browsable docs with links]
That's a limitation of the default pager. Wanna browse documentation for all the modules on your system easily? Install Pod::Webserver (it has a few deps, but they're all small), run "podwebserver", and point a web browser to http://localhost:8020/. If you scroll down to the perl_core_docs section, you'll have nice HTML versions of all those things, interlinked and easily read/printed/etc. It's not quite as cool as JavaDoc, but it's right up there. Use lynx (or links) if you want a terminal view.
Ahhhh... ok, I'll try.
To use a man page I already have to know its name.
Yeah, it takes a little time to get comfortable with what a module's likely to be called. The CPAN search site is about the easiest thing to use, aside from searching in the CPAN shell (yay regexp search).
Needs being on line... which I seldom are.
I'm spoilt: anything sort of that kind of environment and I start fidgeting O:-)
ActiveState has a nice IDE - Komodo - built on the mozilla framework. I think it's got a nice doc browser too (and you can use it with languages other than perl, if you like that kind of thing).
Another thing to look at :-) -- Cheers, Carlos Robinson