about summary refs log tree commit diff stats
path: root/utils/lpansi/README
diff options
context:
space:
mode:
Diffstat (limited to 'utils/lpansi/README')
-rw-r--r--utils/lpansi/README82
1 files changed, 82 insertions, 0 deletions
diff --git a/utils/lpansi/README b/utils/lpansi/README
new file mode 100644
index 00000000..252614a8
--- /dev/null
+++ b/utils/lpansi/README
@@ -0,0 +1,82 @@
+README for lpansi.c v2.1					10/20/1994
+
+		   Print to ANSI printer on local terminal
+
+ SYNOPSIS
+      lpansi [options] [file-list]
+
+ DESCRIPTION
+ The Problem
+      UNIX supplies a printing program called lp <filename> which allows the
+      user to print a text (or any really) file to a printer.
+      Unfortunately, that printer is attached to the UNIX server which is
+      not where the user usually is.  In my case, it is about 230 miles
+      away.  I needed a similar program that would allow me to print to my
+      home printer.
+
+ The solution:
+      The VT100 standard defines a printer on and off escape sequence.
+      [FYI: esc[5i is printer on, esc[4i is printer off.] Lpansi is a VERY
+      simple program that issues a printer on sequence, opens the files sent
+      as an argument, reads it character by character, echos it to stdout
+      (now your local printer) and ends by sending a form feed and printer
+      off command.
+
+ Usage:
+      I had several purposes in mind when I wrote this.  The first was to
+      find a way to replace lp in a gopher client I had with something that
+      would print at home.  I also wanted to be able to print text files to
+      my home printer directly from the UNIX prompt.  A natural extension of
+      this is to add it to LYNX, and other printing clients as your printer
+      command.
+
+ Syntax:
+      This program accepts miltiple filenames as an argument.  If no
+      filename is present, lpansi will use standard input.
+
+ Thanks:
+      Thanks go to Michael Seibel on the PINE development team for helping
+      me find the correct ANSI codes to turn off the printer. I found out
+      later that PINE distributes a similar program called ansiprt which is
+      supposed to do the same thing.  Here, the source code is provided so
+      you may incorporate the concept directly in your program.
+
+
+ Options:
+	  -f  Form feed off, no form feed at end of each file
+	  -v  Verbose, prints helpful information for debugging purposes.
+
+ Disclaimer:
+      [Everyone has one so...] I make no promises whatsoever about how this
+      will work for you.  If you have VT100 and/or ANSI, it should work just
+      fine.  If it doesn't, quit using it.  :)	This program is free to use
+      and modify, but try to keep my name with it.  I don't do that much
+      cool stuff, so I need all the credit I can get.  Thanks.
+
+ AUTHOR
+      Written by Gary Day (gday@comp.uark.edu)
+
+ MODIFICATIONS
+      Version 1.1 Modified by Noel Hunter (noel@wfu.edu)
+      Version 2.0 Modified by Noel Hunter (noel@wfu.edu)
+      Version 2.1 Modified by Noel Hunter (noel@wfu.edu)
+
+ FILES
+      /usr/local/bin/lpansi
+
+ SEE ALSO
+      lp, lynx, pine
+
+ EXAMPLES
+      lpansi .profile
+
+      Will print the file named .profile to a printer attached to your
+      terminal.  NCSA Telnet, WRC Reflections for PC, and Kermit are known
+      to work.
+
+      In pine, use lpansi by typing "m" for "Main Menu", then selecting "s"
+      for setup.  Next, enter "p" for "Printer", and select "1. Printer
+      attached to IBM PC or compatible, Macintosh".  From then on, when you
+      choose print in pine, it will be sent to your terminal program and
+      attached printer.
+