home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / IEDIT235.EXE / ICEEDIT.DOC < prev    next >
Encoding:
Text File  |  1997-03-27  |  66.0 KB  |  1,397 lines

  1.  
  2.  
  3.               ┌───┐┌─────┐┌─────┐   ┌─────┐┌───────┐┌───┐┌───────┐
  4.               │░▒▓││░▒▓┌─┘│░▒▓┌─┘   │░▒▓┌─┘│░▒▓┌┐░▒││░▒▓│└─┐░▒▓┌─┘
  5.               │▒▓█││▒▓█│  │▒▓█└┐    │▒▓█└┐ │▒▓█││▒▓││▒▓█│  │▒▓█│
  6.               │▓██││▓██│  │▓██┌┘    │▓██┌┘ │▓██││▓█││▓██│  │▓██│
  7.               │███││███└─┐│███└─┐   │███└─┐│███└┘██││███│  │███│
  8.               └───┘└─────┘└─────┘   └─────┘└───────┘└───┘  └───┘
  9.  
  10.                 Deluxe Fullscreen ANSI Message Editing Utility
  11.             For RemoteAccess v2.xx, Telegard v3.0x, QuickBBS 2.8x,
  12.                                  & Compatibles
  13.  
  14.  ─────────────────────────────────────────────────────────────────────────────
  15.     IceEdit v2.35 -  Copyright Jeremy Landvoigt, 1994-97  - IceEdit v2.35
  16.  ─────────────────────────────────────────────────────────────────────────────
  17.  
  18.  ┌───────────────────────────────────────────────────────────────────────────┐
  19.  │░░░▒▒▒▓▓▓     Important Note: Upgrading from v2.30 to v2.35       ▓▓▓▒▒▒░░░│
  20.  └───────────────────────────────────────────────────────────────────────────┘
  21.  
  22.   If you are upgrading from v2.30 to v2.35, all you need to do is run EDITCFG
  23.   before attempting to run the main executable. As of v1.60, the external
  24.   version converter utility has been internally coded into the configuration
  25.   program.
  26.  
  27.   Please note that the converter can not upgrade between more than one
  28.   "generation" of the software, in other words if you skip a version you'll
  29.   need to manually re-configure the software.
  30.  
  31.  ┌───────────────────────────────────────────────────────────────────────────┐
  32.  │░░░▒▒▒▓▓▓          Some Unique Features Of IceEdit v2.35          ▓▓▓▒▒▒░░░│
  33.  └───────────────────────────────────────────────────────────────────────────┘
  34.  
  35.   ■ IceEdit has a built in Macro replacement feature that will replace
  36.     keywords with other words. Eg "RA" -> "RemoteAccess"
  37.  
  38.   ■ IceEdit has a built message censoring feature to weed out inappropriate
  39.     text. {+}
  40.  
  41.   ■ Character Color Configuration for individual letters such as Uppercase,
  42.     lowercase, High Bit, numbers, and punctuation.
  43.  
  44.   ■ Tagline appending feature - IceEdit has THREE modes of tagline appending
  45.     available!  Mode 1 is single random tagline appending without user
  46.     knowledge, Mode 2 is allow the user to select from a random pick list,
  47.     and Mode 3 allows the user to completely scan the entire tagline database
  48.     for the tagline they want! {+}
  49.  
  50.   ■ Easy to use control keys.
  51.  
  52.   ■ Color Code insert strings
  53.  
  54.   ■ SysOp defined function key macros
  55.  
  56.   ■ Quoted text re-formatting
  57.  
  58.   And much MORE!
  59.  
  60.  ┌───────────────────────────────────────────────────────────────────────────┐
  61.  │░░░▒▒▒▓▓▓          Copyright Notices & Program Disclaimer         ▓▓▓▒▒▒░░░│
  62.  └───────────────────────────────────────────────────────────────────────────┘
  63.  
  64.   The utility IceEdit, along with all its support files and documents, are
  65.   Copyright (C) 1994-97 Jeremy Landvoigt.  Distributing a version AFTER it
  66.   has been registered is prohibited;  distribution & execution of the
  67.   original, unaltered version is permitted, indeed encouraged, as long as all
  68.   support-files and documentation that accompany the program are included
  69.   WITHOUT ALTERATION OF ANY SORT. None of the files included in the IceEdit
  70.   archive may be modified in any way or distributed in any package without
  71.   the express, written permission of Ice Technologies. Any type of cracking
  72.   of either evaluation or registered versions of IceEdit including (but not
  73.   limited to) hex-editing, reverse engineering, decompiling are strictly
  74.   prohibited.
  75.  
  76.   The author can be quickly reached for information through the ICEUTILS or
  77.   the RA_UTIL international FidoNET Conferences, or at InterNET e-mail
  78.   address:
  79.  
  80.     jlandvoigt@interhop.net
  81.  
  82.   Or, If you wish to trust comments/complaints/suggestions to the Post
  83.   Office, you can send them to:
  84.  
  85.     Jeremy Landvoigt
  86.     P.O. Box 93044
  87.     1111 Davis Drive
  88.     Newmarket, Ontario
  89.     Canada  L3Y 8K3
  90.  
  91.   The following programs mentioned in this documentation are Copyright of
  92.   their respective authors. They are listed in no particular order:
  93.  
  94.     IceEdit      - Copyright Jeremy Landvoigt
  95.     FKFossil     - Copyright Tim Strike and Forbidden Knights Systems
  96.     RemoteAccess - Copyright Wantree Development & Andrew Milner
  97.     Telegard     - Copyright Tim Strike
  98.     QuickBBS     - Copyright Matrix Technologies & Benjamin Schollnick
  99.     X00          - Copyright Raymond L. Gwinn
  100.     BNU          - Copyright David Nugent and Unique Computing Pty Limited
  101.     Turbo Pascal - Copyright Borland International
  102.  
  103.   THE USUAL LEGALITIES
  104.  
  105.   I (Jeremy Landvoigt) make no warranty of any kind, expressed or implied,
  106.   including without limitation any warranties of merchantability and/or
  107.   fitness for a particular purpose.  I shall not be held liable for any
  108.   damages, whether direct, indirect, special or consequential arising from
  109.   the failure of this program to operate in the manner desired by the user.
  110.   I shall not be held liable for any damage to data or property which may be
  111.   caused directly or indirectly by the use of this program.
  112.  
  113.   In no event will I be held liable for any damages, including (but not
  114.   limited to) any lost profits, lost savings, or other incidental or
  115.   consequential damages arising out of the use -- or the inability to use --
  116.   this program, or for any claim by any other party.
  117.  
  118.   The only thing that this package is guaranteed to do is to take up space
  119.   on your hard drive.
  120.  
  121.   Making use of this software is acknowledgement that you have read,
  122.   understand, and fully agree to the license and disclaimer agreement.
  123.  
  124.  ┌───────────────────────────────────────────────────────────────────────────┐
  125.  │░░░▒▒▒▓▓▓                         Credits                         ▓▓▓▒▒▒░░░│
  126.  └───────────────────────────────────────────────────────────────────────────┘
  127.  
  128.   There are a few people who helped with the development of IceEdit that
  129.   although they weren't involved in the creation or writing of the program,
  130.   their suggestions, Bug reports, and lengthy ßeta testing have been an
  131.   enormous asset. I would like to thank in no particular order :
  132.  
  133.    Ian Thomsen      Branislav Slantchev       Glen Oliver
  134.    Eric Staufer     Kevin McKillop
  135.  
  136.   for all of their help. Couldn't have done it without them!
  137.  
  138.   Special thanks to James Goldbloom for writing the QBBS setup section,
  139.   Andreas Magnusson for translating the language file to Swedish, and to
  140.   Kevin McKillop for creating and maintaining our homepage on the internet!
  141.   (http://www.ionsys.com/~mckkev/icesoft.html)
  142.  
  143.   Also, portions of the Fossil Routines used in IceEdit v2.35 are Copyright
  144.   1993-94 By Tim Strike and Forbidden Knights Systems.
  145.  
  146.  ┌───────────────────────────────────────────────────────────────────────────┐
  147.  │░░░▒▒▒▓▓▓                       Registration                      ▓▓▓▒▒▒░░░│
  148.  └───────────────────────────────────────────────────────────────────────────┘
  149.  
  150.   The development of IceEdit v2.35 took many long hours, and a lot of time
  151.   and effort not to mention money. This program is not Freeware.  If this
  152.   program satisfies your expectations of a fullscreen editor,if not MORE,
  153.   then you are expected to register it after an evaluation period of 30 days
  154.   or sooner.  By doing this you can be sure of continued development of the
  155.   software. Thanks for your support.
  156.  
  157.   This program may be freely distributed but DO NOT under any circumstances
  158.   change any of the executables or alter any files that come in the original
  159.   distribution archive.
  160.  
  161.   I urge you to register as soon as you can! The more registrations that I
  162.   have will show the interest of people in the program, and I will release
  163.   future versions with many more features. If you register, the Message
  164.   Censoring & tagline features will become available. All "Unregistered"
  165.   messages and almost inaudible beeps within the program will also be removed.
  166.   Please note that the status of features (whether they are available or not
  167.   to unregistered users) may be changed without further warning in later
  168.   versions of the software; but this does not mean that they will be changed.
  169.  
  170.   If you wish to register, please extract the ICEREG archive (which is the
  171.   official Ice Tech registration kit) and fill out the registration form:
  172.  
  173.      North America
  174.      -------------
  175.  
  176.      Register.Can - Registration Form For Canadian Users
  177.      Register.Usa - For the U.S.A, and for all other Registrations
  178.  
  179.      Europe
  180.      ------
  181.  
  182.      Register.Ger - Registration Form for Germany
  183.      Register.Uk  - Registration Form for the United Kingdom
  184.  
  185.  
  186.      Far East
  187.      --------
  188.  
  189.      Register.Aus - Registration Form for Australasia
  190.  
  191.  
  192.   Please at this time send ALL registrations to the address listed in the
  193.   correct registration form. Thank you for your support.
  194.  
  195.   Any Registration forms that have invalid or missing information may be
  196.   considered void and not be processed, depending on the extent of the
  197.   errors.
  198.  
  199.   Due to recent events, I have changed my policy on personal cheques that are
  200.   sent in to pay for registration. I will continue to honour them, however as
  201.   of this release, there will be a 2 week hold placed on the cheque to ENSURE
  202.   that it does NOT go N.S.F.  Although most people are honest about this,
  203.   lately too many people have sent in N.S.F. cheques, and when contacted
  204.   about them, show little or no concern about them or the financial
  205.   difficulties they may have caused.
  206.  
  207.   Additionally, a service charge of $15 will be levied against any N.S.F.
  208.   cheques. Until both the full payment, and the service charge is recieved
  209.   in the form of a MONEY ORDER, the registration will not be processed.
  210.  
  211.   In conclusion to the above information, to ensure a speedy turnaround time
  212.   it is recommended you send your registration in the form of a money order
  213.   (or direct deposit for Canadian residents) If you do choose to send in a
  214.   personal cheque, it means that you have read, understood and agree to these
  215.   conditions.
  216.  
  217.  ┌───────────────────────────────────────────────────────────────────────────┐
  218.  │░░░▒▒▒▓▓▓                      Archive Contents                   ▓▓▓▒▒▒░░░│
  219.  └───────────────────────────────────────────────────────────────────────────┘
  220.  
  221.   IceEdit v2.35 has been compressed using RAR, and should be a
  222.   self-extracting (SFX) archive. The archive should be approximately 190k
  223.   in size. This archive should have an authenticity verification seal by
  224.   Jeremy Landvoigt. If this archive is not in RAR/EXE format, or if the
  225.   seal has been broken, it is may be advisable to get a new archive from
  226.   one of the support sites listed at the end of the documentation.
  227.  
  228.   The IceEdit archive should contain the following files :
  229.  
  230.     ICEEDIT .EXE         - The main program
  231.     EDITCFG .EXE         - Use to configure the program
  232.     LANGUAGE.EXE         - Archive containing various language files
  233.     ICEREG10.EXE         - Registration kit (includes regforms and regdocs)
  234.     CENSOR  .CFG         - Sample censor keyword file
  235.     ICEEDIT .DOC         - Program documentation
  236.     ICEEDIT .LNG         - IceEdit language file (English)
  237.     WHATSNEW.235         - Changes in IceEdit since previous version
  238.     HISTORY .DOC         - Changes in IceEdit since it's creation
  239.     FILE_ID .DIZ         - General program description
  240.  
  241.   If one or any combination of these files are missing, or files have been
  242.   ADDED, then you are using a possibly modified or altered copy of IceEdit.
  243.   It would be advised that you delete this copy, and get a clean copy of
  244.   IceEdit from one of the BBS's listed at the end of the documentation.
  245.   Newest Version of IceEdit can be F'REQed from Ice Technologies BBS under
  246.   the magic name 'ICEEDIT' (Without the quotes).
  247.  
  248.   There is a second archive which you can probably find wherever you obtained
  249.   this copy of IceEdit. The file is ICEDICT.EXE, which is an archive
  250.   containing IceEdit's dictionary files. These files must be installed into
  251.   the program directory for IceEdit to make use of the spell checker.
  252.  
  253.   Files IceEdit will create are :
  254.  
  255.     ICEEDIT.CFG         - The configuration file.
  256.     ICEEDIT.x           - The temporary file which buffer text is stored in.
  257.                           [x] represents current node number.  This file also
  258.                           indicates that the current node is in use.
  259.     MACRO.CFG           - The file containing replacement macros.
  260.     MSGTMP.             - Textfile containing message text which is read in
  261.                           by the BBS package.
  262.  
  263.   Files IceEdit can/will read are:
  264.  
  265.     CONFIG.RA           - Read when IceEdit is first installed. It will
  266.     CONFIG.TG             attempt to determine if you are running RA/TG/QBBS
  267.     QUICKCFG.DAT          by use of Environment variable, and if it can find
  268.                           the configuration, it will read in some information
  269.                           from it.
  270.     MESSAGES.RA         - IceEdit will attempt to read this file if it can
  271.     MSGCFG.DAT            It uses this file to determine whether or not a
  272.                           message area is an echomail/netmail base. If it is,
  273.                           the Color Code feature will be temporarily disabled.
  274.     DORINFO1.DEF        - Drop file containing user information.
  275.     MSGHDR.ANS          - Definable ANSI screen which, if found, will
  276.                           replace the hardcoded screen header on the main
  277.                           editing screen.
  278.     MSGINF.             - File created by the BBS package containing message
  279.     MSG.INF               information such as Source User, Target User,
  280.                           message subject, & Message area.
  281.     MSGTMP.             - File created by the BBS package containing Quoted
  282.                           text.
  283.  
  284.  
  285.  ┌───────────────────────────────────────────────────────────────────────────┐
  286.  │░░░▒▒▒▓▓▓                   Program Information                   ▓▓▓▒▒▒░░░│
  287.  └───────────────────────────────────────────────────────────────────────────┘
  288.  
  289.   IceEdit is a fullscreen ANSi message editor that was originally designed    
  290.   for use with RemoteAccess. Although it has been tested with TG 3.00,
  291.   RA v2.xx, & QBBS v2.80 it should be compatible with any other BBS that uses
  292.   the QuickBBS style dropfiles that contain the message writing information.
  293.   These files are MSGTMP & MSGINF. You should check your BBS documentation to
  294.   see if your software supports this system. IceEdit also calls on the
  295.   Dorinfo1.Def file to read in necessary information about the user profile.
  296.   IceEdit has a special feature specifically for QBBS/RA/TG, which is Echobase
  297.   checking. Do not enable this feature if you are not using RA, QBBS, or TG.
  298.  
  299.   Why was IceEdit created? .. Well, after I wrote my first major BBS utility, 
  300.   known as IceChat, I was really surprised by the response to my chat program
  301.   and the number of registrations that came in for it. When I first created
  302.   IceChat,  I never expected it to have the impact that it obviously had.
  303.   This encouraged  me to start writing other BBS (specifically RemoteAccess)
  304.   utilities. A number  suggestions came in for utilities such as a
  305.   User Editor, a TimeBank (both of which came into existance after IceEdit),
  306.   but  the most challenging one was to write a Fullscreen message editor,
  307.   which I  thought would be a really great idea. Not only for the challenge,
  308.   but because  right now I feel that there are very few message editors
  309.   currently available.  Of the ones that do exist, one or two of them tend
  310.   to dominate the market,  and they STILL didn't offer all the features that
  311.   I would like to have in a  fullscreen editor. Nevermind ridiculous
  312.   registration fees. So, thus became the beginnings of IceEdit.
  313.  
  314.  ┌───────────────────────────────────────────────────────────────────────────┐
  315.  │░░░▒▒▒▓▓▓             IceEdit's System Requirements               ▓▓▓▒▒▒░░░│
  316.  └───────────────────────────────────────────────────────────────────────────┘
  317.  
  318.   IceEdit requires the following to correctly operate on your system:
  319.  
  320.      ■ An IBM XT/AT/386/486/Pentium/P6+ or compatible
  321.      ■ A modem, 300-115200 BPS
  322.      ■ A FOSSIL communications driver (BNU/X00 or 100% compatible)
  323.      ■ DOS 3.0+, OS/2 2.0+/Warp 3.0+, Win 3.0+, DV 2.0+, or Win '95
  324.      ■ DORINFO1.DEF (produced by your BBS program) (EXITINFO.BBS optional)
  325.      ■ A terminal supporting ANSI emulation (user only)
  326.      ■ 500k on your hard disk (plus space for dictionary & taglines)
  327.  
  328.  ┌───────────────────────────────────────────────────────────────────────────┐
  329.  │░░░▒▒▒▓▓▓         Program Configuration -  Using EditCfg          ▓▓▓▒▒▒░░░│
  330.  └───────────────────────────────────────────────────────────────────────────┘
  331.  
  332.   Setting up IceEdit is quite easy. This section of the documentation will
  333.   attempt to take you step by step on how to use the configuration utility
  334.   EditCfg.Exe to set up IceEdit. Most of the options are self explanatory.
  335.   You can use the local testmode feature at any time to test out how your
  336.   current settings will affect IceEdit.Exe without having to save your
  337.   settings or exit the configuration program.
  338.  
  339.   BEFORE YOU BEGIN:  If you are using RemoteAccess, Telegard or
  340.   QuickBBS it is recommended that you ensure that you've set your BBS package
  341.   environment variable so that you can take advantage of the added features
  342.   for these three BBS packages.
  343.  
  344.  
  345.   FILE
  346.   ------
  347.  
  348.    ■ Save & Exit - This will save your current configuration to the
  349.      IceEdit.Cfg file and will exit the program.
  350.  
  351.    ■ Save Without Exit - This will save your current configuration to the
  352.      IceEdit.Cfg file and will allow you to continue modifying your setup.
  353.  
  354.    ■ Exit Without Save - This will abort the save procedure (just in case you
  355.      somehow really messed up!) and will exit the program.
  356.  
  357.    ■ System Paths -
  358.  
  359.       ■ Censor file - textfile containing censor keywords, one word per
  360.         line. If censoring is enabled, IceEdit will read in the file and scan
  361.         the user's message for any matches of words within this file. If it
  362.         finds any matches, it will strike out that particular word from the
  363.         message. For example, if a censor word was "IDIOT", and the user
  364.         had a sentence such as:
  365.  
  366.         "You are such an idiot!"
  367.  
  368.         After the scan was complete the word "IDIOT" would be wiped out and
  369.         the result would be: "You are such an *****!".
  370.  
  371.         A sample CENSOR.CFG file is included. The format is very simple; use
  372.         one word per line. IceEdit is not case sensitive to the particular
  373.         censoring word that is being compared.  Message censoring only takes
  374.         place AFTER the user opts to save their message. This is a registered
  375.         feature. {+}
  376.  
  377.       ■ Msg Header  - a definable header which will be imported into the main
  378.                       text body upon program execution.
  379.  
  380.       ■ Macros      - path and filename to macro database.
  381.  
  382.       ■ Chat Util   - path and filename to external chat utility. This can
  383.                       be executed from within IceEdit using the ALT-C key.
  384.  
  385.       ■ Dictionary  - path and filename to words added to dictionary by
  386.                       *sysop*  -- this file must NOT be the same name as the
  387.                       dictionary files --
  388.  
  389.    ■ Program Info - This will give you a little bit of information on the
  390.      current version of IceEdit that you happen to be using.
  391.  
  392.    ■ Local Testmode - You can use this at anytime during configuration to
  393.      view how your current configuration will affect IceEdit if you should
  394.      choose to save.  You can execute a local testmode from the dos prompt
  395.      by running IceEdit like this:  ICEEDIT.EXE /L
  396.  
  397.  
  398.   MANAGER
  399.   ---------
  400.  
  401.    ■ Tagline Setup - This is a submenu containing all most of the tagline
  402.      setup. It can be accessed by unregistered users, however tagline
  403.      functions are limited.
  404.  
  405.      TAGLINE SUBMENU
  406.      -----------------
  407.  
  408.      ■ Tagline Editor - Use this to edit all your compiled tagline files. You
  409.        can edit, insert, and import new taglines into your compiled files.
  410.  
  411.      ■ Compile Taglines - This file contains taglines that can be appended to
  412.        the ending of the users message if they opt to save their text.
  413.        This is a textfile that you can create, although a sample is included
  414.        called TagLines.Cfg. This file is encrypted, and MUST be compiled from
  415.        a textfile containing taglines. Use EditCfg to compile.  At this time
  416.        there is not any considerable limitation on the number of taglines that
  417.        the file may contain. However, the more that there are, the longer it
  418.        will take EditCfg to read in the textfile and convert it to a
  419.        structured datafile.
  420.  
  421.        IMPORTANT:  The file extension of the compiled taglines file MUST be
  422.        a number. If you are using RemoteAccess with different message GROUPS,
  423.        it is possible to configure different tagline files for different
  424.        groups. If you are aren't using groups, or only want one tagline file,
  425.        it must be named in this format:
  426.  
  427.        ICETAG.0
  428.  
  429.        It must have the .0 extension to indicate one file. If you create a
  430.        file called ICETAG.2, if the message is being written in a conference
  431.        which falls in GROUP 2, then this tagline file will be accessed.
  432.        If IceNote can't find a corresponding tagline file, it will fall back
  433.        on ICETAG.0, so it would be a good idea to have a 'default' tagline
  434.        file.
  435.  
  436.      ■ Configure Toggles - This is another small submenu to toggle tagline
  437.        configuration. It consists of three options:
  438.  
  439.                          1)  Use Taglines
  440.                          2)  List Taglines
  441.                          3)  Scroll Taglines
  442.  
  443.        - If taglines aren't enabled, there will be no taglines (obviously :)
  444.        - If only option (1) is enabled, a random tagline will be chosen for
  445.          the user.
  446.        - If options (1) and (2) are enabled, the user will be able to pick
  447.          from a random list of taglines.
  448.        - If all options are enabled, the user can browse the entire tagline
  449.          database.
  450.  
  451.    ■ Compile Dictionary - Use this to compile a textfile with a list of
  452.      words to a encrypted private dictionary file. This feature is used to
  453.      add words to the dictionary database that you wouldn't usually find in
  454.      an average English dictionary, Such as "RemoteAccess", "FrontDoor" etc..
  455.      or any other slang terms that might be commonly used. Any words that
  456.      IceEdit finds in this file will not be treated as mis-spelled. Note,
  457.      the textfile that contains the words MUST not be the same name as what
  458.      the compiled file will be called. Eg, if you have 'ICEEDIT.PVT' as your
  459.      Private dictionary name, make sure you do not name the textfile with
  460.      this name before compilation.
  461.  
  462.    ■ Override Manager - Use this to define overrides for individual message
  463.      areas. You can toggle Pipe Codes, Taglines, Censoring, and ANSi
  464.      individually for every message base that your BBS has. This is for
  465.      RA/QBBS/TG only. The settings defined will override the default
  466.      configuration settings.
  467.  
  468.    ■ Display Manager - This is a submenu containing toggles to turn certain
  469.      information fields ON or OFF on the main editing screen, as well as
  470.      configure screen locations.
  471.  
  472.   Toggles
  473.   ---------
  474.  
  475.    ■ View Macros YES/NO - Are users permitted to view the list of available
  476.      macros from within IceEdit by using the CTRL-V key?
  477.  
  478.    ■ Create Macros YES/NO - Are users permitted to add to the list of
  479.      available macros from within IceEdit by using the CTRL-V key?
  480.      NOTE: View Macros MUST be enabled for this feature to work.
  481.  
  482.    ■ Censor Tagline YES/NO - If the user uses inappropriate text in their
  483.      message and IceEdit is forced to censor the text, should a tagline
  484.      be appended to the message to inform future message readers of that
  485.      fact?  Eg. "*** This message has been censored by IceEdit v2.35"
  486.  
  487.    ■ Imbedded Colors YES/NO - Should imbedded color codes be permitted? If
  488.      YES, when the message is saved, all color strings will be replaced by    
  489.      ANSi escape sequences, thus putting colors into the message. Refer     
  490.      below in "Editing Your Message In IceEdit" for more information on     
  491.      Color Strings.
  492.  
  493.    ■ Convert Colors YES/NO - Should IceEdit convert colour pipecodes to ANSI?
  494.  
  495.    ■ Use Overrides YES/NO - Should IceEdit make use of the message override
  496.      definitions located in the MANAGER section?
  497.  
  498.    ■ Confirm Abort YES/NO - Should IceEdit display a message to the user
  499.      if they choose to abort a message either by '/A', 'CTRL-A' or by use
  500.      of the help prompt which will ask them if they really want to abort their
  501.      message? Enabling this feature can help prevent accidental message
  502.      erasure.
  503.  
  504.    ■ Use Quote Color YES/NO - Should IceEdit use the quote color selected in
  505.      EditCfg to make quoted text a specific color. If NO, all quoted text will
  506.      have regular text coloration.
  507.  
  508.    ■ Filter ANSi YES/NO - Should IceEdit disrupt any ANSi that is read into
  509.      IceEdit whether it be quoted text or manually imported text by the SysOP?
  510.      If NO, all ANSi codes will be treated normally.
  511.  
  512.    ■ Use Soft C/Rs YES/NO - Should IceEdit use soft carriage returns in
  513.      messages, or should all lines be followed by a hard return?
  514.  
  515.    ■ KBT hangup YES/NO - Should IceEdit terminate the connection when
  516.      the keyboard timeout has elapsed?
  517.  
  518.    ■ Speller Prompt YES/NO - Should IceEdit prompt the user for spell checking
  519.      when they save their message?
  520.  
  521.    ■ CTRL-Q Quote Key YES/NO - Should IceEdit open the quote window using
  522.      CTRL-Q? If not, it will use CTRL-W. On some systems using OS/2, the
  523.      operating system filters out the CTRL-Q before IceEdit can intercept it
  524.      thereby making it impossible to quote from the main editing screen.
  525.  
  526.    ■ Suspend Time YES/NO - Should IceEdit suspend user time while they are
  527.      editing their message?
  528.  
  529.    ■ Imbedded Files YES/NO - Should IceEdit process imbedded file names. If
  530.      YES, IceEdit will read in the external file that is specified and add it
  531.      to the message text. Eg: If the user put the following string on a line
  532.      by itself ..
  533.  
  534.      %[MAIN.ANS]%
  535.  
  536.      If IceEdit can locate the file MAIN.ANS, it will import it into the
  537.      message text. Any files that you want to have imported MUST be surrounded
  538.      by the "%[" & "]%" brackets and should be placed on a single line without
  539.      any other text. You should specify the full path and filename of the file
  540.      to be imported. Please note, this function will PROPERLY import a file
  541.      into the message text, but editing before saving is not possible, as
  542.      all Imbedded files are processed when the user chooses to save.
  543.  
  544.    ■ Spell Checker YES/NO - Should users be permitted to make use of IceEdit's
  545.      built in spell checking routines? If YES, users can access the spell
  546.      checker from the status bar. Please note, the spell checker does take a
  547.      little time, as it must cross reference every word with the dictionary.
  548.      Also, words smaller than 3 letters will not be checked.
  549.  
  550.    ■ Quote Ratio YES/NO - Should IceEdit check to see if users have exceeded
  551.      the permitted percentage of quoted text?
  552.  
  553.    ■ Enforced Quote Ratio YES/NO - If the Quote Ratio is active, should IceEdit
  554.      enforce it? If YES, IceEdit will display a message telling the user
  555.      the current ratio, and that they must cut down. If NO, IceEdit will
  556.      mention the ratios and display them, and ask the user if they wish to
  557.      re-edit the message before saving.
  558.  
  559.    ■ Upcase Ratio YES/NO - Should IceEdit check to see if users have exceeded
  560.      the permitted percentage of Upcase text?
  561.  
  562.    ■ Enforce Upcase Ratio YES/NO - If the Upcase Ratio is active, should
  563.      IceEdit enforce it? If YES, IceEdit will display a message telling the
  564.      user the current ratio, and that they must cut down. If NO, IceEdit will
  565.      mention the ratio and display it, and ask the user if they wish to
  566.      re-edit the message before saving.
  567.  
  568.    ■ Allow Linedraw YES/NO - Should users be allowed to enable linedraw mode?
  569.  
  570.    ■ Message Censor YES/NO - Should IceEdit censor the message when the user
  571.      opts to save? This is a registered only feature. {+}
  572.  
  573.    ■ Quote Format YES/NO - Should IceEdit reformat quoted text? Some editors
  574.      (such as DOS EDIT) when used in conjunction with BlueWave cause
  575.      messages to be afflicted with what is commonly known as the
  576.      "Chainsaw Effect", caused by Hard Returns. IceEdit will now reformat
  577.      quoted text to remove this annoying problem.
  578.  
  579.    ■ QBBS compatible YES/NO - Is the BBS package you're running QBBS
  580.      compatible? (ie. QBBS, RA, TG as a few examples).  Does your BBS
  581.      package support kludgelines? If you can answer YES to either of these
  582.      questions, turn compatibility ON!
  583.  
  584.    ■ Message Header YES/NO - Should IceEdit import the sysop defined message
  585.      header upon execution?
  586.  
  587.    ■ Kludge filter YES/NO - If IceEdit finds *defined* kludgelines in the
  588.      quoted text, should it filter them?
  589.  
  590.    ■ Errorlevels YES/NO - Should IceEdit exit using the standard QBBS
  591.      compatible errorlevels?
  592.  
  593.    ■ Time Warning YES/NO - Should IceEdit warn the user when less than 5
  594.      minutes remain?
  595.  
  596.   Colors
  597.   --------
  598.  
  599.    ■ This section on color configuration is self explanatory. Simply select
  600.      the type of character which you wish to color configure. Another box
  601.      will appear that will show you the list of available colors. Type in
  602.      the number of the color you want to use.
  603.  
  604.    ■ DEFAULT SETTINGS will restore all the colors to their original
  605.      installation settings.
  606.  
  607.  
  608.   Macro Setup
  609.   -------------
  610.  
  611.    ■ Macro Editor - This will allow you to define replacement macros that
  612.      will be used within IceEdit. For example, if you defined a macro such as
  613.      "RA" -> "RemoteAccess", when the user types "RA" while editing their     
  614.      message, IceEdit will replace it with "RemoteAccess".  User Keywords are 
  615.      not case sensitive, so if the user was to type "RA" or "Ra" Or "rA" or   
  616.      "ra", each of these would still be replaced with "RemoteAccess". This    
  617.      function can be useful for correcting commonly misspelled words,
  618.      replacing shortforms, or "weeding out" inappropriate text (refer to     
  619.      message censoring function aswell).  The macrofile used in IceEdit is    
  620.      completely compatible with IceChat's macrofile, so you can interchange   
  621.      the macro files between both pieces of software.
  622.  
  623.    ■ MacroFile Sorter - This will allow you to sort the macrofile in
  624.      alphabetical order by User Keyword. It will also strip the spaces
  625.      between macros to eliminate gaps.
  626.  
  627.    ■ Macro Triggers - Which characters (when typed after a macro) should
  628.      trigger the macro conversion? These characters usually consist of
  629.      punctuation.
  630.  
  631.   Function Keys
  632.   ---------------
  633.  
  634.    ■ This section is fairly simple.  You can define different Function keys
  635.      (F1,F2..etc) to insert text into the message body while you are editing  
  636.      your message. This is useful for greetings, goodbyes, and signatures     
  637.      that are commonly used. For example, I might configure my Fn Keys like   
  638.      this :
  639.  
  640.      F1 - Take Care,
  641.      F2 - Later..
  642.      F3 - Jeremy
  643.      F4 - SysOP, Ice Technologies
  644.      F5 - .. Author Of IceEdit.
  645.  
  646.      etc.. etc..
  647.  
  648.      If I hit one of my Fn Keys while in IceEdit, the appropriate text would  
  649.      be inserted at the current cursor position. Function keys can also be
  650.      used to IMPORT files, such as multiline sigs. This is done by putting
  651.      the prefix '@' before the path to the file name. ie:
  652.  
  653.      F1 - @SIG.TXT
  654.  
  655.      If the file can't be found, it will simply do nothing.  Make sure you
  656.      specify the full path for the file, or else IceEdit will assume the
  657.      file should be in the current directory.
  658.  
  659.      If you wish to run an external utility from within IceEdit using the
  660.      function keys, simply use the '#' prefix in from the the commandline,
  661.      ie:
  662.  
  663.      F1 - #D:\BBS\ICECHAT\ICECHAT.EXE -D:D:\BBS\RA
  664.  
  665.      Assuming that the commandline is correct, the program will be executed.
  666.  
  667.   Other
  668.   -------
  669.  
  670.    ■ Strike Symbol [*] - What character should IceEdit use when striking out
  671.      text that can be found in the Censor.Cfg file. Asterisk ("*") is the
  672.      default.
  673.  
  674.    ■ SysOp Security - What is the SysOp security level to activate the
  675.      dictionary 'word-adding' feature.
  676.  
  677.    ■ Quote Ratio % - Up to what percentage is Quoted text allowed in the
  678.      message text.
  679.  
  680.    ■ Upcase Ratio % - Up to what percentage is upcase text allowed in the
  681.      message text.
  682.  
  683.    ■ # Of Taglines - What number of taglines should a user be allowed to pick
  684.      from when they have chosen to save their message? [1..10] (User makes
  685.      use of light bar to select tagline)
  686.  
  687.    ■ Dropfile Type - Which type of dropfile should IceEdit use? (DORINFO1.DEF,
  688.      DORINFOX.DEF, or DOOR.SYS)
  689.  
  690.    ■ Kludge Codes - IceEdit will filter kludges prefixed the the characters
  691.      configured in this section.
  692.  
  693.    ■ Menu Brackets - Configure left and right menu brackets surrounding
  694.      lightbar options, and some information fields.
  695.  
  696.    ■ Scroll Length - Configure total scroll length of main editing screen
  697.      when the end of page is reached.
  698.  
  699.  ┌───────────────────────────────────────────────────────────────────────────┐
  700.  │░░░▒▒▒▓▓▓         Setting Up IceEdit.Exe With RemoteAccess        ▓▓▓▒▒▒░░░│
  701.  └───────────────────────────────────────────────────────────────────────────┘
  702.  
  703.   Please read the section of this document entitled 'Program Information -    
  704.   Using EditCfg' BEFORE attempting to install IceEdit into RA. Failure to     
  705.   setup  IceEdit correctly before installing it into your bbs program will    
  706.   probably  result in IceEdit failing to run or not running as expected.
  707.  
  708.   In order to run IceEdit.Exe with a user ONLINE, you must have a fossil      
  709.   driver  active. A fossil driver such as BNU should work fine with IceEdit.
  710.   If you  don't have a fossil driver installed, a simple error message will   
  711.   be displayed, and the program will stop. A fossil is NOT required when      
  712.   running locally.
  713.  
  714.   **Note** : Do _NOT_ write protect _ANY_ Of the IceEdit files, if you do,
  715.              IceEdit will ignore them, and therefore not run properly.
  716.  
  717.   We will now run through EVERYTHING you need to do in order to get IceEdit   
  718.   to  run in your RemoteAccess setup.
  719.  
  720.  
  721.   1. Extract all the files in the distribution archive to a directory of your
  722.      choice. C:\RA\ is recommended and is assumed to be the directory you are
  723.      using from now on.
  724.  
  725.   2.  Run EditCfg.Exe and configure all of IceEdit's options as explained
  726.       earlier in this document. You MUST configure IceEdit for it to work
  727.       correctly! Refer to the section of this document for setting up IceEdit.
  728.  
  729.   3.  IceEdit needs to be setup in RACONFIG.EXE so that when the user attempts
  730.       to write a message it calls up IceEdit and NOT the internal RemoteAccess
  731.       line-by-line editor. Change to your RemoteAccess directory and run
  732.       RACONFIG.EXE. Go to OPTIONS>MESSAGES>EXTERNAL EDITOR. Place the command-
  733.       line to run IceEdit.Exe in this space. Eg.
  734.  
  735.         C:\RA\ICEEDIT.EXE *M
  736.  
  737.       If you wish, you can specify the path to the dropfiles read in by
  738.       IceEdit (Dorinfo1.Def, MsgInf, and MsgTmp if it exists) by adding
  739.       the following parameter to your commandline like this:
  740.  
  741.         ICEEDIT.EXE /D:[PATH TO DROPFILES]
  742.  
  743.       Eg:   C:\RA\ICEEDIT.EXE /D:C:\RA
  744.  
  745.       Otherwise IceEdit will assume the dropfiles are located in the current
  746.       directory (usually your BBS directory)
  747.  
  748.       If you are PLANNING TO RUN ICEEDIT FROM YOUR NEWUSER.Q-A, then you
  749.       should use the following commandline in your RaConfig setup.
  750.  
  751.         C:\RA\ICEEDIT.EXE /B:*B /P:*P /T:*T *M
  752.  
  753.  
  754.       *B - Passes the baudrate out to the commandline.
  755.       *P - Passes the modem port out to the commandline.
  756.       *N - Passes the nodenumber as read from the %TASK% environment variable
  757.            out to the commandline.
  758.       *M - Activate the MemorySwap feature.
  759.       *T - Passes time limit out to the commandline.
  760.  
  761.   4.  When you run IceEdit, be sure that the IceEdit.Cfg file has been created.
  762.       If it has not, then you MUST run EditCfg.Exe. If you don't, and attempt
  763.       to run IceEdit.Exe directly, IceEdit will display an error message that
  764.       IceEdit.Cfg doesn't exist.
  765.  
  766.  ┌───────────────────────────────────────────────────────────────────────────┐
  767.  │░░░▒▒▒▓▓▓           Setting Up IceEdit.Exe With QuickBBS          ▓▓▓▒▒▒░░░│
  768.  └───────────────────────────────────────────────────────────────────────────┘
  769.  
  770.   QuickBBS Version 2.80 is supported FULLY in this version of IceEdit, which
  771.   includes automatic integration of your existing BBS message areas, as well
  772.   as proper display of all message headers.  IceEdit and QuickBBS work
  773.   together offering your users a powerful option of a feature-laden full
  774.   screen editor package compared to others which barely supported QuickBBS
  775.   specific requirements in years past.
  776.  
  777.   The following documentation will help you, a QuickBBS SysOp, to
  778.   successfully integrate IceEdit into your system, seamlessly...
  779.  
  780.  
  781.   INSTALLING ICEEDIT VIA QCONFIG (FULL SCREEN EDITOR SETTINGS):
  782.   -------------------------------------------------------------
  783.  
  784.   Go into QCONFIG, and pull down these menus:  MESSAGES -> EXTERNAL EDITOR
  785.  
  786.   Install accordingly, adjusting paths as necessary (example below):
  787.  
  788.  +------------------------External MessageEditor Setup----------------------+
  789.  |                                                                          |
  790.  |  Message Reply Quoting String: @>         Swap to Disk/EMS: Yes          |
  791.  |                                                                          |
  792.  |  DOS Command String:                                                     |
  793.  |  c:\qbbs\editor\iceedit.exe /N:*N                                        |
  794.  +--------------------------------------------------------------------------+
  795.  
  796.   (The above example assumes "c:\qbbs\editor\" is the path containing the
  797.   IceEdit distribution files, please adjust accordingly for your platform.)
  798.  
  799.   Note for calling IceEdit as a DOOR from a menu:
  800.  
  801.   If you load IceEdit as a door, via a TYPE 7 command in a menu, issue the
  802.   following command on the "optional data" line (example):
  803.  
  804.   *C /C *M d:\qbbs\editor\iceedit.exe /N:*N
  805.  
  806.   (Make sure the swap, *M, is there, and pass the node# to IceEdit as shown)
  807.  
  808.  
  809.   CONFIGURATION INFORMATION: EDITCFG.EXE
  810.   ======================================
  811.  
  812.   New Users to IceEdit who run QuickBBS, please note:
  813.  
  814.   *Before* running EDITCFG.EXE, make sure your "QUICK" environment variable
  815.   is set properly in your batch file(s) used to load the BBS, or autoexec.bat.
  816.   This environment variable should already be enabled, according to the
  817.   QuickBBS documentation.  This variable, such as "SET QUICK=C:\QBBS", points
  818.   to your main BBS path, where MSGCFG.DAT lives along with other BBS data
  819.   files.  EDITCFG.EXE looks for this environment variable the first time it
  820.   is run, and if found it automatically configures sensible defaults, and
  821.   enables the following integrated features:
  822.  
  823.   * IceEdit reads in your message areas directly, automatically!
  824.   * IceEdit creates certain toggles and defaults which work well with
  825.     QuickBBS!
  826.  
  827.   So make sure the "QUICK" environment variable is set, and active, when
  828.   you run EDITCFG.EXE for the first time if it's not already.
  829.  
  830.  
  831.   IMPORTANT CONFIGURATION CONCERNS WITHIN EDITCFG.EXE
  832.   ---------------------------------------------------
  833.  
  834.   Did you know all your QuickBBS defined message areas are loaded by
  835.   EDITCFG.EXE, and set to sensible defaults, automatically?  Also,
  836.   various sensible QuickBBS toggles and features are set:
  837.  
  838.   * By reading in your message areas, via EDITCFG.EXE, the following defaults
  839.     are given to the message areas on your BBS, automatically (and can be
  840.     easily overridden via "Area Manager" settings):
  841.  
  842.         * Private areas will have censorship options DISABLED
  843.         * Networked ECHO areas will have PIPECODES and ANSI disabled
  844.         * Kludge code of CONTROL-A (ASCII 1) is used
  845.  
  846.   * Proper errorlevels are issued for aborted messages under QuickBBS
  847.  
  848.   * SysOp security level and associated options should be set to 32000 or
  849.     whatever YOUR access level is on your system if you need to overide.
  850.  
  851.   * DORINFO1.DEF, DOOR.SYS are both supported and either can be enabled
  852.     under version 2.80 of QuickBBS.  Version 2.76a users, opt for
  853.     DORINFO1.DEF.
  854.  
  855.   * Since QuickBBS does not utilize "message number" fields in version 2.80,
  856.     you can easily toggle this setting via "Display Manager" settings menu
  857.     as well as the other header fields (both location and availability) if
  858.     desired, but are set to work with QuickBBS's MSGTMP and MSG.INF files,
  859.     automatically.
  860.  
  861.   * Under "Toggle 2", make sure "QBBS Compatible" is set to YES, which should
  862.     be set as the default if the "QUICK" environment variable is set
  863.     properly and active prior to the first time EDITCFG.EXE is run.
  864.  
  865.   * REMOTE file import mode for SysOps, initiated by CONTROL-F when entering a
  866.     message, is now supported as requested by QuickBBS users.
  867.  
  868.   * LOCAL file import, ALT-F2, is supported also!
  869.  
  870.  
  871.   SUPPORT FOR QUICKBBS: PLEASE NOTE...
  872.   ====================================
  873.  
  874.   All wish lists, bug reports, and incompatibility flaws as well as
  875.   questions regarding integration are welcomed.  The author will on occasion
  876.   visit the QuickBBS support echo (zone 1, backbone) so feel free to post
  877.   such requests and observations.  Direct support requires assistance from
  878.   concerned and helpful users.  The author is dedicated to continued
  879.   support for QuickBBS, whenever possible.  Try the automatic setup, be
  880.   sure to edit the message areas, and check out the toggles.  And, of
  881.   course, enjoy continued support and seamless integration of IceEdit and
  882.   QuickBBS!
  883.  
  884.  ┌───────────────────────────────────────────────────────────────────────────┐
  885.  │░░░▒▒▒▓▓▓           Setting Up IceEdit.Exe With Telegard          ▓▓▓▒▒▒░░░│
  886.  └───────────────────────────────────────────────────────────────────────────┘
  887.  
  888.   Please read the section of this document entitled 'Program Information -    
  889.   Using EditCfg' BEFORE attempting to install IceEdit into TG. Failure to     
  890.   setup  IceEdit correctly before installing it into your bbs program will    
  891.   probably  result in IceEdit failing to run or not running as expected.
  892.  
  893.   In order to run IceEdit.Exe with a user ONLINE, you must have a fossil      
  894.   driver  active. A fossil driver such as BNU or X00 should work fine with
  895.   IceEdit.  If you  don't have a fossil driver installed, a simple error
  896.   message will be displayed, and the program will stop. A fossil is NOT
  897.   required when running locally.
  898.  
  899.   **Note** : Do _NOT_ write protect _ANY_ Of the IceEdit files, if you do,
  900.              IceEdit will ignore them, and therefore not run properly.
  901.  
  902.   We will now run through EVERYTHING you need to do in order to get IceEdit   
  903.   to  run in your Telegard setup.
  904.  
  905.  
  906.   1.  Extract all the files in the distribution archive to a directory of
  907.       your choice. C:\TG\ICEEDIT\ is recommended and is assumed to be the
  908.       directory you are using from now on.
  909.  
  910.   2.  Run EditCfg.Exe and configure all of IceEdit's options as explained
  911.       earlier in this document. You MUST configure IceEdit for it to work
  912.       correctly! Refer to the section of this document for setting up IceEdit.
  913.  
  914.   3.  IceEdit needs to be setup in Telegard so that when the user has a choice
  915.       to either use the internal line-by-line editor or using IceEdit.  You
  916.       can accomplish this by doing the following.  Go to your Telegard
  917.       directory, run Telegard.EXE.  Go to "S"ystem Config -> "X"ternal
  918.       Utilities -> "C" Full Screen Editor.  Place the command-line to run
  919.       IceEdit.Exe in this space.
  920.  
  921.         Eg. C:\TG\ICEEDIT\ICEEDIT.EXE
  922.  
  923.   4.  When you run IceEdit, be sure that the IceEdit.Cfg file has been
  924.       created. If it has not, then you MUST run EditCfg.Exe. If you don't,
  925.       and attempt to run IceEdit.Exe directly, IceEdit will display an error
  926.       message that ICEEDIT.CFG doesn't exist.
  927.  
  928.   5.  Be sure to set the ICEEDIT (IEDIT, not ICEEDIT) environment variable
  929.       for this above setup, if it is left out, you will recieve errors.
  930.  
  931.   There are many different ways of setting up IceEdit to work with Telegard.  This above way is one way it will work, if you know
  932.   another way that works then by all means, use it.  This is meant for the
  933.   first time beginner who does not know how to setup IceEdit with Telegard.
  934.  
  935.  ┌───────────────────────────────────────────────────────────────────────────┐
  936.  │░░░▒▒▒▓▓▓            Errorlevels Generated By IceEdit             ▓▓▓▒▒▒░░░│
  937.  └───────────────────────────────────────────────────────────────────────────┘
  938.  
  939.   Once IceEdit's execution has ended, it will generate one of two errorlevels
  940.   under normal termination.
  941.  
  942.     0 - If IceEdit terminates with errorlevel 0, it means that the message
  943.         has been successfully saved, and should be processed by the BBS
  944.         package.
  945.  
  946.     1 - If IceEdit terminates with errorlevel 1, it means that the message
  947.         has either been aborted; or, that the user attempted to save a blank
  948.         message. In either case, the BBS package should treat the message as
  949.         aborted, and NOT process the message.
  950.  
  951.     2 - If IceEdit terminates with errorlevel 2, it means that the user's
  952.         keyboard has been inactive for more than the maximum time allowed.
  953.         The program has terminated, and may have saved the message body to
  954.         the MSGTMP file (or equivalent) if autosaving is enabled.
  955.  
  956.  ┌───────────────────────────────────────────────────────────────────────────┐
  957.  │░░░▒▒▒▓▓▓             Files That Are Used By IceEdit              ▓▓▓▒▒▒░░░│
  958.  └───────────────────────────────────────────────────────────────────────────┘
  959.  
  960.   IceEdit will call upon a number of files during runtime. They are listed
  961.   below along with a brief description.
  962.  
  963.    CENSOR.CFG    - This is a textfile containing inappropriate words that
  964.                    IceEdit will strike out of the message text when they are
  965.                    encountered. {+}
  966.  
  967.    CONFIG.RA     - This file is read ONCE only by EDITCFG when you first
  968.    CONFIG.TG       install IceEdit. It will only be read if EditCfg can find
  969.    QUICKCFG.DAT    the BBS environment variable. It is compatible with the
  970.                    RA 2.xx/TG 3.00/QBBS v2.80 configuration files only. It
  971.                    will not read the Ra 1.1x format.
  972.  
  973.    COL_HELP.ANS  - This is an ANSi file that will be displayed that will
  974.                    replace the hardcoded colour help menu. You can create
  975.                    this with an ANSi editor such as TheDraw.
  976.  
  977.    DORINFO1.DEF  - This is the dropfile that most BBS packages can create
  978.                    that holds important user profile information.
  979.  
  980.    EDITHDR.TXT   - This file will be imported into the beginning of the
  981.                    message if it is enabled, and IceEdit can locate it. It
  982.                    should be in the main IceEdit directory.
  983.  
  984.    ICEEDIT.CFG   - This is IceEdit's configuration file. It is absolutely
  985.                    necessary in order for IceEdit.Exe to function.
  986.  
  987.    ICEEDIT.DIC   - This is the IceEdit dictionary that is used in conjunction
  988.                    with the spellcheck feature. It comes in a separate package
  989.                    from the main IceEdit program, due to its size.
  990.  
  991.    ICEEDIT.IDX   - This is the IceEdit dictionary index file that comes with
  992.                    the dictionary. It is also located in the secondary package.
  993.  
  994.    ICEEDIT.MDX   - This file is scanned by IceEdit if you are using RA, and
  995.                    have run EDITCFG.EXE INDEX.  This file is an index that
  996.                    contains the current toggle settings for all message areas.
  997.                    Toggle settings include taglines, pipecodes, ANSi
  998.                    filtering, and message censoring.
  999.  
  1000.    KEY_HELP.ANS  - This is an ANSi file that will be displayed that will
  1001.                    replace the hardcoded Userkey help menu. You can create
  1002.                    this with an ANSi editor such as TheDraw.
  1003.  
  1004.    MACRO.CFG     - This is the file that contains the replacement macros that
  1005.                    can be used in IceEdit. It is compatible with the MACRO.CFG
  1006.                    file that IceChat uses. This file must be edited using
  1007.                    EDITCFG.EXE.
  1008.  
  1009.    MSGHDR.ANS    - An ANSI screen which IceEdit will use instead of the
  1010.                    default screen header on the message editing screen.
  1011.  
  1012.    MSGINF.       - This file contains message writing information.
  1013.    MSG.INF
  1014.  
  1015.    MSGTMP.       - This file can contain both quoted message text as well as
  1016.                    the regular message text that will be read back in by the
  1017.                    BBS package.
  1018.  
  1019.    ICETAG.###    - This is a tagline database that IceEdit will use to pick
  1020.                    a random tagline to be appended to the end of messages. {+}
  1021.  
  1022.  ┌───────────────────────────────────────────────────────────────────────────┐
  1023.  │░░░▒▒▒▓▓▓           IceEdit.Exe Commandline Parameters            ▓▓▓▒▒▒░░░│
  1024.  └───────────────────────────────────────────────────────────────────────────┘
  1025.  
  1026.   Note: ALL Commandline parameters are optional, and do NOT have to be used
  1027.   unless you are trying something new and different with IceEdit =). Generally
  1028.   these parameters are only used with you are trying to run IceEdit without
  1029.   a DORINFO1.DEF file (such as an offline mail reader)
  1030.  
  1031.     /B:[BAUD]     - Use this parameter to specify the baudrate.
  1032.                     Eg.  ICEEDIT.EXE /B:14400
  1033.  
  1034.     /BW           - Use this parameter to tell IceEdit that you are using an
  1035.                     offline mail reader, such as BlueWave. If this is the
  1036.                     case, your commandline generally will not use any of the
  1037.                     other commandline parameters.
  1038.  
  1039.     /D:[PATH]     - Use this parameter to specify the path ONLY to the
  1040.                     dropfiles that are to be used by IceEdit (DORINFO1.DEF,
  1041.                     MSGTMP, MSGINF) Eg. ICEEDIT.EXE /D:C:\RA\LINE2
  1042.  
  1043.     /F:[FILENAME] - Use this parameter to change the default textfile name
  1044.                     that message text will be stored in. (Default = "MSGTMP")
  1045.                     This is useful for offline mail readers.
  1046.                     Eg. ICEEDIT.EXE /F:MSGTEMP.BBS
  1047.  
  1048.     /FORCE        - Use this parameter to make sure that the user can't
  1049.                     abort the message they are writing. This is useful for
  1050.                     NewUser Questionnaires, where you want to make sure the
  1051.                     user actually writes an introductory comment.
  1052.  
  1053.     /K:[TIMEOUT]  - Use this parameter to specify in SECONDS how long IceEdit
  1054.                     will wait in keyboard inactivity before disconnecting.
  1055.  
  1056.     /L            - Use this parameter to run IceEdit in local test mode.
  1057.                     Eg. ICEEDIT.EXE /L
  1058.  
  1059.     /N:[NODE]     - Use this parameter to specify the NODE that IceEdit is
  1060.                     being run on. A MUST FOR MULTINODE SYSTEMS!!!!!!
  1061.                     (Default = 1)
  1062.  
  1063.     /P:[COMPORT]  - Use this parameter to specify comport to be used by
  1064.                     IceEdit. If you port is com3, then this is the
  1065.                     commandline: ICEEDIT.EXE /P:3
  1066.  
  1067.     /T:[MINUTES]  - Use this parameter to specify the amount of time
  1068.                     remaining for the user. Eg. ICEEDIT.EXE /T:30
  1069.  
  1070.     Please note: If you change any values above that correspond with values
  1071.                  in the DORINFO1.DEF File, then the DORINFO1.DEF value will
  1072.                  be ignored.
  1073.  
  1074.     There is one more parameter that was added in during the v1.60 betas.
  1075.     I had planned on removing it, however I've left it in for those who
  1076.     really need to fine-tune IceEdit to their system. This parameter controls
  1077.     how much timeslicing will occur in multitasking environments. The LARGER
  1078.     the value, the LESS slicing that occurs.  IceEdit defaults to 20, which
  1079.     was the optimum value on all test systems. Following is a symptom/solution
  1080.     chart:
  1081.  
  1082.     Symptom:                     | Solution:
  1083.     -------------------------------------------------------------------------
  1084.     IceEdit, when run in a       | IceEdit is giving up TOO many timeslices
  1085.     multitasking environment is  | in your multitasking environment. You
  1086.     really slow, although the    | should INCREASE the value, so that IceEdit
  1087.     other windows run fine.      | gives LESS timeslices.
  1088.     -------------------------------------------------------------------------
  1089.     IceEdit runs absolutely      | IceEdit is "hogging the CPU" (it's not
  1090.     great in my environment,     | giving up enough timeslices). Correct for
  1091.     with no lag or delays.       | this by DECREASING the value, so that
  1092.     However, while IceEdit is    | IceEdit gives up time slices more
  1093.     running, my other windows    | frequently.
  1094.     slow to a crawl.             |
  1095.     -------------------------------------------------------------------------
  1096.  
  1097.     The parameter to use to adjust IceEdit's slicing is:
  1098.  
  1099.     /S:[value]     - [value] represents the slice value, as outlined above.
  1100.                      We recommend you play with this only if *** YOU REALLY
  1101.                      KNOW WHAT YOU'RE DOING! ***
  1102.  
  1103.  ┌───────────────────────────────────────────────────────────────────────────┐
  1104.  │░░░▒▒▒▓▓▓             Editing your message in IceEdit             ▓▓▓▒▒▒░░░│
  1105.  └───────────────────────────────────────────────────────────────────────────┘
  1106.  
  1107.   Function Keys
  1108.   ---------------
  1109.  
  1110.   To make message editing go easier, there are a number of different keys that
  1111.   may be used by both the SysOP and the user. A list follows:
  1112.  
  1113.   UP ARROW     - Moves the cursor up one line
  1114.   DOWN ARROW   - Moves the cursor down one line
  1115.   LEFT ARROW   - Moves the cursor to the left one space
  1116.   RIGHT ARROW  - Moves the cursor to the right one space
  1117.   INSERT       - Toggle the text insert/typeover mode
  1118.   DELETE       - Delete the character currently under the cursor
  1119.  
  1120.   CTRL-A or /A - Abort message text & exit program
  1121.   CTRL-B       - Restore line of text from buffer
  1122.   CTRL-C       - Center the current line of text on the screen
  1123.   CTRL-D       - Move cursor to the right one space
  1124.   CTRL-E       - Move cursor up one line
  1125.   CTRL-F       - Remotely import a file (SYSOP ONLY)
  1126.   CTRL-J       - Left justify the current line of text on the screen
  1127.   CTRL-K       - Toggle LineDraw mode ON or OFF, or select line style
  1128.   CTRL-L       - List / edit available macros
  1129.   CTRL-P       - Place cursor at the end of the line
  1130.   CTRL-Q or /Q - Quote window (Available only with message replies)
  1131.   CTRL-R       - Redraw the editing screen
  1132.   CTRL-S       - Move cursor to the left one space
  1133.   CTRL-T       - Delete text from the cursor to the end of the line
  1134.   CTRL-U       - Delete text from the cursor to the end of the current word
  1135.   CTRL-V       - Toggle INSERT/TYPEOVER Modes
  1136.   CTRL-W or /Q - Quote window (Available only with message replies)
  1137.   CTRL-X       - Move cursor down one line
  1138.   CTRL-Y       - Erase current line of text
  1139.   CTRL-Z or /S - Save message text & exit program
  1140.  
  1141.   There are also SysOP only keys that may be used:
  1142.  
  1143.   F1.. 10      - Activate previously defined SysOp text macros
  1144.   ALT- F2      - Import a textfile into the message
  1145.   ALT- F3      - Export message contents to a file
  1146.   ALT- C       - Invoke external chat utility
  1147.   ALT- H       - Terminate Connection
  1148.   ALT- J       - Shell to DOS
  1149.   ALT- =       - Add one minute to user's time
  1150.   ALT- -       - Subtract one minute from user's time
  1151.  
  1152.   Imbedded Replacement Strings
  1153.   ------------------------------
  1154.  
  1155.   All replacement macros, taglines and SysOp function keys can make use of
  1156.   the following built in control strings (NOTE ** Some are repeated to ensure
  1157.   compatibility with ICECHAT replacement strings) :
  1158.  
  1159.     @A = SysOp name (Read From IceEdit Configuration)
  1160.     @B = BBS name (Read From IceEdit Configuration)
  1161.     @C = Receiving users full name
  1162.     @D = Date
  1163.     @H = Message subject
  1164.     @F = Receiving users first name
  1165.     @R = Receiving users first name
  1166.     @S = SysOp name (Read From IceEdit Configuration)
  1167.     @T = Time of day
  1168.     @U = Sending user's first name
  1169.     @V = Program version number
  1170.  
  1171.   The control strings can be used in the following manner. For Example, if
  1172.   you were configuring one of your macros to tell the current time & Date,
  1173.   you could put:
  1174.  
  1175.     "MTD" -> "This message was written at @T on @D."
  1176.  
  1177.   And then when IceEdit is run, if the user chooses to type in the "MTD"
  1178.   macro, the strings would be replaced and the result would be:
  1179.  
  1180.     "This message was written at 2:41p on 02/19/95."
  1181.  
  1182.   All the control strings can be used in a similar manner in all the other
  1183.   macros & taglines, and Fn keys.
  1184.  
  1185.   Imbedded Colors
  1186.   -----------------
  1187.  
  1188.   With IceEdit, it is possible to use color codes into your Message text.
  1189.   This is very easily done. Wherever you would like to have a color change in
  1190.   your message, use one of the following colour combinations:
  1191.  
  1192.        0 - Black                       8 - DarkGray
  1193.        1 - Blue                        9 - LightBlue
  1194.        2 - Green                       A - LightGreen
  1195.        3 - Cyan                        B - LightCyan
  1196.        4 - Red                         C - LightRed
  1197.        5 - Magenta                     D - LightMagenta
  1198.        6 - Brown                       E - Yellow
  1199.        7 - LightGray                   F - White
  1200.  
  1201.   Combine these colour codes to create a foreground & background colour.
  1202.  
  1203.     ie. |4E would yield yellow foreground on red background
  1204.  
  1205.   The first value represents the background colour, the second value
  1206.   represents the foreground colour.
  1207.  
  1208.   So, If you had a line such as:
  1209.  
  1210.     "|15This is a |09test."
  1211.  
  1212.   The first three words "This is a" would be in White, and the rest, "Test."
  1213.   would be in LightBlue once the message has been saved.
  1214.  
  1215.   Please be aware of two important points. Firstly, IceEdit will NOT CHANGE
  1216.   the color WHILE YOU ARE EDITING the message.  Color strings will be
  1217.   converted when the message is saved. Second, these codes are replaced with
  1218.   ANSi escape sequences (the same codes that are used in your ANSi screens).
  1219.  
  1220.   Many networks  do not authorize ANSi escape codes in their echos.  If you
  1221.   are going to  make use of this feature, it is recommended that users are
  1222.   informed on the  point that they should not use embedded color strings in
  1223.   echomail areas. If you are using RemoteAccess, it is possible to make
  1224.   IceEdit determine whether or not the message area is a local base. If it is
  1225.   NOT, IceEdit can automatically temporarily disable Imbedded colors in the
  1226.   message that the user is writing.
  1227.  
  1228.   Imbedded Files
  1229.   ----------------
  1230.  
  1231.   With IceEdit, it is possible to have external filenames that will be later
  1232.   imported into into your Message text. This is very easily done. Wherever
  1233.   you would like to have a file imported into your message, use the following
  1234.   method. For Example, say you have a textfile with some type of header in it
  1235.   that you want to import into your message. The filename of the header is
  1236.   BBSHDR.ASC for our example. In your message you would put the following on
  1237.   a blank line of text:
  1238.  
  1239.     %[BBSHDR.ASC]%
  1240.  
  1241.   When your message is saved, IceEdit will seek out the filename between the
  1242.   two special brackets ( %[ and ]% ). You can specify the path of the file
  1243.   aswell, if the file is not located in your current directory, for example:
  1244.  
  1245.     %[C:\BBS\TXTFILES\BBSHDR.ASC]%
  1246.  
  1247.   When the message is saved, IceEdit will find this file, and import it into
  1248.   the body of the message text, so your message might end up looking like
  1249.   this:
  1250.  
  1251.           ▐██▌░▄█████▄ ▄██████░ ███████░▄██████░▄█████▄ ██░  ██░
  1252.            ██░ ██░░░░░ ██▄▄▄▄░    ▐█▌░░░██▄▄▄▄░ ██░░░░░ ██▄▄▄██░
  1253.            ██░ ██░     ██▀▀▀▀░    ▐█▌░  ██▀▀▀▀░ ██░     ██▀▀▀██░
  1254.           ▐██▌░▀█████▀ ▀██████░   ▐█▌░  ▀██████░▀█████▀ ██░░░██░
  1255.            ██░   ██░░░  ██░██░    ██░    ██░██░░  ██░░░ ██░  █▌░
  1256.            ▐▌░   ▐▌░    ▐▌░▐▌░    ▐▌░    ▐▌░▐▌░   ▐▌░   ▐▌░  ▐░
  1257.             ▌░   ▐░      ▌░       ▐░      ▌░      ▐░    ▐░
  1258.  
  1259.  
  1260.   Please be aware of an important point. IceEdit will NOT IMPORT the file(s)
  1261.   WHILE YOU ARE EDITING the message. File(s) will only be imported when the
  1262.   message is saved.
  1263.  
  1264.   LineDraw Mode
  1265.   ---------------
  1266.  
  1267.   IceEdit has a "linedraw" mode. When the user activates this mode, it is
  1268.   possible to draw High-Bit ASCII lines on the screen by using the Cursor
  1269.   Keys (Left, Right, Up, Down). There are 3 line styles available:
  1270.  
  1271.     1) ╔═╗
  1272.     2) ╒═╕
  1273.     3) ┌─┐
  1274.  
  1275.  
  1276.   And that's all there is to it.. Hope you guys enjoy this thing, and it is
  1277.   my hope that IceEdit becomes the default editor used with your system =-)
  1278.  
  1279.  ┌────────────────────────────────────────────────────────────────────────────┐
  1280.  │░░░▒▒▒▓▓▓             Other Ice Technologies Utilities             ▓▓▓▒▒▒░░░│
  1281.  └────────────────────────────────────────────────────────────────────────────┘
  1282.  
  1283.   Here is a list of all the Ice Technologies utilities that were available at
  1284.   the time of release of this archive. If you enjoy using this Ice utility,
  1285.   you may want to check some of these out! :)
  1286.  
  1287.   ■ IceChat -
  1288.  
  1289.     IceChat is a split screen chat utility for RemoteAccess/ProBoard BBS
  1290.     packages. It can be used with many other BBS types as long as they
  1291.     support Dorinfo1.Def/Door.Sys type Doors.
  1292.  
  1293.   ■ IceEdit -
  1294.  
  1295.     IceEdit is a fullscreen ANSi message editor that was originally designed
  1296.     for use with RemoteAccess. Although it has been tested with
  1297.     RA v2.xx, QBBS, and Telegard v3.0 it should be compatible with any
  1298.     other BBS that uses the QuickBBS style dropfiles that contain the
  1299.     message writing information. These files are MSGTMP & MSGINF. You should
  1300.     check your BBS documentation to   see if your software supports this
  1301.     system. IceEdit also calls on the Dorinfo1.Def file to read in necessary
  1302.     information about the user profile.
  1303.  
  1304.   ■ IceMGR -
  1305.  
  1306.     The very newest Ice Technologies utility.  Unlike the other programs,
  1307.     this program is run offline as a bulletins generator, message poster,
  1308.     nightly maintenance utility.
  1309.  
  1310.   ■ IceNote -
  1311.  
  1312.     IceNote is the third Ice Technologies door to become available. It is a
  1313.     message to all users type door with many neat features.  It has been
  1314.     tested with both RemoteAccess v2.xx, and the latest release of Renegade,
  1315.     and should work with any other Dorinfo1.Def compatible BBS Packages.
  1316.  
  1317.   ■ IceBank -
  1318.  
  1319.     IceBank is the fourth utility to become available. It is a fully
  1320.     functional, fully configurable timebank system for RA v2.xx/PB v2.xx.
  1321.     It has many cool features, including InterBBS transactions.
  1322.  
  1323.   ■ IceUser -
  1324.  
  1325.     This is the fifth utility to become available. It is a fully
  1326.     functional online user editor for RemoteAccess v2.xx.  Very secure.
  1327.  
  1328.   ■ IceCBV -
  1329.  
  1330.     IceCBV is the sixth utility to become available!  Took awhile to finally
  1331.     get it released, but you won't be disappointed.  Full featured callback
  1332.     verification system for RemoteAccess and ProBoard. Many unique features!
  1333.     Look forward to even more features in the next version!
  1334.  
  1335.  ┌───────────────────────────────────────────────────────────────────────────┐
  1336.  │░░░▒▒▒▓▓▓       Program Support - Internet Email Addresses        ▓▓▓▒▒▒░░░│
  1337.  └───────────────────────────────────────────────────────────────────────────┘
  1338.  
  1339.   Following is a list of support/distribution/registration sites which
  1340.   currently have Internet email addresses. Please contact any of these sites
  1341.   via email for assistance with any Ice Technologies product.
  1342.  
  1343.        Jeremy Landvoigt                     John Piper
  1344.        jlandvoigt@interhop.net              japp@mpx.com.au
  1345.        Canadian Registrations               Australian Registrations
  1346.  
  1347.        Kevin Mckillop                       Dan Jones
  1348.        mckillop@rogerswave.ca               dan.jones@ivsoft.com
  1349.        Website Manager                      American Registrations
  1350.  
  1351.  ┌───────────────────────────────────────────────────────────────────────────┐
  1352.  │░░░▒▒▒▓▓▓            Program Support - BBS Locations              ▓▓▓▒▒▒░░░│
  1353.  └───────────────────────────────────────────────────────────────────────────┘
  1354.  
  1355.   All Ice Technologies utilities are available from our homepage at:
  1356.   http://www.ionsys.com/~mckkev/icesoft.html
  1357.  
  1358.   IceEdit can be File Requested from any of the following BBS's under the     
  1359.   magic name of ICEEDIT.
  1360.  
  1361.   Legend
  1362.   ──────
  1363.  
  1364.   S - Support Site  B - Beta Site  R - Registration Site  D - Distrib. Site
  1365.  
  1366.   Ice Technologies          SysOp Central             Lateline BBS
  1367.   Ontario, Canada           Chicago, USA              Penshurst, Australia
  1368.   (905) 895-7775            (773) 583-0489            +61-2-9579-6564
  1369.   FidoNET 1:2424/912        FidoNET 1:115/583         FidoNET 3:712/841
  1370.   Max. Baud: 28800          Max. Baud: 33600          Max. Baud: 33600
  1371.   Flags: S B R D            Flags: S R D              Flags: S R D B
  1372.  
  1373.   Beachcomber's Mailbox     The Coracle BBS           Lost Horizons BBS
  1374.   Langenloh, Germany        United Kingdom            Texas, USA
  1375.   +49-9827-4766             +44-1559-384404           (915) 757-1299
  1376.   FidoNET 2:2490/8016       FidoNET 2:25/10           FidoNET 1:381/92
  1377.   Max. Baud 28800           Max. Baud 28800           Max. Baud: 28800
  1378.   Flags: S R D B            Flags: S R D              Flags: D
  1379.  
  1380.   RaLin Enterprises         Battle Zone Systems       E.L.F. BBS
  1381.   California, USA           Ontario, Canada           Ontario, Canada
  1382.   (510) 226-7731            (905) 715-7963            (416) 269-8733
  1383.   FidoNET 1:215/710         FidoNET 1:2424/900        FidoNET 1:250/1001
  1384.   Max. Baud: 14400          Max. Baud 28800           Max. Baud: 28800
  1385.   Flags: D                  Flags: B D                Flags: S B D
  1386.  
  1387.   Silicon Creations
  1388.   Texas, USA
  1389.   (915) 949-4798
  1390.   FidoNET 1:383/47
  1391.   Max. Baud: 28800
  1392.   Flags: S B D
  1393.  
  1394.  ┌───────────────────────────────────────────────────────────────────────────┐
  1395.  │░░░▒▒▒▓▓▓               End Of IceEdit Documentation              ▓▓▓▒▒▒░░░│
  1396.  └───────────────────────────────────────────────────────────────────────────┘
  1397.