home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / AXREAD12.ZIP / READ.DOC < prev    next >
Encoding:
Text File  |  1996-08-03  |  7.3 KB  |  178 lines
  1. Message Base Replacement PPE(s) Version 1.20
  2. Code and Graphics by Maverick/[ANTi-X]
  3. Compiled with PPLC 3.20 for PCBoard 15.22+
  4.  
  5. Disclaimer
  6. ══─────∙·.
  7.   This PPE is released under the FREEWARE concept. It may be used in any way
  8.   you wish! Slice it, dice it, decompile it... Whatever you want. HOWEVER, I
  9.   assume NO responsibility for anything that happens. I offer NO guarantees
  10.   of any kind! It's yours, it's free, use it how ever you see fit!
  11.  
  12.   ** WARNING ** This is NOT a completed version, and may contain bugs. Use at
  13.   your own risk! Although the worst that is likely to happen is not work! ;)
  14.  
  15.   ** WARNING ** Once installing READ.PPE, do *NOT* pack your messages! You
  16.   will cause PCBoard to do things it shouldn't! You midas well delete your
  17.   message base, cuzz that's what you'll have to do after running PCBPACK!
  18.  
  19.  
  20. About/Purpose
  21. ══────────∙·.
  22.   Why 5 PPE's for a R command replacement? Because CDC has been unwilling to
  23.   listen to my requests... Mainly the fact that I want a CONFIGUREABLE MESSAGE
  24.   HEADER! (See READHDR) Am I not making myself clear? The default message
  25.   header STINKS! Anyway, this rather large set of PPE's fixes that, and some
  26.   other message base over-sights.
  27.  
  28.   ** NOTE ** The source code is not included in these for one reason,  and one
  29.   reason only, "It's not done!" <g>  It's unlike me to NOT include the source,
  30.   but the main reason is because this is a BETA release. The source WILL be in
  31.   the non-beta release... (Probably version 2.00) You are allowed to decompile
  32.   it with PPLX, but it's *ALOT* of code!  Don't say I didn't warn ya! ;)
  33.  
  34. Advantages of these PPE's
  35. ══────────────────────∙·.
  36.   Your message base will look awesome! EVERY PCBoard sysop that has called my
  37.   board says this, "Gimme that message config thing! It's awesome!"
  38.  
  39.   Solves all problems with users being blinded by the old, ugly message
  40.   header!
  41.  
  42.   Has an awesome address book! Totally re-coded and awesome! Be sure to check
  43.   it out!
  44.  
  45.   Some nice features, such as use of @ codes for configurablity, integration
  46.   with my up-coming quote/message dresser/editor.  The quote char "├" (or in
  47.   your case) "->" can be changed and colored! Ohhh, how nice! :)
  48.  
  49.   Full screen message editor support, supporting IceEdit for now, and more
  50.   to come!
  51.  
  52.   Can still use PCB's internal editors, but the memory problem still exists
  53.   with no hope in sight!  ;(  Unfortunatly, I don't know of a way to fix it
  54.   without the source code to PCBoard itself!  Hmmm... Now I know I saw that
  55.   code somewhere...
  56.  
  57.  
  58. Disadvantages of these PPE's
  59. ══───────────────────────∙·.
  60.   Your will loose LOTS of the nice features of PCBoard message system. The
  61.   code for READ.PPE alone is 900+ lines, and it only supports commands:
  62.  
  63.   R A: Read All
  64.   R Y: Read Your
  65.   R L: Read Last
  66.   R #: Read Specific Message Number
  67.  
  68.   A parameter of "NS" can be added to any of these to force read.ppe into
  69.   NonStop reading mode!
  70.  
  71.   This PPE has been SO requested though, that I'm releasing it anyway.
  72.  
  73.  
  74. Known Bugs
  75. ══─────∙·.
  76.   I know, releasing PPE's with known bugs... Shame Shame! It's not my style,
  77.   but then, you guys kept bugging me to release it, so there!
  78.  
  79.   Okay, one, it doesn't update the READ status after a user reads his mail.
  80.   So, it will always display "READ: NO" for that fact. I will fix this once
  81.   I start reading/writing directly to MSGS and MSGS.IDX. Until then, live
  82.   with it! :) This version uses MsgToFile to read mail. (It's slow, I know)
  83.  
  84.   When a user has mail waiting in an other conference OTHER than the current
  85.   one, read.ppe doesn't join the conferences the messages are in. (R Y command)
  86.   I'm not quite sure how to accomplish this... I'm working on it though! ;)
  87.  
  88.   READ.PPE is running out of memory after reading, replying, reading,
  89.   replying, ect.. This is due to it calling the message editor, and then
  90.   reloading READ.PPE from CALLED.PPE. However, this HAS to be done in order
  91.   for it to work correctly! ;( Otherwise, as soon as you save your reply, it
  92.   throws you at the main menu, making you have to hit R A again! *NOTE* Using
  93.   an external editor completely fixes this problem!
  94.  
  95.   Several cosmetic things (like the saving message prompt/message number
  96.   printing out of turn) that I have NO control over. Unfortunatly, another
  97.   problem I cannot control on a PPE programming level. Allthough, if I had
  98.   the source to PCBoard...
  99.  
  100.  
  101. Installation/Configuration
  102. ══─────────────────────∙·.
  103. Preface:
  104.   NOTE: This PPE is now compatable with FidoNet. It works fine in all my tests.
  105.   If you encounter errors with it and Fido, e-mail me!
  106.  
  107.   If your BBS is connected to the internet (UUCP) STOP here! This PPE has NOT
  108.   been tested under such enviroments, and will most likely stuff wrong text!
  109.   Mainly when it comes to message input. (ie. to/subject/security) If you are
  110.   dareing, try it anyways, OR, complain to CDC and tell them you want a
  111.   configurable message header and you want it NOW!
  112.  
  113. 1. Goto PCBSETUP, Type BB and go down to CMD.LST and press F2. Add these 3 new
  114.    entrys:
  115.  
  116.                                 CMD.LST Editor
  117.  
  118.                             Charges Per     PPE/MNU File Specification -or-
  119.            Command    Sec  Minute    Use    Keystroke Substitution
  120.        ══════════════ ═══ ═════════════════ ═════════════════════════════════
  121.    XX) E                0        0        0 C:\PCB\PPE\READ\ENTER.PPE
  122.    XX) R                0        0        0 C:\PCB\PPE\READ\READ.PPE
  123.    XX) BOOK             0        0        0 C:\PCB\PPE\READ\BOOK.PPE
  124.                                             └──────┬───────┘
  125.           Full drive and path to the PPE's ────────┘
  126.  
  127. 2. Edit READ.CFG, which contains 4 configurable lines. Descriptions are in
  128.    READ.CFG.
  129.  
  130. 3. Run INSTALL.BAT to complete the installation. Make sure you run it from the
  131.    directory the PPE resides in. Example:
  132.  
  133.    INSTALL C:\PCB\PCBTEXT C:\PCB\PPE\READ
  134.            └─────┬──────┘ └──────┬──────┘
  135.                  │               └─────── Full drive and path to the PPE's
  136.                  └──────── Name of PCBTEXT file to modify
  137.  
  138. 4. Edit READHDR and READHDRS to your likeing, Refer to READHDR.DOC for more
  139.    information.
  140.  
  141. 5. Create EXTx.BAT and setup an external editor if you choose to use one.
  142.    Refer to EXTERNAL.DOC for more information. If you want to use PCBoard's
  143.    internal editor, then your done addin' this bad boy in. Enjoy!
  144.  
  145.  
  146. Future/Support
  147. ══─────────∙·.
  148.   The list is HUGE. Of course if CDC would do the message header themselves,
  149.   I'll be happy! :)
  150.  
  151.   Also if I get any requests for addition/changes, I'll be glad to consider
  152.   them!
  153.  
  154.   E-mail: maverick@phcc.org
  155.   Salt Air: Kenneth Padgett
  156.   Sysop of: The No-Name BBS (703) 323-6838
  157.   FTP: x136.pcboard.com /pub/bbs/antix
  158.   WWW: http://pages.prodigy.com/no-name/anti-x.htm
  159.        http://pages.prodigy.com/no-name/kenneth.htm
  160.  
  161.   Snail Mail (self addressed stamped envelope if you want a reply):
  162.  
  163.                                 The No-Name BBS
  164.                                 P.O. Box 12443
  165.                               Burke, Va 22009-2443
  166.  
  167.  
  168. Greetz
  169. ══─∙·.
  170. Greetz go to:
  171.  
  172. Gelfling          - All your wonderful beta testing and ideas! And the great
  173.                     french tanslation! :) Thanks dude!
  174.  
  175. Chicken/ECR       - Your decompiler showed me how to code, And how NOT to code!
  176.  
  177. Lone Runner/AEGIS - Your decompiler is better(Sorry Chicken), Keep up the work!
  178.