A2PCText v0.2
by Erick Wagner

A2PCText is a command-line based program that is designed to work
in conjunction with the ApplePC emulator.  It's job is to extract
text screen images, both 40 and 80 column, from the "save state"
file that ApplePC produces and save these to a standard text file
for import into other programs (e.g., word processor, desktop
publisher).

A2PCTEXT is shipped as a compressed file (A2PCTEXT.ZIP) and consists
of three files: A2PCTEXT.EXE (the program), A2PCTEXT.DOX (information
file), and A2PCTEXT.C (source code).

To use the program, execute it with either two or three parameters.

  A2PCTEXT 4[0]|8[0] input_file [output_file]

The first parameter specifies the text mode or type of text screen
to extract from the "save state" file.  This parameter must be
numeric and begin with either a '4' (to indicate 40 column mode)
or an '8' (to indicate 80 column mode).  This parameter is required.

The second parameter specifies the name of the "save state" file
that was produced by ApplePC.  ApplePC does not automatically create
this file, you must use the appropriate option from the control panel
to create it.

The third, but optional, parameter specifies the name of a text file
to save the 40 or 80 column screen image.  If an output file is not
specified, output gets directed to "stdout" (standard out) which
usually displays to the console/screen.  You can use this feature
(not specifying the output file) as a preview option.  Output sent
to the screen can also be directed to a file by using the redirection
symbol (">") and a file name or piped ("|") to another process.  See
your MS-DOS reference manuals for information on I/O redirection or
pipes.

To make effective use of this utility, it is assumed that a
text-based application (either 40 or 80 column) was running at the
time a "save state" file was created.  Otherwise, random garbage may
be present in the text screen memory and the screen shot you attempted
to capture will not be present.

This program can be freely distributed but NOT sold.  The =ONLY=
individual or organization that may =charge= a nominal handling fee
for the distribution of this application is Joe Kohn of Shareware
Solutions II.  Distribution of this application must include all
three files.

Questions and Comments (constructive please!) can be sent to:

  wagnere@netcom.com
  wagnere@aol.com
  e.wagner10@genie.com

A2PCText Copyright 1996 by Erick Wagner