Micro-HOWTO set up perl.info for Emacs21 cperl-mode on woody
Micro-HOWTO set up perl.info for Emacs21 cperl-mode on woody
# To install perl doc info files needed by cperl-mode (not included in
# woody) download and extract the files; as of this version there are 33
# perl and 449 pm files (you don't need the big unsplit files, or the
# texi files (sources))
wget CPAN/modules/by-authors/id/KRISHPL/perl-5.6-info.tar.gz
# (as root)
mkdir /usr/share/info/perl-5.6
# [copy files in (gzip for size)]
install-info --section "Development" "Development" --description="perl - Practical Extraction and Report Language" /usr/share/info/perl-5.6/perl.info
install-info --section "Development" "Development" --description="Perl Modules" /usr/share/info/perl-5.6/pm.info
# then go hand-edit the dir file:
emacs -nw /usr/info/dir
# so the the Perl and Pm lines look like this:
# (adding "perl-5.6/" twice and "Module List" immediately following paren and before period
* Perl: (perl-5.6/perl). Perl - Practical Extraction and Report Language
* Pm: (perl-5.6/pm)Module List. Perl Modules
# finally, change the value of variable cperl-info-page to perl-5.6/perl
M-x describe-variable cperl-info-page
# (then select 'customize' in the help window, edit, and save)
Remarks:
There's probably a better way to do this; not being an expert with
Emacs and info and being unable to track down any info on the web, I
just had to wing it. At least c-h f (cperl-info-on-current-command)
now works.
I put the info files in their own subdir since there were so
many. This was likely a mistake; it makes the process more difficult
-- I couldn't figure out how to get install-info to do the right thing
so I had to follow up by hand-edited info's dir file. Since cperl-mode
doesn't use the pm info files anyway, it would be more streamlined to
omit them, leaving only 30-odd files which could be placed in
/usr/share/info without creating a subdir -- this might eliminate the
need to hand-edit the info dir file and would not require changing
cperl-info-page. To spell it out, after copying just the perl.info
files into /usr/share/info, this would be the last step:
install-info --section "Development" "Development" --description="perl - Practical Extraction and Report Language" /usr/share/info/perl.info
--
Tod Hagan
Campton, NH
tod@bondcliff.com
Reply to: