Documentation for MAKEFAX, version 1.70
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
MAKEFAX is Copyright (C) 1993-1997 B.J. Guillot.  All Rights Reserved.

MAKEFAX is designed for use with the BGFAX shareware fax receiving/sending
program for DOS and OS/2.                    http://www.blkbox.com/~bgfax/


Description
~~~~~~~~~~~
MAKEFAX.EXE (DOS version) and MAKEFAX2.EXE (OS/2 version) will convert
ASCII text files, PCX files, or DCX files into FAX image format so that
BGFAX /SEND mode is able to send the information.

MAKEFAX will not run without the font file, BGFAX.FNT.  If the BGFAX
environment variable ("BGFAX") is set, the font file will be looked for
in that directory.  Otherwise, MAKEFAX will search the current directory.

MAKEFAX will handle form feeds (Ctrl-L, ASCII-12) in ASCII files, causing
a page break to occur, just as in a printer.  MAKEFAX will also properly
handle "TAB" expansions.

Usage
~~~~~

          MAKEFAX file1[+file2[+file3[+...fileN]...]]] outfile.fax [switches]
          MAKEFAX @filelist outfile.fax [switches]

                ************
                * Switches *
                ************

         /80   use 80-column mode when converting ASCII files

         /100  use 100-column mode (this is the default)

         /132  use 132-column mode when converting ASCII files

         /SP   SHORT PAGES--the fax will end at the last line of text rather
               than padding it out to a full length fax--saves thermal paper

       /PL:nn  PAGE LENGTH--in number of text lines on a piece of paper.
               (The default is /PL:66 for US-sized paper)

         /A4   Tells MAKEFAX to use 69 lines per page instead of 66.
               (/A4 is equivilant to /PL:69)

         /HR   force MAKEFAX to make HIGH-RESOLUTION faxes

         /LR   force MAKEFAX to make LOW-RESOLUTION faxes (this is the
               default for ASCII files, but sometimes PCX graphics are
               made for low-resoultion)

       /LM:nn  Sets "Left Margin" for ASCII conversions.  /LM:10 will
               force all text to be pushed over an additional 10 spaces
               to the right of the standard margin.

         /F0   Uses "computer looking" (jagged-edge) font rather than
               nice font when converting ASCII files.  See FNTEDIT.EXE
               (font editor) for a view of the fonts.  I can think of
               no need for using this unless you are just curious.

         /IE   Ignore Errors.  This tells MAKEFAX to keep converting away
               even if it encounters an error in one of the files.

     /PID:nnn  ProcessID number.  Useful if you are running multiple copies
               of MAKEFAX in a multitasking environment.  The nnn will be
               used when creating any needed temporary files so that there
               is no kind of sharing violation.  (See BGFAX.DOC for more
               details on this.  This switch is not needed unless more than
               one copy of MAKEFAX is running on the computer at once.)

         /MO   Use only monochrome (black-and-white) colors

         /PH   Tells OS/2 version of MAKEFAX/2 to NOT give away time slices
               when converting.  This will result in faster conversion,
               but will make other processes on the OS/2 machine run slower
               until MAKEFAX/2 finishes.

         /2D   Undocumented
         /DM   Undocumented
         /QQ   Undocumented


EXAMPLES
~~~~~~~~
   (a)  MAKEFAX hello.txt hello.fax /sp
        The ASCII text file HELLO.TXT is converted into HELLO.FAX (100-cols),
        but short pages to save thermal fax paper on the remote machine.

   (b)  MAKEFAX coverpg.txt+hello.txt output.fax /80
        COVERPG.TXT is the first page, HELLO.TXT is the rest, and they
        are converted into the file OUTPUT.FAX (80-columns)

   (c)  MAKEFAX coverpg.txt+bodymsg.txt+lastpage.txt out.fax /132 /hr
        Same as above, except three ASCII files used
        Use 132-columns and high resolution!

   (d)  MAKEFAX cover.PCX+porder.txt+thankyou.pcx sendme.fax /132
        This time, the first page is a graphics file rather than ASCII.

   (e)  MAKEFAX @list.dat output.fax /80
        The file "LIST.DAT" is used to determine which files are to be
        sent.  Each line of the LIST.DAT file represents a SINGLE filename.
        Only one file is listed per line.  Each line is terminated with a
        standard <CR><LF> (regular ASCII file).  Example LIST.DAT:
cover.pcx
porder.dcx
c:\bgfax\premade\thankyou.txt

Additional notes
~~~~~~~~~~~~~~~~
At present, there is no way to mix text and graphics easily onto the same
page with MAKEFAX.  If you need to do this, look at the public domain
program "2FAX163.ZIP" available off my BBS and web page.  It allows you
to mix multiple fonts, text, graphics, etc.  Very nice utility and comes
with C source code.  MAKEFAX is suiting for most jobs, but if you need
to add some spice to your outgoing faxes, grab 2FAX.  It was designed
specifically for use with BGFAX.

Regards,
B.J. Guillot