home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / AEAM100.ZIP / AEAM.DOC < prev    next >
Text File  |  1994-04-06  |  5KB  |  117 lines
  1.  
  2. ∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙╓──┐
  3.                                      ╟──┤ EAM     ··      v1.0
  4.                                      ╨  ┴∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙
  5.  
  6. AEAM is a program which will add color and other such things to WWIV's
  7. otherwise vanilla AUTO.MSG.  It is pretty much a direct rip of The Wandering
  8. Witness' EAM (Enhanced Auto-Message), but adds some additional features, most
  9. of which are configurable, and doesn't mention itself in the output it
  10. produces.
  11.  
  12. A user uploaded to me recently a copy of EAM v2.00.  As a matter of habit, if
  13. I wanted my Automessage colorized, I would add it to the source.  However, I
  14. was sufficently intrigued by the program to rip the idea and code a new
  15. version of it, this time in my own language (C/C++).  Imitation, it is said,
  16. is the best form of flattery.
  17.  
  18. When a user writes a new Automessage, it produces this output:
  19.  
  20. Aquamaestro #1
  21. The basic problem with the future
  22. is that it keeps turning
  23. into the present.
  24.  
  25. When you run EAM200 on the Automessage, it produces this:
  26.  
  27. 2Aquamaestro #10
  28. 4≡ Enhanced Auto-Message v2.00 By: -=TWW=- ≡
  29. 7│1 The basic problem with the future7       │
  30. 7│1 is that it keeps turning7                │
  31. 7│1 into the present.7                       │
  32. 7╚─────────────────────────────────────────╝0
  33.  
  34. All fine and wonderful.  In the stock configuration, AEAM will produce this:
  35.  
  36. 2Aquamaestro #10
  37. 7╔─────────────────────────────────────────╗
  38. 7│1 The basic problem with the future       7│
  39. 7│1 is that it keeps turning                7│
  40. 7│1 into the present.                       7│
  41. 7╚─────────────────────────────────────────╝0
  42.  
  43. I know, there's not much difference.  However, with EAM200, there's no way
  44. (short of hex-editing) to change the "≡ Enhanced [etc]" off.  I'd personally
  45. rather not have that there, thank you.
  46.  
  47. Thus,
  48.  
  49.         SOME REASONS TO USE AEAM (OVER EAM200):
  50.  
  51.                 ■ Top line, bottom line, and sidebars configurable
  52.                   as strings.
  53.                 ■ All colorcodes are configurable, and are not limited
  54.                   to integers - characters will do as well.  This is to
  55.                   facilitate systems supporting more than \x003 0-9.
  56.                 ■ AEAM will, if configured to do so, remove blank lines
  57.                   from the Automessage.  I don't prefer this option myself,
  58.                   but thought it might be useful.
  59.                 ■ AEAM places the colorcodes within the box at the edges,
  60.                   regardless of how long the line is, facilitating the use of
  61.                   colors with non-black backgrounds (ie \x003 4 in stock WWIV
  62.                   configuration).
  63.                 ■ AEAM reads WWIV's CONFIG.DAT to find out where to obtain the
  64.                   AUTO.MSG.  AEAM as such resides in the main WWIV directory,
  65.                   or anywhere else you like, so long as you supply it with a
  66.                   copy of CONFIG.DAT.
  67.                 ■ AEAM will accept on the commandline a path to an alternate
  68.                   configuration file.
  69.                 ■ AEAM is written in C++, and compiled via ASM.  Source code
  70.                   is included.
  71.  
  72. I know, this is way too much documentation for such a simple program.
  73.  
  74. == INSTALLATION ===============================================================
  75.  
  76. Copy AEAM.EXE and AEAM.CFG into your main BBS directory.  If you don't want to
  77. clutter your main directory, you can put it anywhere else, so long as a) also
  78. in the directory is a copy of WWIV's CONFIG.DAT, and b) the path-to-directories
  79. given in INIT are full pathnames, ie C:\WWIV\GFILES\ (stock WWIV configuration,
  80. for some reason, enters only GFILES\).  This you really should be doing anyway
  81. as a matter of security.
  82.  
  83. Edit AEAM.CFG to your satisfaction.  Instructions for editing the .CFG file are
  84. contained therein.
  85.  
  86. Add AEAM (with an alternate CFG path, if so desired) to some automatic
  87. batchfile run by the BBS.  The most logical choice would be to code it into the
  88. source, and a mod is included to explain how to do so.  If you can't do this,
  89. the next logical choice is your logon batch file (traditionally LOGON.BAT).
  90.  
  91. == LEGAL STUFF ================================================================
  92.  
  93. I make no warranties of any kind concerning this software.  If it damages your
  94. software, your hardware, or your mental health, live with it.
  95.  
  96. AEAM is Freeware.  The source code may be distributed only as a part of the
  97. original archive, or as a component of a program of your own.
  98.  
  99. It may be distributed on CDROM provided that it is retained in it's original
  100. archive with all files present (see MANIFEST.TXT). Shareware-floppy vendors
  101. are forbidden to distribute this file.  If you have a problem with this, my
  102. E-Mail addresses are below.
  103.  
  104. Commercial use of AEAM, or use by public or private education systems, offices,
  105. departments or organizations is forbidden.
  106.  
  107. == GETTING AHOLD OF ME ========================================================
  108.  
  109. IceNET  : 1@7704
  110. MicroNet: 1@1
  111. WWIVnet : 1@7724 (for a little while longer, anyway)
  112. WW4net  : 1@11724 (this will be my WWIVnet node number after the switchover)
  113. Internet: dcarrawa@nermal.santarosa.edu
  114.  
  115. ===============================================================================
  116. AEAM v1.0, Copyright (c) 1994 by Devin Carraway (AquaMaestro).
  117.