Documentation problems

[Roger Johansson]

I downloaded "The Mason book" as a tar.gz file together with a .pl
file to compile the pod files into html files.
(I cannot afford to read the book online on a modem line)
From http://www.masonbook.com/book/ which is one of the links at
learn.perl.org

I have problems compiling this book. The book_as_html.pl file seems
not to work. I try to run "perl book_as_html.pl" in the dos window, in
the same folder where I have unpacked the tar.gz file.

I first got a message that it could not find the sample.pm file, so I
copied it to the folder the .pl file seemed to expect it to be.

The .pl file looks like this in the beginning:
........
#!/usr/bin/perl -w

use strict;

package MasonBook::ToHTML;

use Pod::Simple 0.96;
use base qw( Pod::Simple );

use File::Basename;
use File::Spec;
........

Then it said that the version and package check failed, in line 7 of
the script.

I changed the version number to the same as in the sample.pm file.

Then it said that the Sample class was empty and said there was a
fault in line 8.

Is there a better way to compile this book, or is there a way to
rewrite this script so it works?

 

[Gunnar Hjalmarsson]

I downloaded "The Mason book" as a tar.gz file together with a .pl
file to compile the pod files into html files. (I cannot afford to
read the book online on a modem line) From
http://www.masonbook.com/book/ which is one of the links at
learn.perl.org

I have problems compiling this book. The book_as_html.pl file seems
not to work. I try to run "perl book_as_html.pl" in the dos
window, in the same folder where I have unpacked the tar.gz file.

Hmm.. It's good that you are about to download some Perl reading, but
this seems to be a rather difficult way to start. Anyway, I gave it a
try on my W98 box, following these steps:

- Extracted the tar.gz file to a temporary directory
- Placed book_as_html.pl in the same directory
- It turned out that I needed to install these non-standard Perl
modules:
o Pod::Simple
o Pod::Escapes
o Image::Size
so I did (using CPAN.pm. Making CPAN work on Windows was a separate
exercise a while ago, but it's a very convenient way to install
CPAN modules.)
- Run the script like this:

perl book_as_html.pl --all --target C:\Mason --ext .html

Those steps resulted in something that is at least readable HTML. The
original file extension is .mhtml, but I don't know what the 'm' means.

Is there a better way to compile this book, or is there a way to
rewrite this script so it works?

How about simply saving the HTML pages onto your hard disk using your
browser? Or using Purl Gurl's script.

Another, much more basic, documentation advise would be to download
and install the bundle available at
http://www.indigostar.com/indigoperl.htm
That gives you the Perl documentation in HTML, Apache, PHP... And
it's *really* easy to install.

 

[Roger Johansson]

This script beneath my signature
will create simple html files rather than mhtml files. Clean, simple
and very efficient, compared to trying to fix programming errors
of others.

Great, thanks. Your script also gave me a method for fetching web
pages in general, which is something I am also interested in.

Thanks to Gunnar Hjalmarsson too, for his reply.

 

[James Willmore]

Purl Gurl wrote:

Anyone know how to convert your domain / ip address to ipv6?

You could check this link out. There is a reference to the RFC for
IPV6 in the document, which may help you out. I realize that it
pertains to Linux, but it's a good place to start.

http://tldp.org/HOWTO/Linux+IPv6-HOWTO/

<snip>

HTH

--
Jim

Copyright notice: all code written by the author in this post is
released under the GPL. http://www.gnu.org/licenses/gpl.txt
for more information.

a fortune quote ...
To be intoxicated is to feel sophisticated but not be able to say
it.