home *** CD-ROM | disk | FTP | other *** search
/ Software Recommendations - 1998 Season 1 / DNBCD4.iso / share / modem / BGFAX170 / DOCS / MAKEFAX.DOC < prev    next >
Encoding:
Text File  |  1997-03-01  |  5.1 KB  |  125 lines
  1.  
  2. Documentation for MAKEFAX, version 1.70
  3. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4. MAKEFAX is Copyright (C) 1993-1997 B.J. Guillot.  All Rights Reserved.
  5.  
  6. MAKEFAX is designed for use with the BGFAX shareware fax receiving/sending
  7. program for DOS and OS/2.                    http://www.blkbox.com/~bgfax/
  8.  
  9.  
  10. Description
  11. ~~~~~~~~~~~
  12. MAKEFAX.EXE (DOS version) and MAKEFAX2.EXE (OS/2 version) will convert
  13. ASCII text files, PCX files, or DCX files into FAX image format so that
  14. BGFAX /SEND mode is able to send the information.
  15.  
  16. MAKEFAX will not run without the font file, BGFAX.FNT.  If the BGFAX
  17. environment variable ("BGFAX") is set, the font file will be looked for
  18. in that directory.  Otherwise, MAKEFAX will search the current directory.
  19.  
  20. MAKEFAX will handle form feeds (Ctrl-L, ASCII-12) in ASCII files, causing
  21. a page break to occur, just as in a printer.  MAKEFAX will also properly
  22. handle "TAB" expansions.
  23.  
  24. Usage
  25. ~~~~~
  26.  
  27.           MAKEFAX file1[+file2[+file3[+...fileN]...]]] outfile.fax [switches]
  28.           MAKEFAX @filelist outfile.fax [switches]
  29.  
  30.                 ************
  31.                 * Switches *
  32.                 ************
  33.  
  34.          /80   use 80-column mode when converting ASCII files
  35.  
  36.          /100  use 100-column mode (this is the default)
  37.  
  38.          /132  use 132-column mode when converting ASCII files
  39.  
  40.          /SP   SHORT PAGES--the fax will end at the last line of text rather
  41.                than padding it out to a full length fax--saves thermal paper
  42.  
  43.        /PL:nn  PAGE LENGTH--in number of text lines on a piece of paper.
  44.                (The default is /PL:66 for US-sized paper)
  45.  
  46.          /A4   Tells MAKEFAX to use 69 lines per page instead of 66.
  47.                (/A4 is equivilant to /PL:69)
  48.  
  49.          /HR   force MAKEFAX to make HIGH-RESOLUTION faxes
  50.  
  51.          /LR   force MAKEFAX to make LOW-RESOLUTION faxes (this is the
  52.                default for ASCII files, but sometimes PCX graphics are
  53.                made for low-resoultion)
  54.  
  55.        /LM:nn  Sets "Left Margin" for ASCII conversions.  /LM:10 will
  56.                force all text to be pushed over an additional 10 spaces
  57.                to the right of the standard margin.
  58.  
  59.          /F0   Uses "computer looking" (jagged-edge) font rather than
  60.                nice font when converting ASCII files.  See FNTEDIT.EXE
  61.                (font editor) for a view of the fonts.  I can think of
  62.                no need for using this unless you are just curious.
  63.  
  64.          /IE   Ignore Errors.  This tells MAKEFAX to keep converting away
  65.                even if it encounters an error in one of the files.
  66.  
  67.      /PID:nnn  ProcessID number.  Useful if you are running multiple copies
  68.                of MAKEFAX in a multitasking environment.  The nnn will be
  69.                used when creating any needed temporary files so that there
  70.                is no kind of sharing violation.  (See BGFAX.DOC for more
  71.                details on this.  This switch is not needed unless more than
  72.                one copy of MAKEFAX is running on the computer at once.)
  73.  
  74.          /MO   Use only monochrome (black-and-white) colors
  75.  
  76.          /PH   Tells OS/2 version of MAKEFAX/2 to NOT give away time slices
  77.                when converting.  This will result in faster conversion,
  78.                but will make other processes on the OS/2 machine run slower
  79.                until MAKEFAX/2 finishes.
  80.  
  81.          /2D   Undocumented
  82.          /DM   Undocumented
  83.          /QQ   Undocumented
  84.  
  85.  
  86. EXAMPLES
  87. ~~~~~~~~
  88.    (a)  MAKEFAX hello.txt hello.fax /sp
  89.         The ASCII text file HELLO.TXT is converted into HELLO.FAX (100-cols),
  90.         but short pages to save thermal fax paper on the remote machine.
  91.  
  92.    (b)  MAKEFAX coverpg.txt+hello.txt output.fax /80
  93.         COVERPG.TXT is the first page, HELLO.TXT is the rest, and they
  94.         are converted into the file OUTPUT.FAX (80-columns)
  95.  
  96.    (c)  MAKEFAX coverpg.txt+bodymsg.txt+lastpage.txt out.fax /132 /hr
  97.         Same as above, except three ASCII files used
  98.         Use 132-columns and high resolution!
  99.  
  100.    (d)  MAKEFAX cover.PCX+porder.txt+thankyou.pcx sendme.fax /132
  101.         This time, the first page is a graphics file rather than ASCII.
  102.  
  103.    (e)  MAKEFAX @list.dat output.fax /80
  104.         The file "LIST.DAT" is used to determine which files are to be
  105.         sent.  Each line of the LIST.DAT file represents a SINGLE filename.
  106.         Only one file is listed per line.  Each line is terminated with a
  107.         standard <CR><LF> (regular ASCII file).  Example LIST.DAT:
  108. cover.pcx
  109. porder.dcx
  110. c:\bgfax\premade\thankyou.txt
  111.  
  112. Additional notes
  113. ~~~~~~~~~~~~~~~~
  114. At present, there is no way to mix text and graphics easily onto the same
  115. page with MAKEFAX.  If you need to do this, look at the public domain
  116. program "2FAX163.ZIP" available off my BBS and web page.  It allows you
  117. to mix multiple fonts, text, graphics, etc.  Very nice utility and comes
  118. with C source code.  MAKEFAX is suiting for most jobs, but if you need
  119. to add some spice to your outgoing faxes, grab 2FAX.  It was designed
  120. specifically for use with BGFAX.
  121.  
  122. Regards,
  123. B.J. Guillot
  124.  
  125.