Re: Creating Books and Manuals with Perl

[ash]

Anyone have any guides to documenting Perl with LaTeX?
I've got two books on LaTeX written by Leslie Lamport and it doesn't exactly come clear how to embed code (except pascal) into LaTeX.

-- 
ash/asksh <[e-mail]>

[Arien]

What you're looking for is the verbatim environment. It's similar to <code>...</code> in HTML and is written like this:

\begin{verbatim}
#!/usr/bin/perl

for (1..10) {
    print "Hello, world\n";
}
\end{verbatim}

The result would look like this:

#!/usr/bin/perl

for (1..10) {
    print "Hello, world\n";
}

Also, you may find some of the tutorials here useful if you're in a rush to see if you and LaTeX get along.

— Arien

[weini]

As I mentioned earlier I use noweb for mixing Perl code and documentation. There's a onepage Guide to using noweb at http://www.eecs.harvard.edu/~nr/noweb/onepage.ps.
I am not good at LaTeX but I understand it and was able to start my documentation work after a few minutes of reading. If you know LaTeX well, you'll be even faster.

What I like in using noweb is the fact that I have just one file to edit. I can then extract the documentation (html, ps, pdf) and the several other files (e.g. perl-script, perl-module, sql-script, makefile). UC: I'm a real fan ;^)

weini

[bronto]

Since you say you have two Lamport's books I suppose you don't have The LaTeX Companion. It explains in good detail a lot of useful LaTeX packages. I definitely reccommend it.

Ciao!
--bronto

# Another Perl edition of a song:
# The End, by The Beatles
END {
  $you->take($love) eq $you->made($love) ;
}

[crenz]

I recommend getting hold of the listings package.

It allows for short code snippets as well as long listings and file inclusions, source highlighting, supports a few dozen languages etc. etc. and even has a switch to display/not display POD in perl files.

Hmm... it might be a nice project to include that in pod2latex...