My only comment is that it would be nice to be able to search the documentation
without having to use the "site:" prefix to find where a function is found in
the documentation. More often than not, I end up searching for how to do ....
Since I am not using PDL enough to memorize where everything is located.
Example - How does one write a pdl to a file, off the top of my head I would
use dog->, but I know that there are others and I still can't remember if dog
is actually in the core PDL (use PDL;) or in one of the sub modules.
CLIFF SOBCHUK
Core RF Engineering
Phone 403-262-4010x3618169
www.ericsson.com
"The author works for Telefonaktiebolaget L M Ericsson ("Ericsson"), who is
solely responsible for this email and its contents. All inquiries regarding
this email should be addressed to Ericsson. Nortel has provided the use of the
nortel.com domain to Ericsson in connection with this email solely for the
purpose of connectivity and Nortel Networks has no liability for the email or
its contents. The web site for Ericsson is www.ericsson.com."
This Communication is Confidential. We only send and receive email on the basis
of the terms set out at www.ericsson.com/email_disclaimer
-----Original Message-----
From: Matthew Kenworthy [mailto:[email protected]]
Sent: May-04-10 7:30 AM
To: David Mertens
Cc: perldl
Subject: Re: [Perldl] Editing the Wiki
To add gasoline/petrol to the fire, I'll suggest something further:
I think treating the PODs as the 'ground truth' documents from which all other
formats are generated could be the way to go. So I suggest
this:
Remove the half-completed PDL books from the wiki pages completely.
They're a great attempt, but they were written with herculean effort before the
days of wikis, usually based as latex documents with the included figures.
The books contain tons of great information, but it can be a slog wandering
through the three books and picking out where, for example, that pdim()
function was defined. I'd be willing to go through the PDL books, pull out the
great examples and POD ify them, so that the PODs can be wikified automatically.
My only question would be how to deal with the images in the books - is there a
suitable way to link the images in the POD text so that they are automatically
added into wikified and html'ed pages?
Just a thought....
Matt
--
Matthew Kenworthy / Assistant Professor / Leiden Observatory Niels Bohrweg 2
(#463) / P.O. Box 9513 / 2300 RA Leiden / NL
_______________________________________________
Perldl mailing list
[email protected]
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
_______________________________________________
Perldl mailing list
[email protected]
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
