home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / mread91 / mreadeng.doc next >
Text File  |  1993-01-23  |  4KB  |  108 lines
  1. ----{ ENGLISH }---------------------------------------------------------------
  2. IS NOT MY NATIVE LANGUAGE, SO PLEASE EXCUSE ME FOR MY BAD VERSION OF IT..
  3.  
  4. ----{ MREaDER Manual (watdoesitdo?) }-----------------------------------------
  5.  
  6.  A QBBS/LED/BINKLEY compatibel message extractor.
  7.      Converts specified letter into a file.
  8.  
  9. ----{ About the commandline. }-----------------------------------------------
  10.      String terminator is defalut space.
  11.      Strings may be terminated with ",',$,|,* or / to allow spaces in
  12.      strings.
  13.      
  14. ----{ The commandline }------------------------------------------------------
  15.  
  16.   cmd   | Description                            |Type
  17.   ------|-------------------------------------------------------|--------
  18.       -M| Message filename without ext. (.MSG .HDR)        |Number
  19.       -P| Path to letters.                          |String
  20.       -V| Verbose. Debug info on screen.                      |Flag
  21.       -I| Message index pointing at the message to extract.        |Number
  22.       -T| Write message body to output file.            |Flag
  23.       -H| Write message header to output file.            |Flag
  24.       -S| Strippe version of message header.                   |Flag
  25.       -A| Use AREAS.BBS file. Uses the path and msessagebase nr    |String
  26.     | from the file instead of the -P & -M. (Takes time!)    |
  27.       -R| Use string as quote string.. (ex: MB> )                 |String
  28.  filnamn| Output filename.                               |String
  29.  
  30. ----{ Syntax }-----------------------------------------------------------------
  31.  
  32. If AREAS.BBS is present in the directory specified with the environment variable
  33. $BINKLEY or $MAILER
  34.     -A -Nareaname -I outfile {-T} {-V} {-H} {-S} {-Rstr}
  35.  
  36. If not:
  37.     -Mfilename -Ppath {-Nareaname} -I {-V} {-T} {-H} {-S} {-Rstr}
  38.  
  39. ----{ Errorlevels }------------------------------------------------------------
  40.  Vaule    Bit    Error                Probably error.
  41. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  42.     1    0    Wrong msgsbase number.      -N not used without -A.
  43.     2    1
  44.     4    2
  45.     8    3
  46.    16    4
  47.    32    5    General error. :-/        Who Knowns.
  48.    64    6    Msgs path error.        -P not used without -A.
  49.                         Path in AREAS.BBS is wrong.
  50.   128    7
  51.   256    8
  52.   512    9
  53.  1024    10
  54.  2048    12    Index error.            -Inr to high of less then 0.
  55.  4096    13    Msgs base file error.        -Nnr name does not exist.
  56.                         Wrong path specified whith -P
  57.                         or in AREAS.BBS depending of
  58.                         -A is set or not.
  59.  8192    14    Areas.bbs file error.        No or wrong path specified 
  60.                         with $BINKLEY or $MAILER.
  61.                         Does AREAS.BBS exist?
  62.  
  63. ----{ Examples }---------------------------------------------------------------
  64.  
  65. Ex1    Read message 10 in area base called MAIL and write to the file TMP.TMP
  66.         mreader -a -v -t -h -nMail -i10 TMP.TMP
  67.  
  68.  
  69. Ex2    How many messages is in the area? Show on screen. 
  70.         mreader -a -s -nmail -i1 CON:
  71.                          CON: with CAPITALS.
  72.  
  73. Ex4    Read message number 10 in the area related to filename 0198 and write
  74.     it to TMP.TMP
  75.     The areaname is fetched from the AREAS.BBS file.
  76.         mreader -i10 TMP.TMP -m0198 -A
  77.  
  78. Ex5    Write a stripped header to the file HEADER.DAT and write the message
  79.     body to TEXT.TXT where all lines are quoted with "Re: ".  
  80.     Area number 0198.
  81.         You must execute mreader tvice to do this.
  82.             mreader -a -s -m0198 HEADER.DAT
  83.             mreader -a -t -m0198 -r'Re: '  TEXT.TXT
  84.         In the future this will probably be done with.
  85.             mreader -a -sHEADER.DAT -m0198 -r'Re: ' -tTEXT.TXT
  86.  
  87. Ex6    If you cares about execution time, avoid use of AREAS.BBS file. 
  88.     Ex5 without the use of AREAS.BBS
  89.         mreader -p\QBBS\MSGS\ -n0198 -i10 -t -h -v TMP.TMP
  90.  
  91. Ex7    You may name any area to any name by specifying the -N without the
  92.     use of -A
  93.     Ex6 whith the message base name faked to Private secrets.
  94.     mreader -p\QBBS\MSGS\ -n0198 -m'Privata hemlisar' -i10 -t -h -v TMP.TMP
  95.  
  96. ----{ Known bugs etc. }--------------------------------------------------------
  97.     Areaname may not be taller then 50 chars..
  98.  
  99.     There is a "," in the stripped header at the attr line.
  100.     Creates truble if you reads it with BASICs INPUT. Use LINE INPUT.
  101.  
  102.     Slow AREAS.BBS reading.. Not much to do.. Sorry.. 
  103.     To speed it up, remove lines starting with "-".
  104.  
  105.     General slow.. Well.. Maybe a rewrite in C... (ARG..)
  106.     
  107. -----{ END }------------------------------------------------------------------
  108.