home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / gedit201.zip / GEDIT.TXT < prev    next >
Text File  |  1993-07-01  |  89KB  |  2,220 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                         GEdit
  20.  
  21.                                     Version 2.01
  22.  
  23.                               Released on July 1, 1993
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                              Written by Chris Patterson
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                    COPYRIGHT 1992,93 The Developers Network, Inc.
  50.                                  All Rights Reserved
  51.  
  52.  
  53.        GEdit 2.01                   July 1, 1993                       Page 2
  54.        ----------------------------------------------------------------------
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.        COPYRIGHT 1992,93 The Developers Network, Inc.
  97.  
  98.        All Rights Reserved.  No part of the contents of this document may  be
  99.        reproduced in whole or in part without the express written  permission
  100.        of The Developers Network, Inc.
  101.  
  102.        This document was written using Microsoft Word for Windows.
  103.  
  104.        Names  of  products  mentioned  herein  are  used  for  identification
  105.        purposes only and  may be trademarks  and/or registered trademarks  of
  106.        their respective  companies.    Microsoft and  MS-DOS  are  registered
  107.        trademarks and Windows is a trademark of Microsoft Corporation.
  108.  
  109.  
  110.  
  111.        ----------------------------------------------------------------------
  112.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  113.  
  114.  
  115.        GEdit 2.01                   July 1, 1993                       Page 3
  116.        ----------------------------------------------------------------------
  117.  
  118.  
  119.                                   Table of Contents
  120.  
  121.        Table of Contents .............................................3
  122.        Words from the Author .........................................4
  123.        Shareware Notice ..............................................5
  124.             Disclaimer and Warranty Information ......................5
  125.        Distribution ..................................................6
  126.             Obtaining the Latest Version of GEdit ....................6
  127.        Registering GEdit .............................................7
  128.             Competitive Upgrade ......................................7
  129.             Registration Benefits ....................................7
  130.        GEdit Registration Form .......................................8
  131.        Introduction ..................................................9
  132.             Features .................................................9
  133.             Technical Features .......................................11
  134.        Installation ..................................................12
  135.             The GEdit Environment Variable ...........................12
  136.             Installing GEdit on Your BBS .............................13
  137.             Installing GEdit for Use With BlueWave ...................14
  138.        Command-Line Parameters .......................................15
  139.        Using GEdit ...................................................16
  140.             Entering a Message .......................................16
  141.             Editing a Message ........................................17
  142.             Quoting Original Message Text ............................17
  143.        Controlling GEdit from the Local Keyboard .....................19
  144.             User Interface Features ..................................19
  145.             Moving and Resizing Windows ..............................19
  146.             Using Dialog Boxes .......................................19
  147.             The Editing Window .......................................20
  148.             The Status Bar ...........................................20
  149.             Color Configuration ......................................20
  150.        The GEdit Menu System .........................................21
  151.             The Main Menu ............................................21
  152.             The Message Menu .........................................21
  153.             The Quote Menu ...........................................22
  154.             The Help Menu ............................................23
  155.             The Terminal Menu ........................................23
  156.        Keyboard Reference ............................................25
  157.             Sysop Keys ...............................................27
  158.        Programmable Function Keys ....................................29
  159.        Appendix A ....................................................30
  160.             The QuickBBS-style MSGTMP External Editor Interface ......30
  161.        Appendix B ....................................................32
  162.             Troubleshooting Problems .................................32
  163.        Appendix C ....................................................33
  164.             The DOS Application Class Library ........................33
  165.        Index .........................................................36
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.        ----------------------------------------------------------------------
  174.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  175.  
  176.  
  177.        GEdit 2.01                   July 1, 1993                       Page 4
  178.        ----------------------------------------------------------------------
  179.  
  180.  
  181.                                 Words from the Author
  182.  
  183.        It has been  just over a  year since the  first version  of GEdit  was
  184.        released.  I  must admit,  I was surprised  to see  how quickly  GEdit
  185.        became the most talked about editor for QuickBBS clones.  Almost every
  186.        system I have called is now using GEdit.
  187.  
  188.        There haven't been many  updates released over the  past year.   GEdit
  189.        has been  working great  for  many Sysops.    However, some  have  had
  190.        problems getting GEdit to work properly in their configurations.  This
  191.        was partially  due to  some inherent  problems  in the  libraries  and
  192.        partially due to poor application design.
  193.  
  194.        New BBS packages were being released and updated at an alarming  rate,
  195.        each one making it's own changes to the original QuickBBS data  files.
  196.        Since GEdit  was originally  written to  work with  RemoteAccess,  the
  197.        application was tied closely to the  RemoteAccess data files.  It  was
  198.        at this point I began to redesign GEdit from the ground up.
  199.  
  200.        GEdit 2.01 is the result of  the past year's work.   The new GEdit  is
  201.        written in pure C++ source code.   The new BBS interface routines  are
  202.        completely object-oriented  with a  separate module  defined for  each
  203.        individual BBS  package.   This makes  adding support  for a  new  BBS
  204.        package easy and  allows for more  complete support  of each  package.
  205.        Since each module is self-contained, changes made for one BBS will not
  206.        affect the support for other packages.
  207.  
  208.        (This was made obvious when version 1.00.06/Gamma was released and the
  209.        QuickBBS and SuperBBS support was broken.)
  210.  
  211.        Despite the  overwhelming  response to  GEdit,  registrations  haven't
  212.        matched up  to  the number  of  Sysops using  GEdit.   To  be  honest,
  213.        registrations haven't even come close.  Because of this, I  considered
  214.        releasing GEdit 2.01 for registered users  only.  However, due to  the
  215.        number of  changes  in version  2.01,  I am  going  to make  one  more
  216.        Shareware release.   Hopefully, Sysops will  realize that  GEdit is  a
  217.        quality product worth registering.
  218.  
  219.        This 2.01 release of GEdit will be  the first of several that will  be
  220.        released over the next  several months.  Many  new features are  being
  221.        added to make  GEdit even better.   I encourage  you to register  your
  222.        copy of GEdit 2.01 to make  sure that you will be  able to use all  of
  223.        the new features.   The functionality  of GEdit 2.01  will become  the
  224.        base feature set for future unregistered releases.
  225.  
  226.        I hope  you enjoy  using the  all new  GEdit 2.01.   If  you have  any
  227.        questions or comments regarding GEdit, see the support section of  the
  228.        manual for information on contacting the author.
  229.  
  230.                                      Chris Patterson, GEdit Author
  231.  
  232.  
  233.  
  234.  
  235.        ----------------------------------------------------------------------
  236.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  237.  
  238.  
  239.        GEdit 2.01                   July 1, 1993                       Page 5
  240.        ----------------------------------------------------------------------
  241.  
  242.  
  243.                                   Shareware Notice
  244.  
  245.        GEdit is distributed as Shareware.  You are licensed to use GEdit  for
  246.        evaluation purposes only.  After evaluating GEdit, you are  encouraged
  247.        to register (purchase) GEdit.  Registering your copy of GEdit not only
  248.        gives you peace of mind, but helps support future versions as well.
  249.  
  250.        The Developers  Network, Inc.  retains all  rights to  GEdit and  it's
  251.        source code.   The  source code  is not  available to  the public  and
  252.        remains the intellectual property of The Developers Network, Inc.
  253.  
  254.        No disassembly, reverse-engineering or modification of the  executable
  255.        images is allowed.  Use of an executable file compression utility such
  256.        as PK*Lite is allowed, however, product  performance can no longer  be
  257.        guaranteed.
  258.  
  259.  
  260.                          Disclaimer and Warranty Information
  261.  
  262.        GEdit is provided to the user "AS IS" with absolutely no warranties or
  263.        guarantees of any kind.   The Developers  Network, Inc. disclaims  all
  264.        warranties, either expressed or  implied.  The entire  risk as to  the
  265.        results and  operation of  GEdit is  assumed by  you, the  user.   The
  266.        Developers Network,  Inc.  does  not  make  any  claims,  promises  or
  267.        guarantees as to  the ability  to use or  inability to  use GEdit  and
  268.        cannot and do not accept any responsibility for system damage, loss of
  269.        profit, or  any other  special,  incidental or  consequential  damages
  270.        resulting from the use or inability to use this product.
  271.  
  272.        Furthermore, The Developers Network, Inc. reserves the right to revise
  273.        this publication and to make changes from time to time in the  content
  274.        hereof without obligation  of The Developers  Network, Inc. to  notify
  275.        any person or organization of such revision or changes.
  276.  
  277.        Caution has been taken to prevent any harmful or dangerous programming
  278.        errors in this  software program.   However,  The Developers  Network,
  279.        Inc. will take  no liability  for damages  either from  the direct  or
  280.        consequential use of this product.  If GEdit happens to destroy  data,
  281.        reformat your hard disk, burn out  your monitor or anything else  that
  282.        happens due to your use or inability  to use this program, you are  on
  283.        your own.
  284.  
  285.        We strongly recommend  that you  back up any  files that  may come  in
  286.        contact with  GEdit,  including  BBS  configuration  and  data  files.
  287.        Regularly scheduled backups should be an important part of your weekly
  288.        routine due to the random nature of computer hardware failure.
  289.  
  290.        The only guarantee is that GEdit will occupy space on your hard disk.
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.        ----------------------------------------------------------------------
  298.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  299.  
  300.  
  301.        GEdit 2.01                   July 1, 1993                       Page 6
  302.        ----------------------------------------------------------------------
  303.  
  304.  
  305.                                     Distribution
  306.  
  307.        GEdit may be distributed by anyone, as long as the following rules are
  308.        followed:
  309.  
  310.           Nothing is modified, added  or deleted in  the original files.   No
  311.           additional files may be added to the distribution archive, however,
  312.           the  archive  format   may  be  changed.     Do  not   include  BBS
  313.           advertisements or logos in the GEdit distribution archive!
  314.  
  315.           No  fee  is  charged  for  distribution.    Bulletin  board  system
  316.           operators may charge a fee for the BBS itself, but no extra charges
  317.           for downloading GEdit are allowed.
  318.  
  319.           Shareware distributors  may  not make  a  profit from  distributing
  320.           GEdit unless  they  have  written  permission from  The  Developers
  321.           Network, Inc.   If  you wish  to  include GEdit  in your  Shareware
  322.           collection, please contact The  Developers Network, Inc.  to obtain
  323.           the appropriate agreement.
  324.  
  325.           GEdit may not  be included with  any other software  package unless
  326.           the distributor  obtains  written  permission from  The  Developers
  327.           Network, Inc.
  328.  
  329.           Registration keys for GEdit may not be distributed to anyone by any
  330.           unauthorized  individuals  or  organizations.    The  only  parties
  331.           eligible  to  distribute  GEdit  registration   keys  are  properly
  332.           authorized registration sites.
  333.  
  334.           GEdit key files contain  personal information about  the registered
  335.           user and should remain confidential.  Registered users may not give
  336.           their KEY files to  anyone.  If you  give your KEY file  to another
  337.           user, your  own personal  information will  be  displayed on  their
  338.           system.
  339.  
  340.           Use of an unauthorized registration key other  than one provided to
  341.           you by The Developers Network, Inc. constitutes  a violation of the
  342.           license agreement.
  343.  
  344.  
  345.                         Obtaining the Latest Version of GEdit
  346.  
  347.        The most recent  version of  GEdit is  always available  from the  The
  348.        Developers Network BBS.   The BBS  is available 23  hours per day  and
  349.        supports baud rates of 2400 through 19200 BPS.  Both v.32bis and ZyXEL
  350.        protocols are available.
  351.  
  352.                              The Developers Network BBS
  353.                                1-918-251-6252 (U.S.A.)
  354.                                  1:170/303 (FidoNET)
  355.  
  356.  
  357.  
  358.  
  359.        ----------------------------------------------------------------------
  360.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  361.  
  362.  
  363.        GEdit 2.01                   July 1, 1993                       Page 7
  364.        ----------------------------------------------------------------------
  365.  
  366.  
  367.                                   Registering GEdit
  368.  
  369.        After evaluating GEdit,  you must pay  for GEdit  by registering  your
  370.        copy.   To register,  simply complete  the  registration form  on  the
  371.        following page  and send  it, along  with  the appropriate  amount  in
  372.        United States currency (cash, check or money order) to:
  373.  
  374.                             The Developers Network, Inc.
  375.                                     P.O. Box 1660
  376.                                Broken Arrow, OK  74013
  377.                                          USA
  378.  
  379.           Please make all checks payable to:  The Developers Network, Inc.
  380.  
  381.        To  register  using  a  credit  card,  you  must  contact  the  Public
  382.        (software) Library .   You can  use your  Master Card,  Visa, American
  383.        Express or Discover card.  Complete the registration form so that  all
  384.        the necessary information is available.  Then contact the PsL at:
  385.  
  386.                  United States (voice)    1-800-242-4PsL (4775)
  387.                  Overseas (voice)         1-713-524-6394
  388.                  FAX                      1-713-524-6398
  389.                  CompuServe               71344,470
  390.  
  391.        Please allow 2 to 4 weeks for your registration to be processed.
  392.  
  393.  
  394.                                  Competitive Upgrade
  395.  
  396.        If you are a registered owner  of TopEd, QuickEd, or EzyEdit, you  can
  397.        upgrade to GEdit for  a reduced price.   See the  order form for  more
  398.        information.  Proof of registration is  required.  If you want to  use
  399.        the credit card registration, the upgrade pricing is not available.
  400.  
  401.  
  402.                                 Registration Benefits
  403.  
  404.        Registering your copy of GEdit will remove all of the limitations  and
  405.        registration messages.   You  will also  receive priority  service  in
  406.        response  to  questions  and   suggestions.    All  suggestions   from
  407.        registered users are considered for future releases of GEdit.
  408.  
  409.        You are also granted free access  to The Developers Network BBS.   The
  410.        BBS always contains the most recent  version of GEdit and has an  area
  411.        for discussing GEdit  enhancements and improvements.   There are  also
  412.        over 650 megabytes of Shareware  and public domain software  available
  413.        for download.
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.        ----------------------------------------------------------------------
  422.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  423.  
  424.  
  425.        GEdit 2.01                   July 1, 1993                       Page 8
  426.        ----------------------------------------------------------------------
  427.  
  428.  
  429.        GEdit Registration Form                                PsL Part #10808
  430.  
  431.            Sysop Name:              ___________________________________
  432.  
  433.            System Name:             ___________________________________
  434.  
  435.            Mailing Address:         ___________________________________
  436.  
  437.                                     ___________________________________
  438.  
  439.                                     ___________________________________
  440.  
  441.                                     ___________________________________
  442.  
  443.            Voice Phone:             ___________________________________
  444.  
  445.            BBS Software:            ___________________________________
  446.  
  447.            BBS Phone:               ___________________________________
  448.  
  449.            BBS Network Inf.:        ___________________________________
  450.  
  451.            GEdit Version:           ___________________________________
  452.  
  453.            How would you like your GEdit key delivered?
  454.  
  455.            _____ FidoNET File Attach, specify address: _______________
  456.  
  457.            _____ UUENCODED E-Mail, specify address: __________________
  458.  
  459.            _____ CompuServe E-Mail, specify address: _________________
  460.  
  461.            _____ Postal Service Mail, specify disk format: ___________
  462.  
  463.            Registration Amount Enclosed:
  464.  
  465.            _____ Regular Registration, $20
  466.  
  467.            _____ Competitive Upgrade, $15
  468.  
  469.            _____ Credit Card Registration, $25
  470.  
  471.                  Credit Card Number  ______________________________
  472.  
  473.                  Expiration Date     ______________________________
  474.  
  475.                  Signature           ______________________________
  476.  
  477.                    (Pricing for GEdit is current as of this manuals)
  478.                         (release date shown in the page header)
  479.  
  480.  
  481.  
  482.  
  483.        ----------------------------------------------------------------------
  484.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  485.  
  486.  
  487.        GEdit 2.01                   July 1, 1993                       Page 9
  488.        ----------------------------------------------------------------------
  489.  
  490.  
  491.                                     Introduction
  492.  
  493.        Thank you for  trying GEdit.   GEdit is a  feature loaded  full-screen
  494.        message editor for use with on-line bulletin board systems.  GEdit has
  495.        the widest compatibility of any full-screen message editor, supporting
  496.        most of the newest  QuickBBS-style BBS packages.   GEdit will improve
  497.        your bulletin board  system by providing  a fast and  easy method  for
  498.        users to enter and  reply to messages.   GEdit has an easy-to-use  and
  499.        learn editing facility and includes  many advanced features not  found
  500.        in any other editor.
  501.  
  502.        GEdit should run on any IBM-PC,  PC-XT or 100% compatible system  with
  503.        at least 350k of free conventional memory.  It will work with either a
  504.        color or monochrome monitor and requires MS-DOS version 3.0 or later.
  505.  
  506.        GEdit 1.00 was  first introduced  on March 15,  1992.   Over the  past
  507.        year, GEdit has been drastically improved over the original  releases.
  508.        There is not one line of the original  code in this new version.   The
  509.        functionality and extendibility of the  program has been increased  to
  510.        provide more features and less programming errors.
  511.  
  512.        GEdit version  2.01 includes  full support  for RemoteAccess , EzyCom,
  513.        SuperBBS, ProBoard and QuickBBS .  GEdit will  automatically determine
  514.        under which environment it is  running and adjust itself  accordingly.
  515.        There are certain  restrictions to this  automatic detection that  are
  516.        detailed in the Installation section of this manual.
  517.  
  518.        GEdit can also be used with the various off-line mail readers such  as
  519.        BlueWave.  This allows  users to use the  familiar interface of  GEdit
  520.        when editing messages off-line as well as on-line.
  521.  
  522.  
  523.                                       Features
  524.  
  525.           Full support for RemoteAccess, EzyCom, SuperBBS,  and QuickBBS.  At
  526.           release time, GEdit has been tested with the most recent version of
  527.           the above listed software  packages.  See the  requirements section
  528.           for the specific version information.
  529.  
  530.           The easiest installation of any full-screen editor in the business.
  531.           Simply install  GEDIT.EXE  as the  full-screen  message editor  and
  532.           forget about anything else forever.  No configuration is necessary.
  533.           All information is read  from the software configuration  files for
  534.           the fastest setup of any editor!
  535.  
  536.           Support for  ANSI,  ANSI  3.64,  AVATAR/0 and  AVATAR/0+  emulation
  537.           codes.   The  emulation  mode can  be  configured  by the  user  to
  538.           eliminate any possible compatibility problems.   ANSI support level
  539.           is automatically determined.
  540.  
  541.           Compatible with DOORWAY/AVATAR  remote keyboard  codes, as  well as
  542.           the VT-100 keypad codes sent by many  terminal applications.  Extra
  543.  
  544.  
  545.        ----------------------------------------------------------------------
  546.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  547.  
  548.  
  549.        GEdit 2.01                   July 1, 1993                      Page 10
  550.        ----------------------------------------------------------------------
  551.  
  552.           code is included to handle the non-standard codes sent by FrontDoor
  553.           Terminal.
  554.  
  555.           Automatic line- and word-wrap  while entering text,  including full
  556.           paragraph reformatting.  Word-wrapped  paragraphs are automatically
  557.           reformatted as text is entered or deleted.
  558.  
  559.           User screen  length is  adjusted by  the user  file information  to
  560.           provide the  maximum  possible  editing  area.   Screen  output  is
  561.           optimized for screen size and terminal emulation mode as well.
  562.  
  563.           Very easy-to-use interface provides a short  learning curve for new
  564.           as well as experienced  users.  An  all new, intuitive  menu system
  565.           helps beginners get up to speed quickly.
  566.  
  567.           Advanced file import and export functions, including the ability to
  568.           load a file into  the quote window  for browsing and  pasting text,
  569.           are included.
  570.  
  571.           The user  can adjust  their terminal  settings without  leaving the
  572.           editor.
  573.  
  574.           A  keystroke  is  included  to  allow   the  Sysop  to  immediately
  575.           disconnect those "problem" users.
  576.  
  577.           The Sysop  can  adjust  the  time  remaining  for  a  user  with  a
  578.           keystroke.
  579.  
  580.           Flexible quote  window  with  full  navigation  makes  replying  to
  581.           messages easier than ever.   The quote window can  also be adjusted
  582.           at will to provide a larger viewing area.  The quote option is only
  583.           available when quote text is present to avoid confusion.
  584.  
  585.           Message information  such as  the sender  name,  receiver name  and
  586.           message subject are displayed while editing when GEdit is used with
  587.           supported software packages.
  588.  
  589.           Multiple node support,  including enhanced  support for  EzyCom, is
  590.           now included.    GEdit  will  now  match the  requirements  of  all
  591.           supported  software.    GEdit  supports  EzyCom's  extended  editor
  592.           interface allowing multiple nodes to run from a single directory.
  593.  
  594.           Minimal screen  updating  for improved  response  time with  slower
  595.           modem connections.
  596.  
  597.           Sysop features  such as  file import  and  export and  programmable
  598.           function keys  are usable  during both  remote and  local sessions.
  599.           See the  command-line option  section for  information on  enabling
  600.           this feature.
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.        ----------------------------------------------------------------------
  608.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  609.  
  610.  
  611.        GEdit 2.01                   July 1, 1993                      Page 11
  612.        ----------------------------------------------------------------------
  613.  
  614.                                  Technical Features
  615.  
  616.           GEdit is written in 100%  C++ and compiled using  the Microsoft C++
  617.           compiler.  All of  the support classes were  developed in-house and
  618.           no external libraries were used.   The class library  and tools are
  619.           in the process of being packaged for resale.  For more information,
  620.           see Appendix B.
  621.  
  622.           Serial communications are performed using the FOSSIL driver for the
  623.           widest possible compatibility.  In order to support systems that do
  624.           not use a FOSSIL driver, interrupt-driven  serial port routines are
  625.           built-in.
  626.  
  627.           Carrier, user time remaining  and idle time-outs are  all monitored
  628.           internally for safe operation, eliminating down-time.
  629.  
  630.           All video routines are  handled internally, including the  ANSI and
  631.           AVATAR/0+ emulation decoding.  This eliminates the need for DVANSI,
  632.           ANSI.SYS or any other console drivers.
  633.  
  634.           Most multitaskers are  supported,  including  DESQview , Microsoft
  635.           Windows, and  OS/2.   Idle  time-slices  are  passed  off  to  the
  636.           multitasker for scheduling to other tasks.
  637.  
  638.           Network compatible, including Novell NetWare 386, Microsoft Windows
  639.           for Workgroups, Lantastic and NetWare Lite.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.        ----------------------------------------------------------------------
  670.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  671.  
  672.  
  673.        GEdit 2.01                   July 1, 1993                      Page 12
  674.        ----------------------------------------------------------------------
  675.  
  676.  
  677.                                     Installation
  678.  
  679.        GEdit is simple to install and only requires modification to your  BBS
  680.        configuration.  GEdit  has been  tested with  the following  packages:
  681.        RemoteAccess [including RA/Professional] 1.11  and 2.00, EzyCom  1.02,
  682.        ProBoard 1.30, SuperBBS 1.17, QuickBBS 2.76, and BlueWave 2.10
  683.  
  684.        In addition to the above software  packages, GEdit will work with  any
  685.        BBS that can create a DORINFO1.DEF  file and uses the QuickBBS  MSGTMP
  686.        style  full-screen  editor  interface.    (See  Appendix  A  for  more
  687.        information on the MSGTMP interface.)
  688.  
  689.        GEdit has been  designed to automatically  detect the  BBS package  in
  690.        use.  However, due to the number of different packages now  available,
  691.        certain restrictions have been placed on  this features.  In order  to
  692.        ensure correct identification  of the BBS  type, GEdit  will scan  the
  693.        environment for  the  environment  variables  used  by  the  different
  694.        software packages.  The environment variables scanned for are:
  695.  
  696.                       Env. Variable       Software Package
  697.  
  698.                       EZY                 EzyCom
  699.                       PROBOARD            ProBoard
  700.                       QUICK               QuickBBS
  701.                       RA                  RemoteAccess
  702.                       SBBS                SuperBBS
  703.  
  704.        If more than one  of these variables are  specified, you must use  the
  705.        GEDIT environment variable to tell GEdit which BBS is being used.
  706.  
  707.  
  708.                            The GEdit Environment Variable
  709.  
  710.        Certain system configurations  specify more than  one BBS  environment
  711.        variable and may cause the  automatic configuration routines to  fail.
  712.        Because of this,  there is a  GEDIT environment variable  that can  be
  713.        used to override the default detection.  The environment variable must
  714.        be set before running GEdit.
  715.  
  716.        An example of setting the GEdit environment variable would be:
  717.  
  718.             SET GEDIT=BBS:PROBOARD
  719.  
  720.        This would force GEdit to attempt to obtain the exit information  from
  721.        the ProBoard system files before attempting to automatically determine
  722.        the system configuration.
  723.  
  724.        The following  option is  used by  GEdit  from the  GEDIT  environment
  725.        variable.
  726.  
  727.             BBS:<type>     Forces GEdit  to  check for  a  specific  BBS
  728.                            package before checking for  others.  If  the
  729.                            specified BBS package could not be found, the
  730.  
  731.        ----------------------------------------------------------------------
  732.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  733.  
  734.  
  735.        GEdit 2.01                   July 1, 1993                      Page 13
  736.        ----------------------------------------------------------------------
  737.  
  738.                            automatic detection will attempt to determine
  739.                            the real  type.    This  is  only  needed  on
  740.                            systems that have  more than one  of the  BBS
  741.                            environment variables defined.
  742.  
  743.                            The following values are valid:
  744.  
  745.                               Value     Software Package
  746.                               -----     ----------------
  747.                               DORINFO   Generic DORINFO1.DEF Type System
  748.                               EZY       EzyCom
  749.                               PROBOARD  ProBoard
  750.                               RA        RemoteAccess
  751.                               QUICK     QuickBBS
  752.                               SBBS      SuperBBS
  753.  
  754.  
  755.                             Installing GEdit on Your BBS
  756.  
  757.        To install GEdit on your BBS, you must first unpack the archive into a
  758.        directory.  GEdit should  be placed in  it's own directory  underneath
  759.        your main bulletin board system directory.  For example:
  760.  
  761.                                      C:\RA\GEDIT
  762.  
  763.        Installing GEdit in it's  own directory allows you  to keep GEdit  and
  764.        it's associated files in a single location.  This is not required, but
  765.        does keep the system directory less cluttered.
  766.  
  767.        The GEdit help files (GE_?????.A??) can either be located in the  same
  768.        directory as GEDIT.EXE, or  they can be placed  in your BBS text  file
  769.        directory.  The text file directory is checked first, and if the files
  770.        are not found, the directory containing GEDIT.EXE is then checked.
  771.  
  772.        GEdit will  store  any additional  files,  such as  the  function  key
  773.        definition file  and  configuration file,  in  the same  directory  as
  774.        GEDIT.EXE.  If you are running a multiple-line system, make sure  that
  775.        all of the nodes are using the same  copy of GEDIT.EXE.  If all  lines
  776.        are not using the same program file, the configuration and macro files
  777.        may not contain the same information.
  778.  
  779.        In order for users to be able to use GEdit, you must install it as the
  780.        full-screen editor in your BBS  configuration file.  Example  command-
  781.        lines for the supported BBS packages are shown below:
  782.  
  783.             RemoteAccess   C:\RA\GEDIT\GEDIT.EXE -N*N *M
  784.             EzyCom         C:\EZY\GEDIT\GEDIT.EXE -N*N *M
  785.             SuperBBS       C:\SUPERBBS\GEDIT\GEDIT.EXE -N*N *S
  786.             QuickBBS       C:\QUICKBBS\GEDIT\GEDIT.EXE -N*N *M
  787.             ProBoard       *SGEDIT\GEDIT.EXE -N*#
  788.             Generic        C:\BBS\GEDIT\GEDIT.EXE
  789.  
  790.  
  791.  
  792.  
  793.        ----------------------------------------------------------------------
  794.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  795.  
  796.  
  797.        GEdit 2.01                   July 1, 1993                      Page 14
  798.        ----------------------------------------------------------------------
  799.  
  800.        If your BBS software is not supported in this version of GEdit, please
  801.        urge the  BBS author  to  contact The  Developers  Network, Inc.    If
  802.        possible, support will be added.
  803.  
  804.  
  805.                        Installing GEdit for Use With BlueWave
  806.  
  807.        GEdit can be installed for use  with BlueWave by specifying  GEDIT.EXE
  808.        as the external editor name in the BlueWave configuration.  When GEdit
  809.        is loaded by BlueWave, GEdit will come up in local mode and allow  the
  810.        message to be edited.  When  entering a new message, editing  proceeds
  811.        normally.  When  replying to a  message, GEdit will  place the  quoted
  812.        reply text in  the quote buffer  for selected pasting  of quote  text.
  813.        When editing an existing message, GEdit  will still place the text  in
  814.        the quote buffer  since BlueWave  does not  make any  sort of  "editor
  815.        information" file for use by the editor.
  816.  
  817.        To install GEdit, unpack the GEdit archive into it's own directory and
  818.        configure GEdit to use GEdit as the external editor.  An example:
  819.  
  820.             C:\BLUEWAVE\GEDIT.EXE
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.        ----------------------------------------------------------------------
  856.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  857.  
  858.  
  859.        GEdit 2.01                   July 1, 1993                      Page 15
  860.        ----------------------------------------------------------------------
  861.  
  862.  
  863.                                Command-Line Parameters
  864.  
  865.        Some GEdit options  can be configured  using command-line  parameters.
  866.        All command-line parameters must be separated by spaces and parameters
  867.        cannot be combined.
  868.  
  869.             -N<node>       Indicates the node number of the current user
  870.                            on-line.  If  this option  is not  specified,
  871.                            GEdit will default to 1.
  872.  
  873.             -S<level>      Indicates the minimum  Sysop security  level.
  874.                            If the user's security  level is equal to  or
  875.                            greater than the  level specified, the  Sysop
  876.                            functions  (function  keys,  file  importing,
  877.                            etc.) are available to the user during  local
  878.                            and remote editing sessions.
  879.  
  880.                                      !! NOTE !!
  881.          If you are using a supported BBS package, you should not use any of
  882.                               the following variables!
  883.  
  884.             -R<lines>      Indicates the number of lines to use for  the
  885.                            editing area.   The  information is  normally
  886.                            read from the user  record.  When editing  in
  887.                            local mode, the number  of lines is equal  to
  888.                            the current screen length.
  889.  
  890.             -A<graphics>   Indicates the  graphics capabilities  of  the
  891.                            user.   "1"  indicates  ANSI,  "2"  indicates
  892.                            AVATAR,  and  "3"  indicates  both  ANSI  and
  893.                            AVATAR (AVATAR will be used).
  894.  
  895.             -M<timeLeft>   Indicates the number of minutes remaining  in
  896.                            the editing session.
  897.  
  898.             -I<inActive>   Indicates the number of  seconds the user  is
  899.                            allowed   to   remain   idle   before   being
  900.                            disconnected.  This is ignored in local mode.
  901.  
  902.        Multiple command-line parameters  can be specified.   Each  individual
  903.        command-line parameter must be separated by a space.  An example would
  904.        be:
  905.  
  906.             GEDIT.EXE -N3 -S100
  907.  
  908.        This would load GEdit, specify the node number as node 3 and specify a
  909.        Sysop security level of 100.  Any user with a security level of 100 or
  910.        greater will have access to the Sysop functions while editing.
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.        ----------------------------------------------------------------------
  918.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  919.  
  920.  
  921.        GEdit 2.01                   July 1, 1993                      Page 16
  922.        ----------------------------------------------------------------------
  923.  
  924.  
  925.                                      Using GEdit
  926.  
  927.        GEdit provides the  user an easy-to-understand  screen layout to  make
  928.        editing messages easier.  The screen layout is clean and provides  the
  929.        largest possible workspace for editing.
  930.  
  931.        The GEdit screen is  divided into sections.   There is an  information
  932.        bar at the top of the screen, the editing window  is in the middle and
  933.        the command section is at the bottom of the screen.
  934.  
  935.        On the left side  of the information  bar, operational information  is
  936.        shown, including  the program  version,  terminal emulation  mode  and
  937.        editing mode.  The  editing mode has  three possible settings,  insert
  938.        mode (INS), overwrite mode (OVR) or line drawing mode (LIN).
  939.  
  940.        The middle portion of the information bar contains who the message  is
  941.        from, who it is to, and the subject of the message.
  942.  
  943.        The right side of the information  bar displays the local time on  the
  944.        BBS and the number  of minutes remaining on-line.   As time  remaining
  945.        runs short, the time remaining counter  will flash and a warning  beep
  946.        will sound every minute.
  947.  
  948.        The editing  portion  of the  screen  is  where the  message  text  is
  949.        displayed.  New text is displayed in one color and quoted message text
  950.        is displayed in a different color.
  951.  
  952.        When replying to  a message, the  editing window is  divided into  two
  953.        sections and the quote window is displayed in the lower portion with a
  954.        line separating  the  two  areas.   The  separator  contains  a  quick
  955.        reference of  the  extra  keystrokes available  while  the  cursor  is
  956.        located in the quote window.
  957.  
  958.        The command section and the editing area are separated by a help line.
  959.        The help line tells the user  which keys will activate the GEdit  menu
  960.        and quote  function.    The quote  function  is  only  available  when
  961.        replying to a message and  quote text is available.   The name of  the
  962.        area where the message is being entered is centered on the line.
  963.  
  964.        The command section has several purposes.  Copyright and  registration
  965.        information is  displayed during  normal editing.   When  the menu  is
  966.        activated, the  menu options  are displayed.    When an  operation  is
  967.        completed, status messages are displayed.
  968.  
  969.  
  970.                                  Entering a Message
  971.  
  972.        Using GEdit to enter  a message is easier  than using a  line-oriented
  973.        editor.  There are no complex commands  to learn and you can reword  a
  974.        phrase as many times as you like and correct errors as you go.
  975.  
  976.  
  977.  
  978.  
  979.        ----------------------------------------------------------------------
  980.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  981.  
  982.  
  983.        GEdit 2.01                   July 1, 1993                      Page 17
  984.        ----------------------------------------------------------------------
  985.  
  986.        Before you begin typing, position the cursor where you want to  insert
  987.        the text.   If the  message doesn't contain  any text,  the cursor  is
  988.        already positioned at the beginning of the message.
  989.  
  990.        To position the cursor, press the arrow keys or the HOME, END, PAGE UP
  991.        and PAGE DOWN keys.
  992.  
  993.        To add  text to  a document,  position the  cursor where  you want  to
  994.        insert new  text and  type the  new text.   As  you type,  the  cursor
  995.        advances to the right.   GEdit automatically  adjust the text  between
  996.        the right and left margins, starting a new line where necessary.  This
  997.        is called word-wrap.
  998.  
  999.        NOTE:  If you press the INSERT key, the  status bar at the top of  the
  1000.        screen displays "OVR"  for over-type  mode.   The next  text you  type
  1001.        replaces the text that is at the cursor position.  If you press INSERT
  1002.        again, the text you type is inserted to the left of any existing text;
  1003.        the existing text moves to the right.
  1004.  
  1005.        Do not press the ENTER key  at the end of  each line.  Instead,  press
  1006.        ENTER only to start a new paragraph.  If you press ENTER at the end of
  1007.        each line, GEdit can't adjust the  line breaks when you add or  delete
  1008.        text.  Take advantage of word-wrap; it is one of the many benefits  of
  1009.        using a full-screen editor.
  1010.  
  1011.  
  1012.                                   Editing a Message
  1013.  
  1014.        Editing, or  revising, message  text  is easy  with  GEdit.   You  can
  1015.        delete, insert or rearrange text in a message.
  1016.  
  1017.        To delete a line  of text, press (Control-Y).   The current text  line
  1018.        will be deleted and stored in a "scrap" buffer.  The size of the scrap
  1019.        buffer is limited only by available memory.
  1020.  
  1021.        To insert a previously deleted line  of text, press (Control-U).   The
  1022.        last deleted line of  text is inserted before  the current text  line.
  1023.        If there  are no  lines  remaining in  the  scrap buffer,  nothing  is
  1024.        inserted.
  1025.  
  1026.  
  1027.                             Quoting Original Message Text
  1028.  
  1029.        When replying to a message,  it is a polite  to "quote" text from the
  1030.        original message to allow the original author to establish the context
  1031.        of your reply.  GEdit allows you to view the original message text  in
  1032.        a "quoted" form and  gives you the ability  to insert portions of  the
  1033.        quoted text into your reply message text.
  1034.  
  1035.        If quoted  text is  available,  the [  ^Q=Quote  ] indicator  will  be
  1036.        visible on the lower status line of  the editing screen.  To open  the
  1037.        quote windows,  press  (Control-Q) or  activate  the menu  and  select
  1038.        (Q)uote, (O)pen.  The message editing area is separated into upper and
  1039.        lower sections.  The quote text is displayed in the lower window.
  1040.  
  1041.        ----------------------------------------------------------------------
  1042.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1043.  
  1044.  
  1045.        GEdit 2.01                   July 1, 1993                      Page 18
  1046.        ----------------------------------------------------------------------
  1047.  
  1048.        The cursor can be positioned in  the quote window using the same  keys
  1049.        that are used to  position the cursor when  editing the message  text.
  1050.        However, the text in the quote window cannot be modified.
  1051.  
  1052.        To copy an entire line of text from the quote window into the message,
  1053.        position the cursor at the beginning of the line you wish to copy  and
  1054.        press the [Enter] key.  This line  will be copied into the message  at
  1055.        the message window's cursor position and the cursor will move down one
  1056.        line.
  1057.  
  1058.        To copy  a partial  line of  text, position  the cursor  at the  first
  1059.        character in the line you want to copy and hit [Enter].  The text from
  1060.        the cursor position to  the end of  the line will  be copied into  the
  1061.        message.  If there is a quote header at the beginning of the line,  it
  1062.        will be added to the beginning of the line automatically.
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.        ----------------------------------------------------------------------
  1104.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1105.  
  1106.  
  1107.        GEdit 2.01                   July 1, 1993                      Page 19
  1108.        ----------------------------------------------------------------------
  1109.  
  1110.  
  1111.                       Controlling GEdit from the Local Keyboard
  1112.  
  1113.        GEdit has  a number  of features  that are  available from  the  local
  1114.        keyboard.  These features  are only useful on  the local GEdit  system
  1115.        and have no benefit for the remote user.
  1116.  
  1117.  
  1118.                                User Interface Features
  1119.  
  1120.        The user  interface  library  used by  GEdit  provides  many  advanced
  1121.        capabilities.  All of  the windows on the screen  are independent and
  1122.        each window executes a different thread of code.
  1123.  
  1124.  
  1125.                              Moving and Resizing Windows
  1126.  
  1127.        All of the windows in GEdit (except for the gray dialog boxes) can  be
  1128.        moved and resized using the mouse.  The size of a window is limited by
  1129.        the physical size  of the  screen.  On  a system  with an  EGA or  VGA
  1130.        display adapter, you can use Alt-E to switch between 25 line and 43/50
  1131.        line modes.
  1132.  
  1133.        To resize a window, move the mouse cursor to the lower-right corner of
  1134.        the window and press and hold the  left mouse button.  Move the  mouse
  1135.        to adjust the window size.
  1136.  
  1137.        To move a window, move the mouse cursor  to the top row of the  window
  1138.        and press and  hold the left  mouse button.   Move the  mouse and  the
  1139.        window will follow the mouse around the screen.
  1140.  
  1141.        NOTE:  A window  does not have to  be on top to  be resized or  moved.
  1142.        Any window whose control points are accessable can be adjusted.
  1143.  
  1144.  
  1145.                                  Using Dialog Boxes
  1146.  
  1147.        GEdit uses dialog boxes to allow  configuration of certain items  such
  1148.        as programmable function  keys.   A dialog  box contains  a series  of
  1149.        "controls" that  allow input.   The  active  control has  a  different
  1150.        appearance than the  other controls.   Active fields  are a  different
  1151.        color and contain a cursor for editing the field text.  Active buttons
  1152.        are surrounded by a double border.
  1153.  
  1154.        To move between  fields in a  dialog box, use  tab, shift-tab, or  the
  1155.        arrow keys.  The tab key will move  to the next field in the  dialog's
  1156.        tab order, the shift-tab key moves  to the previous field.  The  arrow
  1157.        keys function changes depending on the type of the current field.
  1158.  
  1159.        The [Enter] and [Escape]  keys have special meaning  in a dialog  box.
  1160.        The [Enter]  key  will  activate the  default  button  in  the  dialog
  1161.        (indicated by  a half  double border)  as another  button is  not  the
  1162.        active control.  The [Escape] key  is the equivalent of canceling  the
  1163.        operation, usually without saving any changes.
  1164.  
  1165.        ----------------------------------------------------------------------
  1166.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1167.  
  1168.  
  1169.        GEdit 2.01                   July 1, 1993                      Page 20
  1170.        ----------------------------------------------------------------------
  1171.  
  1172.        The mouse can be used to select  controls in a dialog by clicking  the
  1173.        left mouse button.  Selecting a button with the mouse will execute the
  1174.        command associated with that button.  Selecting a field will make  the
  1175.        field active.   If an  active field is  selected with  the mouse,  the
  1176.        cursor will move to the selected location in the field.
  1177.  
  1178.  
  1179.                                  The Editing Window
  1180.  
  1181.        The editing window where the editor module of GEdit runs is a virtual,
  1182.        buffered window.  This means that the actual size of window buffer may
  1183.        be larger than the visible on-screen window.  This occurs when a  user
  1184.        with a screen length longer than the local physical screen can  handle
  1185.        uses GEdit.  When this happens, the visible portion of the buffer will
  1186.        "shift" as it follows the cursor, causing other portions of the screen
  1187.        to disappear past the edges of the on-screen window.  This shifting is
  1188.        only visible on the local  screen and the user  is unaware that it  is
  1189.        occurring.
  1190.  
  1191.  
  1192.                                    The Status Bar
  1193.  
  1194.        When a remote user is editing  with GEdit, a status bar emulating  the
  1195.        status bar of the  BBS package is displayed.   The status bar  changes
  1196.        appearance and size, depending on the BBS package in use.  This allows
  1197.        the local  Sysop to  view information  about the  current user.    The
  1198.        function keys  Shift-F1 through  Shift-F10 are  used to  select  which
  1199.        status bar panel  to view and  correspond to the  F1 through F10  keys
  1200.        used by the BBS package.
  1201.  
  1202.  
  1203.                                  Color Configuration
  1204.  
  1205.        The colors in the  editing window can  be configured using  the GEdit
  1206.        configuration dialog.  To display the configuration dialog, press Alt-
  1207.        S while GEdit  is loaded.   The up  and down  arrow keys  are used  to
  1208.        adjust the foreground and  the left and right  arrow keys are used  to
  1209.        adjust the background of the currently selected color.  You can select
  1210.        the current color using the  F5 and F6 keys.   When you are  finished,
  1211.        press [Escape] to close  the configuration dialog  and save the  color
  1212.        changes.
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.        ----------------------------------------------------------------------
  1228.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1229.  
  1230.  
  1231.        GEdit 2.01                   July 1, 1993                      Page 21
  1232.        ----------------------------------------------------------------------
  1233.  
  1234.  
  1235.                                 The GEdit Menu System
  1236.  
  1237.        GEdit uses a menu system to provide access to the large number of new
  1238.        features that  are available.   The  system consists  of a  series  of
  1239.        nested menus, each grouped by function.
  1240.  
  1241.        To access the menu, either press [Escape] or [Control-O] and the  menu
  1242.        will be  displayed.   When using  GEdit from  remote, there  may be  a
  1243.        slight delay due to  the remote input processing  routines.  Once  the
  1244.        menu is displayed, you select an option by pressing the letter that is
  1245.        highlighted in the menu option.  If that option contains a sub menu of
  1246.        other options,  the sub  menu is  displayed, otherwise  the option  is
  1247.        selected.  If you wish to return to the previous menu or exit the menu
  1248.        system, press [Escape] or [Control-O].
  1249.  
  1250.  
  1251.                                     The Main Menu
  1252.  
  1253.        The main menu contains the most basic functions, as well as options to
  1254.        display the more advanced menus.  The following options are  available
  1255.        at the main menu.
  1256.  
  1257.             Message                       Displays the message sub-menu.
  1258.  
  1259.             Quote                         Displays the quote sub-menu.
  1260.  
  1261.             Terminal                      Displays the terminal sub-menu.
  1262.  
  1263.             Help                          Displays the help sub-menu.
  1264.  
  1265.             Save                          Saves the current message and exits
  1266.                                           the editor.
  1267.  
  1268.             Continue                      Returns the cursor  to the  editing
  1269.                                           screen and exits the menu system.
  1270.  
  1271.             Abort                         Exits the editor without saving the
  1272.                                           current message.    A  confirmation
  1273.                                           prompt is displayed.
  1274.  
  1275.  
  1276.                                   The Message Menu
  1277.  
  1278.        The message menu  includes commands  that affect  the current  message
  1279.        being edited.  The following commands are available:
  1280.  
  1281.             Clear                         Clears the  current  message  text,
  1282.                                           allowing  the  user  to  begin  the
  1283.                                           message   from    scratch.        A
  1284.                                           confirmation prompt is displayed.
  1285.  
  1286.  
  1287.  
  1288.  
  1289.        ----------------------------------------------------------------------
  1290.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1291.  
  1292.  
  1293.        GEdit 2.01                   July 1, 1993                      Page 22
  1294.        ----------------------------------------------------------------------
  1295.  
  1296.             Export                        Allows  the  user  to  export   the
  1297.                                           current message text  to a file  on
  1298.                                           the system running the editor.
  1299.  
  1300.                                           NOTE:   The  user must  have  Sysop
  1301.                                           security to use this function.
  1302.  
  1303.             Import                        Allows the user to import text from
  1304.                                           a file  on the  system running  the
  1305.                                           editor into the current message  at
  1306.                                           the current cursor location.
  1307.  
  1308.                                           NOTE:   The  user must  have  Sysop
  1309.                                           security to use this function.
  1310.  
  1311.  
  1312.                                    The Quote Menu
  1313.  
  1314.        The quote menu  includes commands that  control the use  of the  quote
  1315.        window.  The following commands are available:
  1316.  
  1317.             Open                          Opens the  quote  window  if  quote
  1318.                                           text is available.
  1319.  
  1320.             Close                         Closes the  quote window  if it  is
  1321.                                           open.
  1322.  
  1323.             Switch                        Switches  the  cursor  between  the
  1324.                                           quote window and  the message  text
  1325.                                           window.
  1326.  
  1327.             Erase                         Erases the  text contained  in  the
  1328.                                           quote window and  closes the  quote
  1329.                                           window.  Use  this option when  the
  1330.                                           quote text is no longer needed  and
  1331.                                           memory is low.
  1332.  
  1333.             Load                          Allows the user to load a text file
  1334.                                           from the system running the  editor
  1335.                                           into the  quote window.   The  text
  1336.                                           may then be pasted into the message
  1337.                                           text    using    regular    quoting
  1338.                                           procedures.
  1339.  
  1340.                                           NOTE:   The  user must  have  Sysop
  1341.                                           security to use this function.
  1342.  
  1343.  
  1344.                                     The Help Menu
  1345.  
  1346.        The help menu allows the user to access the various help screens  that
  1347.        are available.  The following selections are available:
  1348.  
  1349.  
  1350.  
  1351.        ----------------------------------------------------------------------
  1352.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1353.  
  1354.  
  1355.        GEdit 2.01                   July 1, 1993                      Page 23
  1356.        ----------------------------------------------------------------------
  1357.  
  1358.             Editing                       Explains the  concepts of  using  a
  1359.                                           full-screen  message   editor   and
  1360.                                           gives a basic introduction to using
  1361.                                           GEdit.
  1362.  
  1363.             Quoting                       Explains what  message  quoting  is
  1364.                                           and how it is used.
  1365.  
  1366.             Keyboard                      Lists the function of all the  keys
  1367.                                           on the  keyboard  as  they  operate
  1368.                                           within GEdit.
  1369.  
  1370.  
  1371.                                   The Terminal Menu
  1372.  
  1373.        The terminal menu allows the user  to configure the various  terminal-
  1374.        related options of the editor.  The following options are available:
  1375.  
  1376.             ANSI-BBS                      The  most   basic  form   of   ANSI
  1377.                                           emulation.  This mode is used  with
  1378.                                           terminal programs that only support
  1379.                                           a very minimal  amount of the  ANSI
  1380.                                           standard.
  1381.  
  1382.             ANSI 3.64                     The regular ANSI  settings used  by
  1383.                                           most terminal  programs.    Uses  a
  1384.                                           number of  advanced ANSI  commands,
  1385.                                           including    line-scrolling     and
  1386.                                           clearing codes.
  1387.  
  1388.             AVATAR/0                      The basic AVATAR emulation standard
  1389.                                           as  defined  in  FSC-0025  of   the
  1390.                                           FidoNET     technical     standards
  1391.                                           document.  This should be used with
  1392.                                           terminals that do  not support  the
  1393.                                           advanced AVATAR specification.
  1394.  
  1395.             AVATAR/0+                     The   advanced   AVATAR   emulation
  1396.                                           standard as defined in FSC-0037  of
  1397.                                           the  FidoNET  technical   standards
  1398.                                           document.  This should be used with
  1399.                                           terminals   that   fully    support
  1400.                                           AVATAR/0+.
  1401.  
  1402.             Color                         Selects color operation.   This  is
  1403.                                           the standard mode of operation.
  1404.  
  1405.             Mono                          Selects black and white  operation.
  1406.                                           All  color  codes  are  suppressed,
  1407.                                           allowing   users   without    color
  1408.                                           displays to use the editor  without
  1409.                                           straining their  eyes to  determine
  1410.                                           the  difference   between   various
  1411.  
  1412.  
  1413.        ----------------------------------------------------------------------
  1414.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1415.  
  1416.  
  1417.        GEdit 2.01                   July 1, 1993                      Page 24
  1418.        ----------------------------------------------------------------------
  1419.  
  1420.                                           shades of  gray.   Great for  users
  1421.                                           with LCD screens as well.
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.        ----------------------------------------------------------------------
  1476.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1477.  
  1478.  
  1479.        GEdit 2.01                   July 1, 1993                      Page 25
  1480.        ----------------------------------------------------------------------
  1481.  
  1482.  
  1483.                                  Keyboard Reference
  1484.  
  1485.        The following keys are available while editing with GEdit.  Due to the
  1486.        fact that many  terminal programs  emulate the  keyboard in  different
  1487.        ways, the  KEY column  contains the  most direct  key to  perform  the
  1488.        specified action.  The ANSI/DOORWAY key is the most commonly  emulated
  1489.        keystroke that also performs the action.
  1490.  
  1491.             KEY       ANSI/DOORWAY        DESCRIPTION
  1492.  
  1493.             Control-A (Control-Left)      Moves the cursor  to the  beginning
  1494.                                           of the previous word.
  1495.  
  1496.             Control-B                     Centers the current line of text.
  1497.  
  1498.             Control-C (PgDn)              Moves the cursor down one screen.
  1499.  
  1500.             Control-D (Right)             Moves the cursor one column to  the
  1501.                                           right.
  1502.  
  1503.             Control-E (Up)                Moves the cursor one row up.
  1504.  
  1505.             Control-F (Control-Right)     Moves the cursor  to the  beginning
  1506.                                           of the next word.
  1507.  
  1508.             Control-G (Delete)            Deletes  the  character  under  the
  1509.                                           cursor.  If  the cursor  is at  the
  1510.                                           end of the line,  the next line  is
  1511.                                           moved up  to the  current line  and
  1512.                                           the text is reformatted.
  1513.  
  1514.             Control-H (Backspace)         Deletes the previous character.  If
  1515.                                           the cursor is  at the beginning  of
  1516.                                           the line, the  cursor will move  to
  1517.                                           the  end  of  the  previous   line,
  1518.                                           possibly causing  the  text  to  be
  1519.                                           reformatted.
  1520.  
  1521.             (Tab)     (Tab)               Moves  the  cursor   to  the   next
  1522.                                           horizontal tab stop.
  1523.  
  1524.             Control-J (Control-Enter)     When the  cursor  is in  the  quote
  1525.                                           window, this key  allows the  Sysop
  1526.                                           to search  the quote  buffer for  a
  1527.                                           text  string.     When   searching,
  1528.                                           pressing Control-J  again  after  a
  1529.                                           instance of the  specified text  is
  1530.                                           found  will  search  for  the  next
  1531.                                           instance of the same text string.
  1532.  
  1533.             Control-K                     Closes the  quote window  if it  is
  1534.                                           opened.
  1535.  
  1536.  
  1537.        ----------------------------------------------------------------------
  1538.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1539.  
  1540.  
  1541.        GEdit 2.01                   July 1, 1993                      Page 26
  1542.        ----------------------------------------------------------------------
  1543.  
  1544.             Control-L                     Repaints the entire  screen.   Used
  1545.                                           when line  noise causes  distortion
  1546.                                           of the screen display.
  1547.  
  1548.             (Enter)   (Enter)             Moves the cursor  to the  beginning
  1549.                                           of the next line.  If the cursor is
  1550.                                           not at the  end of  the line  while
  1551.                                           insert mode is active, the rest  of
  1552.                                           the line is moved down to the  next
  1553.                                           line.  A reformat is possible.
  1554.  
  1555.             Control-N                     Toggles line draw  mode.  The  line
  1556.                                           draw mode  indicator  is  displayed
  1557.                                           where  the  insert/overwrite   mode
  1558.                                           indicator is normally located.
  1559.  
  1560.             Control-O (ESC)               Activates the editing menu.
  1561.  
  1562.             Control-P (End)               Moves the cursor to the next column
  1563.                                           past the end of the current line.
  1564.  
  1565.             Control-Q                     Opens the  quote  window  if  quote
  1566.                                           text is  available.   If the  quote
  1567.                                           window  is  open,  Control-Q   will
  1568.                                           switch between  the message  window
  1569.                                           and the quote window.
  1570.  
  1571.             Control-R (PgUp)              Moves the cursor up one screen.
  1572.  
  1573.             Control-S (Left)              Moves the cursor one column to  the
  1574.                                           left.
  1575.  
  1576.             Control-T                     Deletes the  word to  the right  of
  1577.                                           the cursor,  possibly  causing  the
  1578.                                           paragraph to be reformatted.
  1579.  
  1580.             Control-U                     Inserts  deleted  lines  from   the
  1581.                                           scrap buffer into the message text.
  1582.  
  1583.             Control-V (Insert)            Toggles insert mode.
  1584.  
  1585.             Control-W (Home)              Moves the cursor  to the  beginning
  1586.                                           of the current line.
  1587.  
  1588.             Control-X (Down)              Moves the cursor one row down.
  1589.  
  1590.             Control-Y (Alt-D)             Deletes the  current  line  to  the
  1591.                                           scrap buffer.
  1592.  
  1593.             Control-Z (ESC, S)            Saves  the  message  and  exit  the
  1594.                                           editor.
  1595.  
  1596.                       (Control-Home)      Moves the cursor to the top row  of
  1597.                                           the editing window.
  1598.  
  1599.        ----------------------------------------------------------------------
  1600.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1601.  
  1602.  
  1603.        GEdit 2.01                   July 1, 1993                      Page 27
  1604.        ----------------------------------------------------------------------
  1605.  
  1606.                       (Control-End)       Deletes the text  from the  current
  1607.                                           cursor position to  the end of  the
  1608.                                           line.
  1609.  
  1610.                       (Control-PgUp)      Moves the cursor  to the  beginning
  1611.                                           of the message.
  1612.  
  1613.                       (Control-PgDn)      Moves the cursor to the end of  the
  1614.                                           message.
  1615.  
  1616.                       (Alt-X)             Activates the editing menu.
  1617.  
  1618.  
  1619.                                      Sysop Keys
  1620.  
  1621.        The following  keystrokes  allow  the Sysop  to  control  the  current
  1622.        editing session.  They are only  available to the Sysop when in  local
  1623.        mode.
  1624.  
  1625.                       (Alt-S)             Setup screen  colors.    A  box  is
  1626.                                           displayed that allows the Sysop  to
  1627.                                           configure   the   current    screen
  1628.                                           colors.  Normal execution continues
  1629.                                           while the  box displayed,  allowing
  1630.                                           colors to  be  configured  while  a
  1631.                                           user remains on-line.
  1632.  
  1633.                       (Alt-H)             Allows the Sysop to disconnect  the
  1634.                                           current user.  The user is  allowed
  1635.                                           to  continue   editing  until   the
  1636.                                           selection is made.  A  confirmation
  1637.                                           dialog is displayed.
  1638.  
  1639.                       (Alt-J)             Shells to  DOS.   The  editor  will
  1640.                                           attempt  to  swap  itself  out   of
  1641.                                           memory using XMS, EMS or disk.   If
  1642.                                           the swap  cannot be  performed,  an
  1643.                                           error message is displayed.
  1644.  
  1645.                       (Alt-U)             Toggles user  input.    The  remote
  1646.                                           keyboard can  be disabled  allowing
  1647.                                           local input only.
  1648.  
  1649.                       (Alt-A)             Displays  operational   information
  1650.                                           about GEdit, including the version,
  1651.                                           multitasker in use, BBS in use  and
  1652.                                           registration information.
  1653.  
  1654.                       (Alt-Minus)         Subtracts  one   minute  from   the
  1655.                                           user's time remaining.
  1656.  
  1657.                       (Alt-Equal)         Adds one minute to the user's  time
  1658.                                           remaining.
  1659.  
  1660.  
  1661.        ----------------------------------------------------------------------
  1662.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1663.  
  1664.  
  1665.        GEdit 2.01                   July 1, 1993                      Page 28
  1666.        ----------------------------------------------------------------------
  1667.  
  1668.                       (Alt-K)             Displays the  text associated  with
  1669.                                           the programmable function keys.
  1670.  
  1671.                       (Alt-M)             Invokes the  programmable  function
  1672.                                           key  editor  dialog.    Allows  the
  1673.                                           Sysop to  modify the  function  key
  1674.                                           macros.  For more information,  see
  1675.                                           the   programmable   function   key
  1676.                                           section.
  1677.  
  1678.                       (Shift-F1) through
  1679.                       (Shift-F10)         Select which  panel of  the  status
  1680.                                           bar should be displayed.  Note that
  1681.                                           displaying the status bar in  local
  1682.                                           mode  may   partially   cover   the
  1683.                                           editing window.
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.        ----------------------------------------------------------------------
  1724.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1725.  
  1726.  
  1727.        GEdit 2.01                   July 1, 1993                      Page 29
  1728.        ----------------------------------------------------------------------
  1729.  
  1730.  
  1731.                              Programmable Function Keys
  1732.  
  1733.        The function keys (F1 through F12)  can be programmed to transmit  key
  1734.        sequences to the editor.  The  function key strings are stored in  the
  1735.        same directory as GEDIT.EXE  and is available to  all nodes using  the
  1736.        same GEDIT.EXE file.
  1737.  
  1738.        The function keys are edited using  the function key editor, which  is
  1739.        displayed by  pressing Alt-M  while GEdit  is running.   A  dialog  is
  1740.        displayed containing  the twelve  function keys  and their  associated
  1741.        strings.
  1742.  
  1743.        When entering  function key  strings,  the following  characters  have
  1744.        special meaning.  They are translated to the indicated function.
  1745.  
  1746.             |    send the [Enter] key
  1747.  
  1748.             ~    Begin control sequence using the next character
  1749.  
  1750.                  ~    send a tilde (~) character
  1751.  
  1752.                  |    send a pipe (|) character
  1753.  
  1754.                  !    shell to DOS
  1755.  
  1756.                  B    send a tab character
  1757.  
  1758.                  >    send a cursor right
  1759.  
  1760.                  <    send a cursor left
  1761.  
  1762.                  ^    send a cursor up
  1763.  
  1764.                  V    send a cursor down
  1765.  
  1766.                  }    send a delete to end of line
  1767.  
  1768.                  S    save message and exit
  1769.  
  1770.                  #    save message and exit
  1771.  
  1772.                  U    insert _message from_ name
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.        ----------------------------------------------------------------------
  1786.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1787.  
  1788.  
  1789.        GEdit 2.01                   July 1, 1993                      Page 30
  1790.        ----------------------------------------------------------------------
  1791.  
  1792.  
  1793.                                      Appendix A
  1794.  
  1795.  
  1796.                  The QuickBBS-style MSGTMP External Editor Interface
  1797.  
  1798.        GEdit uses the QuickBBS-style MSGTMP interface to communicate with the
  1799.        BBS.  GEdit uses  a temporary text file  called MSGTMP (no  extension)
  1800.        which must be  located in  the current directory.   If  the caller  is
  1801.        replying to a message,  the BBS quotes the  original message text  for
  1802.        pasting into the reply and  writes it to the  MSGTMP file.  The  lines
  1803.        should be written to the temporary  text file separated by a  carriage
  1804.        return/line feed sequence.  All quote information and prefixes  should
  1805.        be added before writing to the file.
  1806.  
  1807.        Once the user has finished editing the message text, GEdit writes  the
  1808.        text to the same MSGTMP file, first erasing any existing file.   GEdit
  1809.        inserts soft carriage returns (ASCII 141)  in the file when the  lines
  1810.        are wrapped and hard  carriage returns (ASCII 13,  ASCII 10) when  the
  1811.        caller actually hits the [Enter] key.
  1812.  
  1813.        The BBS must  call GEdit with  several command line  parameters.   The
  1814.        required parameters are shown  below and must be  on the command  line
  1815.        exactly as shown.
  1816.  
  1817.                     GEDIT.EXE <port> <baud> <timeLeft> <inActive>
  1818.  
  1819.             <port>         the communications port number.   A value  of
  1820.                            "1" indicates COM1, "2" indicates COM2,  etc.
  1821.                            A value of "0" places GEdit in local mode.
  1822.  
  1823.             <baud>         the callers baud rate.  This is the  computer
  1824.                            to modem speed, not  the carrier line  speed.
  1825.                            If a baud rate of  "0" is passed, local  mode
  1826.                            operation is assumed.
  1827.  
  1828.             <timeLeft>     the number of minutes remaining for the  user
  1829.                            on this call.
  1830.  
  1831.             <inActive>     the number of seconds the user is allowed  to
  1832.                            stay idle  without  pressing  any  keystrokes
  1833.                            before the system will disconnect.
  1834.  
  1835.        When GEdit exits, an  error level will  be returned to  the BBS.   The
  1836.        following values are possible:
  1837.  
  1838.             0              Normal  exit,  the  edited  message  text  is
  1839.                            stored in MSGTMP and is ready to be  imported
  1840.                            into the message base by the BBS.
  1841.  
  1842.             1              Abnormal exit,  the user  either aborted  the
  1843.                            message or the saved message did not  contain
  1844.                            any text.  Either way, the message should not
  1845.                            be saved and the entry function should abort.
  1846.  
  1847.        ----------------------------------------------------------------------
  1848.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1849.  
  1850.  
  1851.        GEdit 2.01                   July 1, 1993                      Page 31
  1852.        ----------------------------------------------------------------------
  1853.  
  1854.             2              Abnormal exit,  the  user time  remaining  of
  1855.                            idle time-out period expired.  The BBS should
  1856.                            disconnect the user.
  1857.  
  1858.        If GEdit returns  to the BBS  with the carrier  signal low, it  should
  1859.        assume the  caller  was disconnected  and  discard the  message  text.
  1860.        GEdit should be  called directly; another  copy of COMMAND.COM  should
  1861.        NOT be loaded.  This is must faster and takes less memory.
  1862.  
  1863.        The BBS should only  allow users with either  ANSI or AVATAR  graphics
  1864.        capability to access GEdit.  GEdit uses VT-100, ANSI and AVATAR screen
  1865.        control codes to format all screen displays.
  1866.  
  1867.        GEdit will use  the FOSSIL driver  (revision 5) if  installed.  If  no
  1868.        FOSSIL driver is found, GEdit will attempt to open the port using it's
  1869.        own built-in serial routines.  If this fails, an error message will be
  1870.        displayed and GEdit will not load.
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.        ----------------------------------------------------------------------
  1910.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1911.  
  1912.  
  1913.        GEdit 2.01                   July 1, 1993                      Page 32
  1914.        ----------------------------------------------------------------------
  1915.  
  1916.  
  1917.                                      Appendix B
  1918.  
  1919.  
  1920.                               Troubleshooting Problems
  1921.  
  1922.        GEdit doesn't  seem to  be recognizing  what  type of  bulletin  board
  1923.        software I am using?
  1924.  
  1925.             Make sure that the correct BBS environment variable is set to the
  1926.             system path of the BBS.   If it is set,  make sure that no  other
  1927.             BBS environment variables are set that would indicate another BBS
  1928.             package  in  use.    If  you  require  multiple  BBS  environment
  1929.             variables, you must use the  GEDIT environment variable to  force
  1930.             GEdit to assume a specific software package.
  1931.  
  1932.        GEdit says that it is an  unregistered evaluation version, but I  have
  1933.        registered and received my key.
  1934.  
  1935.             Your registration key should be renamed to "GEDIT.KEY" and should
  1936.             be located in the same directory as the "GEDIT.EXE" program file.
  1937.             Make sure that  the executable you  are calling from  the BBS  is
  1938.             indeed the one that has the corresponding key file located in the
  1939.             same directory.
  1940.  
  1941.             GEdit key files are 606 bytes in length and can be displayed from
  1942.             the DOS prompt using the  TYPE command.  If  your key is not  606
  1943.             bytes, your key file has been corrupted.
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.        ----------------------------------------------------------------------
  1972.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  1973.  
  1974.  
  1975.        GEdit 2.01                   July 1, 1993                      Page 33
  1976.        ----------------------------------------------------------------------
  1977.  
  1978.  
  1979.                                      Appendix C
  1980.  
  1981.  
  1982.                           The DOS Application Class Library
  1983.  
  1984.        Over the  past nine  months  we have  developed  a class  library  for
  1985.        developing DOS-based C++ applications.   The library contains a  large
  1986.        collection of programming tools.
  1987.  
  1988.        The main library contains full  implementations of the common  utility
  1989.        classes including static and dynamic linked-lists, strings  (including
  1990.        Pascal string support), points, and rectangles.  Flexible input device
  1991.        support for keyboard, mouse and  joystick.  Keyboard messages  include
  1992.        key pressed, keystroke and key released.  A powerful interface to  the
  1993.        system timer, including countdown, countup, and interval timers.  Full
  1994.        background sound support, including compatibility with the BASIC  play
  1995.        command.
  1996.  
  1997.        The system event manager provides internal message-based  multitasking
  1998.        similar to  the  architecture of  Microsoft  Windows.   All  processes
  1999.        within an  application are  derived from  a base  instance class,  and
  2000.        processing time is passed from instance  to instance.  Performance  is
  2001.        extremely fast  and  application  flexibility  is  amazingly  easy  to
  2002.        harness in any project.
  2003.  
  2004.        The screen library contains support for monochrome and color  screens,
  2005.        including EGA  and VGA  displays.   Support for  non-standard  display
  2006.        modes, including 132 column  modes, is included.   The window  classes
  2007.        are derived  from the  instance class,  giving  each window  it's  own
  2008.        message handler.  Each  window on the screen  is managed by the  frame
  2009.        management functions.
  2010.  
  2011.        Once a window is created, it can be written to at any time, regardless
  2012.        of the windows z-order in the window list.  The windows on-screen size
  2013.        can differ  from  the actual  size  of the  associated  buffer,  being
  2014.        smaller or larger.  Buffer size  is limited by memory, window size  is
  2015.        limited by screen  size.  An  on-screen window frame  can be moved  or
  2016.        resized at any time, regardless of  the windows z-order.  Windows  can
  2017.        be borderless or bordered.   Window borders include captions,  scroll-
  2018.        bars, and resize controls.  The mouse  can be used to move and  resize
  2019.        any on-screen window.
  2020.  
  2021.        The windowing library also includes an extensible screen saver  class.
  2022.        This class allows you to create  custom screen saver modules that  can
  2023.        be  invoked  automatically  as  keyboard  and  mouse  activity  stops.
  2024.        Modules can be  created to  display progress  information or  whatever
  2025.        else is needed.   The application continues  to function unaware  that
  2026.        the screen saver has been displayed.  As  soon as the user hits a  key
  2027.        or moves the mouse, the original display is restored without requiring
  2028.        any application interruption.   A  few sample  modules, including  the
  2029.        infamous NetWare snake and a moving clock, are included to demonstrate
  2030.        using these classes.
  2031.  
  2032.  
  2033.        ----------------------------------------------------------------------
  2034.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  2035.  
  2036.  
  2037.        GEdit 2.01                   July 1, 1993                      Page 34
  2038.        ----------------------------------------------------------------------
  2039.  
  2040.        The user interface  library includes pull-down,  pop-up and  cascading
  2041.        menus.  Full mouse  support for the menus  is included, and menus  are
  2042.        independent window instances within the application architecture.   By
  2043.        using system-wide  accelerators,  hot-keys  can be  defined  for  menu
  2044.        options, eliminating  the  need  for  an  application  to  check  each
  2045.        keystroke for a function.
  2046.  
  2047.        Dialog boxes are also  part of the interface  library.  Many  controls
  2048.        are supported  in the  dialog manager,  including groups,  edit  boxes
  2049.        (including formatted fields), command  buttons, radio buttons,  check-
  2050.        boxes, list-boxes and combo-boxes.  The dialog manager is part of  the
  2051.        application architecture, and  takes advantage of  many of the  system
  2052.        features.  Convenient predefined dialogs such a message boxes are also
  2053.        included.
  2054.  
  2055.        The  communications  library   provides  access  to   many  types   of
  2056.        communication interfaces,  including  interrupt-driven  serial  ports,
  2057.        parallel ports,  a FOSSIL  interface, a  DigiBoard interface,  Network
  2058.        Product Corporation's NCSI serial interface,  and NetWare IPX/SPX.   A
  2059.        base session class  and derived classes  for each communication  types
  2060.        allows code to be  written to a single  class.  The  code can then  be
  2061.        used for any of the derived interface classes, eliminating the need to
  2062.        rewrite or modify code when different interfaces are supported.
  2063.  
  2064.        Internal support for decoding  ANSI and AVATAR/0+ emulation  sequences
  2065.        are  included   and  are   100%  compliant   with  the   corresponding
  2066.        specifications.   The  routines  are designed  to  use  the  windowing
  2067.        classes in the window  library, and all output  is optimized for  fast
  2068.        response.
  2069.  
  2070.        Protocol classes including Xmodem, Ymodem  and Zmodem, written to  use
  2071.        the base  session  class, are  included  giving the  application  easy
  2072.        access to internal transfer protocols.  Since all of these classes are
  2073.        written for  use  with  the application  class  library,  all  of  the
  2074.        internal multitasking  capabilities  are exploited,  allowing  maximum
  2075.        application flexibility.
  2076.  
  2077.        The database library  includes basic  file input  and output  services
  2078.        such as read and write.   Binary and text  files are supported.   File
  2079.        name and path name functions are  included to resolved path names  and
  2080.        verify valid file and path names.
  2081.  
  2082.        The record manager is  a B*Tree indexed  record manager allowing  both
  2083.        fixed and variable length records including full indices to be  stored
  2084.        in a single file.  The page-oriented system includes multi-user access
  2085.        and controlled  record and  file locking.   The  system is  reasonably
  2086.        small and very fast.  It uses several of the file and container  class
  2087.        functions from the remainder of the library, keeping code size small.
  2088.  
  2089.        The multimedia library includes  classes to control CD-Audio  devices,
  2090.        Adlib, SoundBlaster and ProAudioSpectrum sound  cards.  DMA wave  file
  2091.        playback and recording  functions, as well  as FM  music routines  are
  2092.        included.
  2093.  
  2094.  
  2095.        ----------------------------------------------------------------------
  2096.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  2097.  
  2098.  
  2099.        GEdit 2.01                   July 1, 1993                      Page 35
  2100.        ----------------------------------------------------------------------
  2101.  
  2102.        The network library  includes support for  NetWare LANs, and  provides
  2103.        access to  a subset  of the  NetWare API.   A  device instance  allows
  2104.        monitoring  of  network   messages  for   interception  and   display,
  2105.        eliminating the  annoying  "white  line message"  that  NetWare  often
  2106.        displays on the bottom line of the screen, locking up your application
  2107.        until the user presses a key.   The message is displayed in a  message
  2108.        box.
  2109.  
  2110.        The door interface library allows bulletin  board doors to be  written
  2111.        using  the  class  library,  giving  the  application  access  to  the
  2112.        information necessary to communicate with the user.  The door  library
  2113.        uses the  libraries  own  FOSSIL,  DigiBoard  or  direct  serial  port
  2114.        routines providing maximum flexibility and minimal code size.
  2115.  
  2116.        To  help  the  programmer  use  these   tools,  a  number  of   sample
  2117.        applications are included.  All include well commented source code and
  2118.        are easy to understand.
  2119.  
  2120.        Announcements will be made  once the library  approaches release.   If
  2121.        you  are  interested  in  more  information,  contact  The  Developers
  2122.        Network, Inc.
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.        ----------------------------------------------------------------------
  2158.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved
  2159.  
  2160.  
  2161.        GEdit 2.01                   July 1, 1993                      Page 36
  2162.        ----------------------------------------------------------------------
  2163.  
  2164.  
  2165.                                         Index
  2166.  
  2167.  
  2168.        BBS, 9
  2169.           EzyCom, 9, 10, 13
  2170.           ProBoard, 9, 14
  2171.           QuickBBS, 9, 14
  2172.           RemoteAccess, 9, 13
  2173.           SuperBBS, 9, 13
  2174.        BlueWave, 14
  2175.        colors, 20
  2176.        Command-Line, 15
  2177.        DORINFO1.DEF, 12
  2178.        editing window, 16, 20
  2179.        environment variable, 32
  2180.           EZY, 12, 13
  2181.           GEDIT, 12
  2182.           PROBOARD, 12, 13
  2183.           QUICK, 12, 13
  2184.           RA, 12, 13
  2185.           SBBS, 12, 13
  2186.        Function Keys, 29
  2187.        insert mode, 16
  2188.        line drawing mode, 16
  2189.        menu system, 21
  2190.        message subject, 16
  2191.        MSGTMP, 12, 30
  2192.        multitaskers, 11
  2193.           DESQview, 11
  2194.           Microsoft Windows, 11
  2195.           OS/2, 11
  2196.        Networks, 11
  2197.           Lantastic, 11
  2198.           Microsoft Windows for
  2199.           Workgroups, 11
  2200.           NetWare Lite, 11
  2201.           Novell NetWare 386, 11
  2202.        overwrite mode, 16
  2203.        quote, 17
  2204.        Registering, 7
  2205.           Benefits, 7
  2206.           credit card, 7
  2207.           Public (software) Library, 7
  2208.           Registration Form, 8
  2209.           Upgrade, 7
  2210.        Status Bar, 20
  2211.        Table of Contents, 3
  2212.        The Developers Network BBS, 6
  2213.        warning beep, 16
  2214.        windows, 19
  2215.           Dialog Boxes, 19
  2216.           Moving, 19
  2217.           Resizing, 19
  2218.  
  2219.        ----------------------------------------------------------------------
  2220.        COPYRIGHT 1992,93 The Developers Network, Inc.  All Rights Reserved