===============================================================
README.TXT         2001-10-28
===============================================================

RedMon - Redirection Port Monitor
for Windows 95/98, NT 2000 and 4.0.
Version 1.7

========
Overview
========
 The RedMon port monitor redirects a special printer port
 to a program.  RedMon is commonly used with Ghostscript and 
 a non-PostScript printer to emulate a PostScript printer,
 or with Ghostscript as a PDF writer.

 RedMon can be used with any program that accepts data on
 standard input.

 Using RedMon you create redirected printer ports.  If you connect a
 Windows printer driver to the redirected printer port, all data sent
 to the redirected port will be forwarded by RedMon to the
 standard input of a program.  This program is then responsible
 for processing the data and producing new output.

 A PostScript Windows printer redirected to a RedMon port can 
 be shared on a network.
 When this printer is configured to use Ghostscript and a non-PostScript
 printer, it appears as a PostScript printer to other network clients.

 RedMon can create a PDF writer using a PostScript printer driver 
 and the Ghostscript pdfwrite output device.

 Configuring `RedMon` is not a job for novices.

 RedMon supports Windows 95/98, Windows 2000 and NT 4.0.

============
Installation
============
 To read the documentation, run 'winhelp redmon.hlp'
 To install, run 'setup.exe'

=================
RedPr - RED PRint
=================
 A command line utility "redpr" is included to copy files to
 a printer.  This is similar to the GSview "File | Print File"
 or the DOS "COPY /B filename LPT1:".
 RedPr copies files to a specified Windows printer queue.
 The RedMon install program does not install RedPr.
 If you want to use RedPr, you will need to copy it to
 a directory on your path.


 Syntax is 
   redpr [-P"printer"] [-pport] [-b] [-h] [-v] filename ...
     -P"printer"  Specify target printer
     -pport       Target port
     -b           Bi-directional.  Attempt to read from printer.
     -h           Help
     -v           Verbose.  Display debugging messages.

 Printer names may be either the Windows 95/NT printer name
 such as "Apple LaserWriter II NT", or a port name such
 as "LPT1:".   If a port name is used, redpr will replace it 
 with the name of the first printer to use that port.
   
 Examples:
     redpr -P"Apple LaserWriter II NT" file.ps
     redpr -pLPT1: file.ps
     redpr file.ps

 Actually, -P and -p are interchangeable.  RedPr first looks
 for a printer with the given name. If that fails it tries to 
 find a printer which uses the given port.  The default printer 
 will be used if no printer or port is specified.

 Bi-directional mode works under Windows 95 with a communications port.
 It will not work at all under Windows NT.
 When using bi-directional mode, the file is sent directly to
 the printer without being spooled.
 Bi-directional operation is slow because for each 4096 bytes written 
 to the printer, an attempt is made to read from the printer,
 which usually blocks for a few seconds until a timeout occurs.

 If you get sick of typing in long printer names, make a batch
 file wpr.bat which contains
   @redpr -P"Apple LaserWriter II NT" %1 %2 %3 %4
 with your appropriate printer name.

=========================
RedRun - Redirect and Run
=========================
 RedRun copies standard input to a temporary file, then runs a 
 program.  RedRun is designed to link RedMon with a program that 
 wants its input in a file, not stdin.
 
 An example for Windows 95 is running GSview.
 In RedMon, the program to run would be
   c:\gstools\redrun.exe
 and the arguments would be
   c:\gstools\gsview\gsview32.exe %1

 For Windows NT, it is recommended that you DO NOT USE RedRun 
 to start GSview.  RedRun and any program started by it will 
 have the same security attributes as the print spooler.
 Apart from the fact that GSview won't work because it can't
 find its initialization file, using RedRun under Windows NT
 is a security risk.

 When started, RedRun will write standard input to a 
 temporary file, until it reaches end of file.  It will then 
 start the specified program.  RedRun will wait until the 
 specified program terminates, then will delete the temporary
 and terminate itself.

==========================
RedFile - Redirect to File
==========================
 Copy standard input to a named file.
 RedFile can be used to capture printer output redirected by RedMon.

 Usage: redfile filename

 Example:
   echo test | redfile testfile.txt
   echo test > testfile.txt\n\
 These are equivalent, but when using RedMon you can't use the
 latter because '>' redirection isn't available.

 You can place an integer format specifier in filename to
 create numbered files.  For example
   redfile test%04d.txt
 First use will write test0000.txt, second use test0001.txt.

 You could could connect a printer to FILE:, but you keep getting
 a prompt for the filename.
 Instead of using RedMon and RedFile, in Windows 95 you can edit
 win.ini [Ports] to add a named file.  This might not work under
 Windows NT.

 For Windows NT, if RedFile is started from RedMon, it will run 
 with the security attributes of the print spooler.
 Any files created by RedFile might not be readable by the
 user who started the print job.

============
Translations
============
 Thanks to Michael Basler for the German translation,
 to Cyrille Chevallet for the French translation, and 
 to Ulf Axelsson for the Swedish translation.

=======================
Copyright and Licensing
=======================
  Copyright (C) 1997-2001, Ghostgum Software Pty Ltd.  All rights reserved.

 This file is part of RedMon.

 This program is distributed with NO WARRANTY OF ANY KIND.  No author
 or distributor accepts any responsibility for the consequences of using it,
 or for whether it serves any particular purpose or works at all, unless he
 or she says so in writing.  Refer to the RedMon Free Public Licence
 (the "Licence") for full details.

 Every copy of RedMon must include a copy of the Licence, normally in a
 plain ASCII text file named LICENCE.  The Licence grants you the right
 to copy, modify and redistribute RedMon, but only under certain conditions
 described in the Licence.  Among other things, the Licence requires that
 the copyright notice and this notice be preserved on all copies.

     Author: Russell Lang, Ghostgum Software Pty Ltd
   Internet: http://www.ghostgum.com.au/

==============================================================

