Questions regarding Makefile.PL

2003-09-16 Thread Yehuda Berlinger
First of all, I may be trying to do the wrong thing, so set me straight. I 
am having trouble with the installation. I am trying to decypher 
ExtUtils::MakeMaker man pages.

I am creating a distribution for 'Pod/Index.pm' and 'podindex' (a perl 
exe) .

My directory looks like:

Changes
Index.pm.PL
Makefile.PL
MANIFEST
Pod/Index.pm.unconfigured
podindex
README
t/1.t
I want 'podindex' to be installed into $..BIN. Got that.

I want Index.pm.PL to run and create Pod/Index.pm out of 
Pod/Index.pm.unconfigured . Got that. Actually what I want is for 
Pod/Index.pm.PL to run to create Pod/Index.pm out of 
Pod/Index.pm.unconfigured . How do I do that?

I want 'Pod/Index.pm' to be installed into somewhere. Should it go into 
..LIB/*/Pod/Index.pm, ..LIB/site_perl/*/Pod/Index.pm or 
..LIB/vendor_perl/*/Pod/Index.pm ?

I want the pod in podindex and Index.pm.unconfigured to be manified into 
... uh what? And how would I do that?

Yehuda


RFC: Pod::Index

2003-09-07 Thread Yehuda Berlinger
As long as I'm writing, I might as well ask the group:

I have created an ... extension to perlindex/tkpod. Instead of doing a full 
text search, it searches for the table of contents on pods and returns them 
as phrases, e.g. "Assigning to variables", "Slices of Hashes", etc...

It then builds some indexes, and presents a menu, just like perlindex, but 
of these phrases (like a table fo contents, or like a real index) and their 
locations, taking you to the exact line number in the appropriate pod.

The phrases are sorted by shortest (in terms of number of words), and then 
alphabetically.

The phrases are currently extracted by searching for =head* or =pod, but 
the facility is already built in to look for the long existing, but 
currently dormant, X<...> pod escape specification. This means that all pod 
documentation, assuming that this gets off the ground, should add X<...> 
whenever it wants to add itself to the table of contents.

It works for perlindex and tkpod, and soon will for perldoc.

First of all, any uphill battles here? Has anyone done anything like this?

Second, the natural name for this is Pod::Index, which is taken by one 
Kenneth Albanowski, whose email box is stuffed and whose url doesn't work. 
I would be happy to coordinate efforts with him. Should I use a different 
name? Does anyone know how to reach him? Can I take over the name?

The full (very) alpha version will be available for upload/download soon, 
unless there is any objection.

This is my first public contribution, so forgive me for any protocol erros 
in this email, and set me straight.

Yehuda Berlinger


Trying to reach Kenneth Albanowski

2003-09-07 Thread Yehuda Berlinger
I'm trying to reach Kenneth Albanowski, author of several Perl modules, 
about one of them he is supposedly developing. The home page and the email 
address on CPAN do not work! Does anyone know how to contact him, e.g. a 
working email or url, phone, anything? Kenneth, are you out there?

Yehuda