From: garrett@netcom.com (Garrett D'Amore)
Newsgroups: comp.os.linux.announce
Subject: vtprint 1.1
Date: 2 Jan 1994 18:03:12 +0200
Approved: linux-announce@tc.cornell.edu (Lars Wirzenius)
Message-ID: <2g6r80$33e@klaava.Helsinki.FI>

Hello, I am releasing vtprint 1.1 to the general public today.  (Version
1.0 was never released to the public, and was called "lprint"  -- it was
used exclusively at the Haas School of Business at UC Berkeley.)

This program acts as a pipe -- drop in replacement for lp/lpr -- to
print files to a printer attached to your vt100 or compatible emulator.
I use it to print files directly from my remote Unix account to my
printer located at home -- attached to my PC -- I use Telemate as my
emulator -- tho' others are better... :^)

Anyway, the file is available for anonymous ftp download at
netcom.com:/pub/garrett/vtprint.tar.gz.  It is compressed with gzip,
so use gunzip to decompress it.  Untar the resulting file in a source
tree, such as /usr/src.  It will create a dir called vtprint.  You
should read the README file, the Makefile, and the man page before 
doing anything else.  (You will probably want to read over the Makefile
and change things to your taste/installation.)

	That's about it -- 

		Garrett D'Amore (out of work Linux hacker/student)
		garrett@netcom.com

Here's the README file in all it's glory: :^)
---------------------------------------------------------------------------
This is the README file for vtprint 1.1.  Please read it through completely
before you try to use it.  (This file is short -- I promise!)

>>> WARRANTY DISCLAIMER <<<

NO WARRANTY.  User agrees to indemnify author from any claim of damage or 
loss arising from the use of or inability to use this program.  In simple
English, USE THIS PROGRAM AT YOUR OWN RISK!

>>> COPYRIGHT INFORMATION <<<

vtprint is copyright 1993 by Garrett D'Amore, but you (the user) are given
a license to freely redistribute, use, or modify this program, so long as
any copyright notices are included and left intact.   Of course, if you
modify this program or fix any bugs, I'd appreciate it if you let me know,
so that I can incorporate such changes into the master source tree.

>>> DESCRIPTION <<<

vtprint is a simple C program that filters output to a printer attached
to a VT100 terminal or emulator.  This allows you to print a file on your
printer at home (for example), directly from your Unix account -- which may
be on a machine far away and not otherwise connected to your printer.

>>> COMPILING VTPRINT <<<

First of all, you need to compile the program on a host -- probably Unix,
though you could conceivably compile and use it on just about any operating
system -- everything is standard C -- the only assumptions in the code are
the values of certain characters -- escape and formfeed mainly.

You can compile the program by doing "make" or "make all" from inside the
directory where you have the source code.  The Makefile assumes you have
GCC as your compiler.  If this is not the case, you can change it in the
Makefile easily enough.  After you have compiled a binary and tested it
per the next section, you can do "make install" to install it.  (You will
need to be root to do this -- and I recommend you check the Makefile
over -- especially the target directories.)

>>> USING VTPRINT <<< 

After you have compiled vtprint, connect to your host from your VT100 or
emulator.  Make sure you have a printer attached.  (On DOS systems you
should probably connect it to LPT1.  Under Windows, the printer used will
be the "default" printer listed in the Printers Control Panel.)  Assuming
everything works, try printing out this file by typing "vtprint README".
If all is well, your printer will begin printing.  If not, then your 
terminal emulator probably doesn't support the needed escape sequences, or
something is not connected correctly.  Check your connections, and try
a different emulator program if you can.  There are some listed in the
manual page.

Assuming everything worked okay, read the man page.  Just about everything 
is documented there.  You can probably start using vtprint in place of
lpr or lp, as long as your files are ASCII and do not include binary data.
(Binary files might cause your terminal emulator to puke on you.)

>>> CONCLUSION <<<

Well, that's it.  I hope you enjoy using vtprint.  I have found it very
useful, myself.  I welcome your comments, success reports, and monetary
donations.  :^)  (I'm a starving student, btw.)  You can reach me at 
the following addresses:

	Internet: garrett@netcom.com
	
	Postal: Garrett D'Amore
	 	2540 Polk Ave.
		San Diego, CA 92104

Thanks again, and happy computing!

			Garrett D'Amore 12/28/93

--
Mail submissions for comp.os.linux.announce to: linux-announce@tc.cornell.edu
PLEASE remember Keywords: and a short description of the software.
