[comp.archives] The Perl 3.0 Refernce Card and Reference Guide comp.lang.perl

jv@mh.nl (Johan Vromans) (12/16/89)

Archive-name: perl-quickref/announce
Original-posting-by: jv@mh.nl (Johan Vromans)
Original-subject: Announcing the perl reference card [Repost]
Archive-site: tut.cis.ohio-state.edu [128.146.8.60]
Archive-directory: pub/perl/quickref
Reposted-by: emv@math.lsa.umich.edu (Edward Vielmetti)


			     INTRODUCTION
			     ============

	   The Perl 3.0 Reference Card and Reference Guide

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 4.

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.

All may be 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 <jv@mh.nl>.

			   HOW TO GET THEM
			   ===============

The Reference Card and Guides are about 60K in size each (compressed
postscript).

* Anonymous FTP (tut.cis.ohio-state.edu, 128.146.8.60):
  directory pub/perl/quickref

* UUCP (osu-cis):
  directory ~/perl/quickref

  The names of the files are:

	"refcard.ps.Z" for the Reference Card
	"guide-us.ps.Z" for the Guide on US letter paper
	"guide-a4.ps.Z" for the Guide on A4 paper format

  Here is a set of L.sys or Systems file lines suitable for osu-cis:

  #
  # Direct Trailblazer
  # NOTE: This modem is on a roll-over line with nothing to roll over
  # to, so it never gives busy signals.  If it rings forever, just keep
  # calling.
  #
  osu-cis Any ACU 19200 1-614-292-5112 in:--in:--in: Uanon
  #
  # Direct V.32 (MNP 4)
  #
  osu-cis Any ACU 9600 1-614-292-1153 in:--in:--in: Uanon
  #
  # Micom port selector, at 1200, 2400, or 9600 bps.
  # Replace ##'s below with 12, 24, or 96 (both speed and phone number).
  # NOTE: 9600 bps Micom access may not yet be operational, or may be flaky.
  #
  osu-cis Any ACU ##00 1-614-292-31## "" \r\c Name? osu-cis nected \c GO \d\r\d\r\d\r in:--in:--in: Uanon

  Modify as appropriate for your site, of course, to deal with your
  local telephone system.  There are no limitations concerning the hours
  of the day you may call.

* Anonymous FTP from the Rijks Universiteit Utrecht (praxis.cs.ruu.nl,
  131.211.80.6)

	~/DOC/perl-guide-a4.ps.Z
	~/DOC/perl-guide-us.ps.Z
	~/DOC/perl-refcard.ps.Z

* 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.

--
PostScript is a trademark of Adobe, I think.

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, J Greely, Edwin Kremer. And Larry Wall, of course, without whom I would have
spent lots of time annoying myself.

---------------------------- 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>
---------------------------------------------------------------------
--
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" -------------------------