home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / CLNP_110.ZIP / CLNP.DOC < prev    next >
Text File  |  1995-01-10  |  15KB  |  235 lines
  1. ───────────────────────────────────────────────────────────────────────────────
  2. ▒▒▌[CLNP]▐▒▒░  ∙∙∙∙  Custom Login Note Pad PPE (c) 1994-95  ∙∙∙∙  ░▒▒▌[CLNP]▐▒▒
  3. ───────────────────────────────────────────────────────────────────────────────
  4. ▐│ ········∙  Custom Login Note Pad  ∙··········· │ Author: Robert Hunter    │▌
  5. ▐│ ········∙  Version: 1.10 Standard  ∙·········· │  a.k.a: Midnight Slasher │▌
  6. ▐│ ··············∙  [01/10/95]  ∙················ │ E-Mail: mslasher@io.org  │▌
  7. ───────────────────────────────────────────────────────────────────────────────
  8. ▐│ CONTENTS      │ 1. Files Included          5. General Program Information │▌
  9. ▐│ OF            │ 2. Brief Program Summary   6. Distribution                │▌
  10. ▐│ DOCUMENTATION │ 3. Installation            7. Legal-ese                   │▌
  11. ▐│               │ 4. External Files          8. Registration / Author Notes │▌
  12. ───────────────────────────────────────────────────────────────────────────────
  13. ▒▒▌ FILES INCLUDED ▐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  14. ───────────────────────────────────────────────────────────────────────────────
  15. ▐│   CLNP.DAT ..... 2,450 .. Data Configuration File
  16. ▐│   CLNP.DOC .... 15,451 .. Documentation and Installation Guide (Please Read)
  17. ▐│   CLNP.DS1 ....... 278 .. Display File: Input Name
  18. ▐│   CLNP.DS2 ....... 467 .. Display File: Top of Note Editor
  19. ▐│   CLNP.HST ..... 2,106 .. History/Whats New File
  20. ▐│   CLNP.PPE ..... 9,634 .. Login Note Pad PPE
  21. ▐│  _CLNP.EX1 ........ 85 .. Exclusion List: Receive                 (Optional)
  22. ▐│  _CLNP.EX2 ........ 97 .. Exclusion list: Send                    (Optional)
  23. ▐│  FILE_ID.DIZ ..... 462 .. Description Identification File
  24. ───────────────────────────────────────────────────────────────────────────────
  25. ▒▒▌ BRIEF PROGRAM SUMMARY ▐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  26. ───────────────────────────────────────────────────────────────────────────────
  27.  A .PPE  (* PCBoard Programming Language Executable *) for PCBoard v15.2+ BBS.
  28.  
  29.  This PPE  installs in two places; its purpose is to add the ability to send a
  30.  two line login  note to other users  on the system. For example, user A would
  31.  be able  to send a  two line note to  user B.  When user B next logs onto the
  32.  BBS, the  note  will be displayed  to them  and then  automatically  deleted.
  33.  This PPE has the  ability to  reject certain users from accessing the program
  34.  (if it is ever  abused)  by an exclusion file, and also has an exclusion file
  35.  so notes can not be sent to  certain users.  Any  automated scripts  that the
  36.  user might be using  will not be affected by the PPE since it times out after
  37.  a specified number of  seconds and  continues on with the login process.  The
  38.  display is  very configurable.   Multiple  notes  sent  to the  same user are
  39.  displayed in an  updated  note  box when  the  user logs  on (if they support
  40.  ANSI). Receipt notes are sent once the  note has  been read by the recipient,
  41.  and much more.
  42. ───────────────────────────────────────────────────────────────────────────────
  43. ▒▒▌ INSTALLATION ▐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  44. ───────────────────────────────────────────────────────────────────────────────
  45.  1. Load PCBSETUP
  46.  2. Press B        ( File Locations )
  47.  3. Press B        ( Configuration Files )
  48.  4. Edit CMD.LST   ( Press F2 at the CMD.LST File )
  49.  
  50.   Example CMD.LST:
  51.  ┌───────────────────────────────────────────────────────────────────────────┐
  52.  │                  Charges  Per                                             │
  53.  │    Command  Sec  Minute   Use   PPE/MNU/Keystroke Replacement             │
  54.  │   ═════════ ═══ ══════════════ ════════════════════════════════════════   │
  55.  │   NOTE        #      0       0 DRIVE:\PATH\CLNP.PPE                       │
  56.  │   L-NOTE      #      0       0 C:\PCB\PPL\CLNP\CLNP.PPE                   │
  57.  └───────────────────────────────────────────────────────────────────────────┘
  58.   5. Copy the CLNP.* file(s) to the SAME directory as CLNP.PPE
  59.  
  60.   6. Edit the CLNP.* file(s) in a text editor for your BBSs configuration and
  61.      color preferences.  (Instructions are contained in the CLNP.DAT file)
  62.  
  63.   7. Place the line: !DRIVE:\PATH\CLNP.PPE /CHECK
  64.                  ie: !C:\PCB\PPE\CLNP.PPE /CHECK
  65.  
  66.      somewhere in your login procedure where it will be run during everyone's
  67.      login process. It must be run each time a user logs in. It simply checks
  68.      the .REP file to see if there are any note receipts, and checks the .NOT
  69.      file to see if there are any notes waiting for the user.If there aren't,
  70.      it is pretty much transparent. (NOTE: *do not* manually edit the .NOT or
  71.      .REP files, they are binary files and editing will screw up the program)
  72.  
  73.      If you don't  know how to make the PPE run during login, here is one way
  74.      to do it.  Put the line  described above into your login NEWS file. Then
  75.      set the filedate  on the  NEWS  file to one that is far into the future.
  76.      Run PCBSETUP,  press G, press  D and enter "Y" where it asks if you wish
  77.      to "Display the NEWS  file only if  changed".   By doing  this, the news
  78.      file would be displayed during all logins, consequently  forcing the PPE
  79.      to run.
  80. ───────────────────────────────────────────────────────────────────────────────
  81. ▒▒▌ EXTERNAL FILES ▐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  82. ───────────────────────────────────────────────────────────────────────────────
  83.   Packaging Note: You may notice that many files  come packaged as _FILE.EXT .
  84.                   This is because they are  optional files.  They will  not be
  85.              used unless you rename  them to FILE.EXT   (remove the _).  It is
  86.              packaged  this way to  prevent users who want to use the defaults
  87.              provided in the program  from using these files  unintentionally,
  88.              which simply slows down the loading process.
  89.              -----------------------------------------------------------------
  90.   CLNP.DAT : Set up the:
  91.              1. The Display of the note box border.
  92.              2. Any text prompts the program uses.
  93.              3. Color's for the other items that are displayed.
  94.              4. Number of seconds to display the note  before deletion.  Since
  95.                 some users use scripts to call boards,the displaying  of notes
  96.                 has a timeout feature.After a configurable number of  seconds,
  97.                 the PPE continues onto the next note,  or  continues  with the
  98.                 login process.
  99.              -----------------------------------------------------------------
  100.   CLNP.DS1 : The file  that  is  displayed in edit mode  to the user when they
  101.              load the  PPE.  It is displayed right before the prompt that asks
  102.              the user to  whom they wish t o enter  the  note.   It  basically
  103.              describes what the login note is, etc.
  104.              -----------------------------------------------------------------
  105.   CLNP.DS2 : The file that is  displayed in  edit  mode to the user after they
  106.              have decided to  write a login  note to a  certain user.  It just
  107.              describes that they are being  placed in a  line editor, and have
  108.              two lines to write the note.
  109.              -----------------------------------------------------------------
  110.   CLNP.EX1 : The Exclusion List File #1.   If you put user names in this  file
  111.              (1 to a line), those users will  NOT be  able to  receive  notes.
  112.              If certain users do  not want to  receive login notes from  other
  113.              users, just place their  name in this  file and  no one  will  be
  114.              allowed to write them any notes.
  115.              -----------------------------------------------------------------
  116.   CLNP.EX2 : The Exclusion List File #2.   If you put user names in  this file
  117.              (1 to a line),  they will not  be able to access the note program
  118.              in /EDIT mode.  They can  still receive  notes from other  users,
  119.              but are not able to send any notes to anyone.
  120. ───────────────────────────────────────────────────────────────────────────────
  121. ▒▒▌ GENERAL PROGRAM INFORMATION ▐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  122. ───────────────────────────────────────────────────────────────────────────────
  123.  1. Check Mode
  124.  -----------------------------------------------------------------------------
  125.  CLNP.PPE /CHECK at login:   The program first checks  the .REP file, and will
  126.  display any notices of  receipts (text telling the  user a previous note that
  127.  they sent was read by the recipient of the note).
  128.  
  129.  The program then  checks the .NOT file  for any notes  awaiting the user.  If
  130.  found, the note will  be displayed.  The PPE either  waits for a keypress, or
  131.  the timeout delay  to expire before  displaying the next  note, or ending the
  132.  program.
  133.  
  134.  The program  works in  ANSI and CTTY  modes.  In  ANSI mode, the  note box is
  135.  updated with new notes, while in CTTY mode, a new box is drawn for each note.
  136.  All read notes are immediately  deleted, and a  notice of receipt  is sent to
  137.  the note's author.
  138.  
  139.  2. Input / Edit Mode
  140.  -----------------------------------------------------------------------------
  141.  When run without command line parameters, CNLP allows users to write notes to
  142.  other users registered on the system.
  143.  
  144.  The user name can be used as a command line paramter.   IE:  If you have CLNP
  145.  installed as the 'NOTE' command,
  146.  
  147.  NOTE John Doe
  148.  
  149.  will start a note to John Doe.
  150.  
  151.  In the two line  editor, color codes are  real-time updated, and  wordwrap is
  152.  active.  Once the note is complete, the user can  'S'end or 'A'bort the note.
  153.  Once sent, the note  is added to the .NOT  file, and awaits the  recipient to
  154.  login.
  155. ───────────────────────────────────────────────────────────────────────────────
  156. ▒▒▌ DISTRIBUTION ▐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  157. ───────────────────────────────────────────────────────────────────────────────
  158.  You are always welcome to send  Internet E-Mail  requesting program info, ask
  159.  any questions you may have, or  to request a  UUEncoded copy of any supported
  160.  program (that is what that specific account is for!), or:
  161.  
  162.  "FINGER -l mslasher@io.org"  anytime  via your internet accessible account to
  163.  view up-to-date information about:
  164.  
  165.  ■ Program information concerning the latest released version .............. ■
  166.  ■ Directions to official distribution site(s) ............................. ■
  167.  ■ A list of other supported programs ...................................... ■
  168.  ■ Other miscellaneous information ......................................... ■
  169. ───────────────────────────────────────────────────────────────────────────────
  170. ▒▒▌ LEGAL-ESE ▐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  171. ───────────────────────────────────────────────────────────────────────────────
  172. USAGE OF THIS SOFTWARE  INDICATES YOUR ACCEPTANCE OF THE SOFTWARE LICENSE TERMS
  173. ───────────────────────────────────────────────────────────────────────────────
  174.  This  software is  the  property of  the  authors,  Robert Hunter / G.L., the
  175.  registered  copyright  owners.   They only license the software's use, public
  176.  distribution does not transfer ownership of this copy.In addition, you assume
  177.  responsibility for the  selection of the  software to  achieve  your intended
  178.  results and for the installation, use and results obtained from the software.
  179.  
  180.  This license is effective until terminated.  You may terminate it at any time
  181.  by  destroying the  software together with  all  copies. You  agree upon such
  182.  termination to destroy the software together with all copies.
  183.  
  184.  Among other things, you may not: rent, lease, modify, translate, disassemble,
  185.  decompile,  reverse  engineer,  or create  derivative  works  based  upon the
  186.  software.  If you  fail to comply  with any terms  of this license agreement,
  187.  your license is automatically terminated.
  188.  
  189.  This license will be governed by the author's residential provincial or state
  190.  laws  except as  to  copyright and  other  proprietary matters  which  may be
  191.  preempted by  federal laws  and international treaties.  In the  event of any
  192.  dispute   involving   this  license,  the   Licensee  consents  to  exclusive
  193.  jurisdiction  and  venue in  either the authors residential  provincial/state
  194.  or federal  courts and agrees that the prevailing  party shall be entitled to
  195.  its attorney fees and costs. In the event any provision of this license shall
  196.  be deemed unenforceable, void, or  invalid, such provision  shall be modified
  197.  so as to make it  valid & enforceable and as so modified the entire agreement
  198.  shall remain in  full force  and effect.  No decision, action or  inaction by
  199.  the author(s)  shall be construed  to be a  waiver of any  rights or remedies
  200.  available to them.
  201. ───────────────────────────────────────────────────────────────────────────────
  202. BY USING OR BEING IN POSSESSION  OF THIS SOFTWARE YOU ACKNOWLEDGE THAT YOU HAVE
  203. READ, UNDERSTOOD, AND AGREE TO BE BOUND BY THIS AGREEMENT'S TERMS & CONDITIONS.
  204. ───────────────────────────────────────────────────────────────────────────────
  205. ▒▒▌ REGISTRATION / AUTHOR NOTES ▐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  206. ───────────────────────────────────────────────────────────────────────────────
  207.  We understand that  software license enforcement is far from  easy; copyright
  208.  violations  are much  easier to  report  to the  proper authorities.  We also
  209.  understand  that the  segment of  persons  that might  be interested  in this
  210.  software is not one that enjoys paying for every utility (simple or not) that
  211.  they deem useful.   This software is not limited/crippled from standard usage
  212.  in any way.
  213.  
  214.  If you use this software for an extended period of time (thirty or more days)
  215.  registration is required.   As you have  most likely read  many times before,
  216.  much work, time and effort is put into producing software. We wish to be able
  217.  to continue to support this software's  development  and the persons that use
  218.  this software.  Please  send electronic mail (Internet  Email) to the support
  219.  account acknowledging your  use  of this  software,  and an  address  to send
  220.  registration funds  will be sent  in reply. If  you simply can  not afford to
  221.  part with a nominal  registration fee, or simply do  not feel the software is
  222.  worth monetary registration, please at least acknowledge its usage so we know
  223.  our efforts  are not wasted.  Either way, we  do hope you  find this software
  224.  useful.
  225.  
  226.  Since we release uncrippled  software, we can only  hope the software is used
  227.  and  enjoyed,  and  those  persons that  can  understand  and  appreciate the
  228.  shareware concept can find the time to  recognize the work that has gone into
  229.  producing this package.                                      -- Thank you.
  230. ───────────────────────────────────────────────────────────────────────────────
  231. ▐│ ···∙  Contacting the Author Via Internet E-Mail: <mslasher@io.org>  ∙···· │▌
  232. ───────────────────────────────────────────────────────────────────────────────
  233. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▌ <EOF> ▐▒▒
  234. ───────────────────────────────────────────────────────────────────────────────
  235.