Re: Roll Call

> Date: Fri, 08 Nov 2002 19:07:47 +0000
> From: Richard Nuttall <[email protected]>
>
> Useful List. I presonally use a combination of documentation for 
> programming, and
> find the Perl documentation more difficult to use than many. Generally, 
> I'd like
> an online 'database' of documentation.

That'd be nice.  I personally like Wolfram's mathworld
(mathworld.wolfram.com) (Weisstein) setup.  It's heavily
cross-referenced, and indexed by topic.  It has a good search tool as
well.

It might not be so great for a single documentation project.  It works
well for hugantic sums of information, possibly not specialized.

> perlfunc, et al. are OK for a "what parameters do I use for this 
> function", but for
> example code, updates, etc, it has to be online.

It's extremely nice to have a local copy though.  Maybe something that
can easily be synced?  Or a, um, perl script to look it up quickly
online.  Both?

> I expect to be mostly a lurker on this list, but am prepared to put some 
> effort into any online documentation effort. Presumably this would be 
> written in Perl6 ? Actually I mostly use PHP
> currently (again, this has an excellent online reference manual, with 
> places for people to add
> sample code snippets), since I find it lighter weight and more 
> integrated for dynamic webpage
> generation when linked to a database.

You know it would be sacreligious to do it in PHP though...

Perl 5, until Perl 6 is stable and fast enough.  Then switch over.

Of course, we do it all in POD.  Then use various types of docs.  The
online part, perhaps a TexInfo (has anybody written a pod2texi?).
L<...> would have to be able to refer to more than manual pages.  Just
a different interpretation of the "...".

Yeah.  I like that the best.  Have a big bunch of small to medium
sized POD pages, cross-reference them together, and convert them to
web, texinfo, man, and all of that.

Extensions?  Caveats?

Luke