home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / msgmrg.zip / MSGMERGE.TXT < prev   
Text File  |  1994-11-15  |  3KB  |  60 lines
  1.                           MsgMerge Documentation
  2.                          ------------------------
  3.  
  4.   MsgMerge was written by Mike Bowler (CIS 74040,1540) and has been released
  5. as freeware.  This program may be freely distributed but may not be sold
  6. without the written permission of the author.  MsgMerge has been extensively
  7. tested with message files created by Golden Commpass** but has not been tested
  8. with any other navigation programs.
  9.  
  10.   MsgMerge allows the user to merge one or more CompuServe message files into
  11. one file.  As the files are merged, extraneous information is removed from the
  12. individual messages to decrease the message size.
  13.  
  14.   The following messages are completely removed from the archives:
  15. - Message headers ( ie 'Welcome to OS2DF1...' )
  16. - Duplicate messages
  17.  
  18.   The following portions of messages are removed:
  19. - Reply comments i.e.'There is 1 Reply' or 'There are 2 Replies'
  20. - Forum prompts i.e. 'Forum !' or ' !'
  21. - Whitespace at the end of the message
  22.  
  23.   The first filename specified on the command line will be the output file.
  24. MsgMerge will create a new file with this filename and will abort if this file
  25. already exists.  All the remaining filenames specified on the command line are
  26. input files.
  27.  
  28. Switch          Description
  29. -------------   -----------------------------------------------------------
  30. overwrite       Overwrite the output file if it already exists
  31. sort:thread     Sort by thread topic.  (This is the default)
  32. sort:number     Sort by message number.
  33. ?               Display the help screen
  34. verbose         Display all diagnostic messages
  35. log:"filename"  Redirect all the output to the file specified in "filename".
  36.                 The default is to send all output to the screen.
  37. find:"string"   Filter all the messages according to the string specified.
  38.                 Only messages that contain the specified string will be placed
  39.                 in the output file.  If a find string is not specified then
  40.                 all messages will be placed in the output file.
  41.  
  42. Example
  43. --------
  44.   msgmerge.exe /find:"notebook" /log:"new.log" new.msg os2df1.msg os2df1.old
  45.  
  46. This will search through the files 'os2df1.msg' and 'os2df1.old' for the
  47. string 'notebook'.  Any messages that match this string will be placed in the
  48. file 'new.msg' and all status messages from msgmerge will be placed in the
  49. file 'new.log'.
  50.  
  51. Whats new in version 1.1?
  52. - Forum news flashes are now retained and are stored at the beginning of the 
  53.   message file.
  54. - MsgMerge now returns an error code indicating the status of the merge
  55.     0 = No error
  56.     1 = At least one of the specified input files could not be opened
  57.     2 = There was an error during the save of the output file
  58.  
  59. **Golden Commpass is a trademark of Creative Systems Programming Corporation
  60.