jv@mhres.mh.nl (Johan Vromans) (01/20/90)
INTRODUCTION
============
The Perl 3.0 Reference Card and Reference Guide
Revised: January 20, 1990
The Perl Reference "Card" and Guide are typeset quick reference guides
to Larry Wall's Perl program.
The Reference Card consists of 5 pages of 3-column text, and contains
a concise description of all perl 3.0 statements, functions, variables
and lots of other useful information. The purpose of the Reference
Card is to aid in the use of Perl, to look up the syntax of specific
functions, statements and the meaning of built-in variables. It is
*NOT* a self-contained user guide - basic knowledge of the Perl
language is required. It is *NOT* complete - some of the more obscure
variants of perl constructs have been left out. But all functions and
variables are mentioned in at least one way they can be used.
The Reference Guide contains the same information as the Card, but it
is formatted in 8 pages of 2-column text. It should be printed
double-sided, stapled in the middle, folded, and cut to size to have a
16-page 3.5 x 8" booklet.
The Card and Guides are all based on Perl version 3.0, patchlevel 8.
The Reference Card and Guides are designed and created by Johan
Vromans. They are distributed in PostScript* format, since their
sources are maintained in a DeskTop Publishing System, and not
suitable for other processing. The Card should be printable on all
industry-standard PostScript printers, on US Letter (8.5 x 11") and A4
(21 x 29.7 cm) paper formats. The Guide comes in two formats: one for
US Letter and one for A4 paper format.
The Card and Guides are copyrighted by the author. They may be
reproduced, printed and distributed freely, as long as the original
author gets the credits, and the copyright notice is not removed from
the text. They may not be turned into a commercial product except with
written permission of the author.
Comments to both the Card and Guide are welcome, send them to the
author.
Some people are trying to create TeX and troff versions of the guides;
I've sent them the ascii text but didn't hear anything since :-( .
---------------------------- author info -----------------------------
Johan Vromans
Multihouse Research, Doesburgweg 7, 2803 PL Gouda, the Netherlands
tel. +31 1820 62911, fax. +31 1820 62500
email: <jv@mh.nl>
----------------------------------------------------------------------
I like to thank everyone who has helped me to get the job done, and to
get the results to you. Especially Paul O'Neill, Tom Christiansen, Ed
Moy, Edwin Kremer. And Larry Wall, of course, without whom I would
have spent lots of time annoying myself.
----------------------------------------------------------------------
PostScript is a trademark of Adobe, I assume.
HOW TO GET THE CARD AND GUIDES
==============================
Updated: January 20, 1990
The Reference Card and Guides are about 60K in size each (compressed
postscript). Unless stated otherwise, the names of the files are:
perl-refcard.ps.Z - for the Reference Card
perl-guide-us.ps.Z - for the Guide on US letter paper
perl-guide-a4.ps.Z - for the Guide on A4 paper format
If you want to participate in distributing, please let me know so I
can add your info to the list.
* Anonymous FTP (jpl-devvax.jpl.nasa.gov, 128.149.1.143):
directory pub/perl.3.0/doc .
* Anonymous FTP (sol.cs.ruu.nl, 131.211.80.5)
directory ~/DOC .
* UUCP (mhres)
directory ~uanon/perl3.0 .
For convenience, the files have been split in three parts each.
The names of the files on this system are:
refcard.ps.Z?, guide-us.ps.Z? and guide-a4.ps.Z?
with ? designating one of the parts 1, 2 or 3 .
After retrieving all thee parts for one file, concatenate and
uncompress to obtain the PostScript source.
Phone number is +31 1820 36514, 1200 baud only. Username "uanon",
password "uanon". Sample Systems (L.sys) entry at the end of this
message.
This phone number will *ONLY* accept this UUCP connection. It's
no use to try to login otherwise using this number.
* Email (from cs.ruu.nl)
European sites not having FTP access may retrieve the Reference Card
or Guides from the Rijks Universiteit Utrecht by sending an email
message to <mail-server@cs.ruu.nl> with contents
path <your_valid_return_address>
btoa
send DOC/perl-refcard.ps
send DOC/perl-guide-a4.ps
send DOC/perl-guide-us.ps
end
Please only retrieve the files you need, not just all of them.
Leave out the line with "btoa" if you prefer uuencoding.
Please use a domain-based return address, or you may loose out.
----------------------------------------------------------------
UUCP to mhres (the Netherlands, Europe):
1200 baud only (they didn't give me an extra TrailBlazer).
Add a line to your "L.sys" or "Systems" file as follows:
mhres Any ACU 1200 01820-36514 "" \r in:-\r-in:-EOT-in:-\r-in: uanon ssword: uanon
The phone number is for use within the Netherlands. Use your local
equivalent to "+31 1820 36514" otherwise.
This dial-in telephone line will *ONLY* accept this UUCP
connection. It's no use to try to login otherwise using this number.
Enjoy! Johan
--
Johan Vromans jv@mh.nl via internet backbones
Multihouse Automatisering bv uucp: ..!{uunet,hp4nl}!mh.nl!jv
Doesburgweg 7, 2803 PL Gouda, The Netherlands phone/fax: +31 1820 62944/62500
------------------------ "Arms are made for hugging" -------------------------