Text/2 PDF, version 2.1
=======================


1. What Text/2 PDF does
-----------------------

Text/2 PDF converts a text file into a PDF 1.1 file, which is compatible
with any Acrobat Reader available for OS/2.

For infos on PDF (portable document format) see Adobe <http://www.adobe.com>.


2. How to use Text/2 PDF
------------------------

To use Text/2 PDF simply enter

  TEXT2PDF.EXE


Examples:

  TEXT2PDF /?

    Displays the help screen

  TEXT2PDF

    Opens a file open-dialog, if possible, to select an input file. If a file
    is selected, then the file extension of the output file will become .PDF.
    Select Cancel or close the dialog window, by using its menu, to use STDIN
    and STDOUT. 

  TEXT2PDF -N -A4 > TextFile.PDF

    No file open-dialog, and uses STDIN and STDOUT for unattended use. This 
    option restores the default behaviour of text2pdf version 1.1.1, without
    a specified input file. The paper size of the PDF file will be A4. The
    default paper size is Letter.

  TEXT2PDF C:\TextFile

    Creates a new file C:\TextFile.PDF, if the input file C:\TextFile exists. 
    Otherwise a file open-dialog can be used to select this input file or any
    other input file. The initial working directory will be C:\.

  TEXT2PDF C:\TextFile /N

    Creates a new file C:\TextFile.PDF, if the input file C:\TextFile exists.


  TEXT2PDF -W TextFile -O

    Overwrites or creates a new file TextFile.PDF and opens TextFile.PDF by
    using its default WPS association, if the input file TextFile exists.

  TEXT2PDF TextFile PdfFile /O

    Overwrites or creates a new file PdfFile, if the input file TextFile 
    exists or is selected.

  TEXT2PDF Manual*Chapter*17*.* PdfFile /O

    Overwrites or creates a new file PdfFile, if Manual*Chapter*17*.* matches
    the name of exactly 1 existing file.

  TEXT2PDF /P TextFile > PdfFile

    Restores old STDOUT-behaviour when an input file name was specified


See text2pdf.html for further information.


3. The OS/2 versions
--------------------

Version 2.1 (OS/2-specific release)

Dropped different PM version in the PM subdirectory. That subdirectory can be
deleted.

The option -W or -W supports more files.

Minor documentation updates.


Version 2.0 (OS/2-specific release)

Added support for / (prefix character of options).

Added options -? and -H, equal to -h.

Added option -a3, -a4 and -a5, euqal to -A3, -A4 or -A5.

Added option -i, equal to -I.

The most important output of the option -h is reformatted for a screen size
of 80x25.

New option -N or -n, no file open-dialog when there's no specified file name.
By using this option STDIN and STDOUT will be used, but without having to
close or cancel the OS/2 PM dialog.

New option -O or -o, allow to (try to) overwrite an existing output file.

New option -P or -p, print output to STDOUT instead of a file. This restores
the way previous versions worked when there was a specified input file name.

New option -W or -w, the default WPS association of an output file name is
used to open this output file, unless STDOUT was used.

If an input file name is specified, then the extension of the output file
name will be changed to "PDF".

New possibility: optionally specify an own output file name. If the number of
file names exceeds 2, then only the last 2 file names will be used.

The input file name supports wildcard characters, but only if the number of
matching input file names is 1. To process more files, perhaps try something
like this OS/2-command: FOR %F IN (*.TXT) DO (TEXT2PDF.EXE /O %F)

If the extension of an output file isn't PDF, then the file type of the
output file will be set to Acrobat Document

Possible bug fix: only the last specified input file name is opened as the
input file name.


Version 1.1.1

The sourcecode was found in txtpdf11 for OS/2 package done Rolf Lochbuehler.
It is the same as the one found at 

http://www.ep.cs.nott.ac.uk/~pns/pdfcorner/text2pdf/ 

and compiled it for OS/2. It did not require any modification to compile.

I added A5 as an additional paper format and increased the version number
from 1.1 to 1.1.1.

The source can be compiled with VAC or GCC (did not try Watcom).
The included binary was created with VAC 3.0.8.


4. Files in this distribution
-----------------------------

text2pdf.exe  - The executable for OS/2
readme        - This file


5. Miscellaneous
----------------

Please send questions releated to Text2Pdf directly to the original 
author of the program. His name is Phil Smith <pns@cs.nott.ac.uk>. 

See text2pdf.html and http://www.ep.cs.nott.ac.uk/~pns/pdfcorner/text2pdf/ 
for further information.

Herwig Bauernfeind, 08.08.2004
herwig.bauernfeind@aon.at
