TXTMSG 
                       (c) 1997, Herbert Nushong

       A free DOS & OS/2 textfile to PCBoard 15.x Message Base 
                            posting utility.


These are quick and dirty docs. Don't expect too much -- the utility
was written for personal use.

Rationale
---------
TXT2MSG is unsupported. It truncates instead of word wrapping. It's DOS
only. TXTMSG began as a testing program for code used in DW_TIC.
Seeing how well it worked, I expanded it to do what I wanted that TXT2MSG
didn't.


DISCLAIMER
-----------
 Use at your own risk. It causes no problems here, but you assume full
 responsibility for any damages. If you don't agree, do not use the 
 program.

What it will do
---------------

 - The program will post a text file, as a message.
 - It will word-wrap long lines as best it can.
 - Most Header fields can be indicated on the command line.
 - It supports extended headers for full length To: From: and Subj:
   fields.
 - It will update the MailWaiting flags for the user *if* the 
   To: field name can be found *as given* in the User base. 
   (can be skipped)
 - It will split long files into multiple messages   

What it won't do
---------------- 
 - won't do File Attaches
 - wont do Special E-Mail Kludges (To: From: etc... on first line of message).
 - won't do Carbon Copies
 - won't Update MWFlags for aliases, including SYSOP. Support for
   updating MWFlags for @USER@ msgs may be added later *if* monetary 
   encouragement is forthcoming.
 - won't parse scripts 
 - won't Work with PCB 14.x message bases/indexes

Syntax
-------
 run with no parameters to see help display 

 TXTMSG TextFile [ [-Mmsgbasefile] | [-C###] ] [-Ppcboard.dat] 
                 [-Tto] [-Ffrom] [-Ssubj] [-R] [-E] [-L] [-W]

Options summary:
     TextFile  file to post as a message

     one of the following two must be given
           -M  Filename of Message base
           -C  Conference Number 

           -P  name/location of PCBOARD.DAT of %PCBDAT% isn't set
               and not in current directory

           -T  To field   (Default: SYSOP)
           -F  From Field (Default: TXTMSG)
           -S  Subject    (Default: <no subject>)
           -L  Convert Underscores to spaces in To, From, and Subj
           -R  Set Receiver Only Flag
           -E  Set Echo Flag
           -W  Skip updating of Mail Waiting Flags
         -n### Maximum lines per message

Examples
--------
TXTMSG somefile -TJOHN_DOE -FSYSOP -SWelcome_To_BBS -L -n200
   To: JOHN DOE
 From: SYSOP
 Subj: Welcome To BBS
  <text of somefile>

TXTMSG somefile -TJOHN_DOE -FSYSOP -SWelcome_To_BBS -R -E -Pd:\node1\pcboard.dat
   To: JOHN_DOE
 From: SYSOP
 Subj: Welcome_To_BBS  (Receiver Only / Echoed)
  <text of somefile>

Underscores will only be converted to spaces if the -L parameter is given.



Copyrights, trademarks, whatever
---------------------------------
TXT2MSG - Robert Vostreys
OS/2    - IBM
PCBoard - Clark Development, Inc.