home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / PB_122.ZIP / EFL130.ZIP / EFL.DOC next >
Text File  |  1992-08-17  |  18KB  |  412 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                            ███████┐ ███████┐ ██┐
  22.                            ██┌────┘ ██┌────┘ ██│
  23.                            █████┐   █████┐   ██│
  24.                            ██┌──┘   ██┌──┘   ██│
  25.                            ███████┐ ██│      ██████┐
  26.                            └──────┘ └─┘      └─────┘
  27.  
  28.         ╥──╖     ╥                     ╥   ╥──╖ . ╓       ╥─   .      ╓
  29.         ╟─   ╖─╖ ╟─╖ ╓─┬ ╖─╖ ╓── ╓─╖ ╓─╢   ╟─   ╥ ║ ╓─╖   ║    ╥ ╓── ─╫─
  30.         ╨──╜ ╜ ╜ ╜ ╜ ╙─┴ ╜ ╜ ╙── ╙── ╙─╨   ╨    ╜ ╨ ╙──   ╨──╜ ╜ ──╜  ╨
  31.  
  32.                   ╥  ╥             .           ─╖    ╓──╖ ╓──╖
  33.                   ║ ╓╜ ╓─╖ ╖─╖ ╓── ╥ ╓─╖ ╖─╖    ║     ──╢ ╫  ╫
  34.                   ╙─╜  ╙── ╨   ──╜ ╜ ╙─╜ ╜ ╜   ─╨─ o ╙──╜ ╙──╜
  35.  
  36.               Copyright (c) 1992 Paul Tabara - All rights reserved
  37.  
  38.  
  39.         ╓──────────────────────────────────────────────────────────────╖
  40.         ║░░░░░░░░░░░░░░░░░░░ EFL 1.30 DOCUMENTATION ░░░░░░░░░░░░░░░░░░░║
  41.         ╙──────────────────────────────────────────────────────────────╜
  42.  
  43.         For ProBoard version 1.21 and above (c) 1990-2 Philippe Leybaert
  44.  
  45.                                   What is EFL?
  46.  
  47.         EFL is an Enhanced File List utility, and it offers ProBoard
  48.         users a way to list and tag files for download.
  49.  
  50.         ┌──────────────────────────────────────────────────────────────┐
  51.         │                    EFL 1.30 feature list                     │
  52.         └──────────────────────────────────────────────────────────────┘
  53.  
  54.         +  Support for ProBoard CD-ROM listing
  55.         +  Easy and fast file listing and tagging
  56.         +  Immediate download of tagged files
  57.         +  Complete tracking of tagged files across multiple areas
  58.         +  New file indicator, a flashing '*' near the comment line
  59.         +  Supports external file viewers
  60.         +  Saves tagged files on exit, and will load them upon re-entry
  61.         +  Easy scrolling through the file list - forward and back
  62.         +  Choose file area within EFL, move back and forth or pick from
  63.            list - no need to exit EFL to change file areas
  64.         +  Status bar on top keeps track of useful user information
  65.         +  Status bar on bottom keeps track of selected files
  66.         +  Support for European date format
  67.         +  Configurable color prompt, all 15 colors supported
  68.         +  Configurable word-wrap, toggle on or off - user can also
  69.            choose
  70.         +  Configurable coloring of the file list regions - name, date,
  71.            size, comments
  72.         +  Easy to use configuration utility - will import EFL 1.21 .CFG
  73.            file
  74.         +  Supports any ProBoard-defined batch protocol that uses
  75.            DSZCTL.TXT format, also supports non-batch protocols
  76.         +  Supports all security features of ProBoard.
  77.         +  Updates the appropriate areas of the user record with the
  78.            number and amount successfully downloaded
  79.         +  Proper log file entry into the ProBoard log for both
  80.            successful and unsuccessful downloads
  81.         +  Supports the hot-keys 's' for stop and 'p' for pause
  82.         +  Goodbye after download
  83.         +  and more!
  84.  
  85.         ┌──────────────────────────────────────────────────────────────┐
  86.         │                    EFL 1.30 Installation                     │
  87.         └──────────────────────────────────────────────────────────────┘
  88.  
  89.         The Enhanced File List PEX file provides ProBoard 1.21 and later
  90.         with the ability to easily list and tag files.  EFL was designed
  91.         to give the Sysop complete control over the color regions of the
  92.         file list, word-wrap, tag character, and more.
  93.  
  94.         A configuration utility (EFLCFG.EXE) is provided to setup EFL
  95.         very quickly.
  96.  
  97.         Follow these simple installation steps:
  98.  
  99.         1.  Place EFL130.PEX, EFLCFG.EXE, into your PEX directory.
  100.             If you have a registered version, place the EFL.KEY file
  101.             in here too.
  102.  
  103.         2.  Run EFLCFG and choose the color combination and options you
  104.             want.  If you are upgrading from EFL 1.21, you can import
  105.             the EFL.CFG file by selecting 'R'.
  106.  
  107.             Note:  if you have a monochrome monitor - the color schemes
  108.                    inside EFL130.INI are as follows:
  109.  
  110.             Black = 0, Blue = 1, Green = 2, Cyan = 3, Red = 4, Magenta = 5,
  111.             Brown = 6, White = 7 Gray = 8, Light Blue = 9, Light Green = 10,
  112.             Light Cyan = 11, Light Red = 12, Light Magenta = 13, Light
  113.             Yellow = 14, Bright White = 15
  114.  
  115.             Hit 'S' to save the EFL130.INI file.
  116.  
  117.         3.  Copy EFL130.INI into your STARTUP directory.
  118.             *** NOTE ***
  119.             With multi-line BBS's you will have to copy the file to their
  120.             respective startup directories - this allows you to have a
  121.             different setup for EFL on each node if you wish.
  122.  
  123.         4.  Place the EFL130.ANS file into your textfiles directory defined
  124.             in PROCFG.  This is the file that is read when users ask for
  125.             help by pressing [?].
  126.             You can modify this file with your favorite editor or THEDRAW
  127.             since it supports ANSI colors.  There is no limit to the length
  128.             of this file and EFL will prompt the user with More[Y,n].
  129.  
  130.         5.  Install a line in your file menu and use MENU 60 - run ProBoard
  131.             SDK file.
  132.  
  133.         6.  Put "EFL130" in the data field.
  134.  
  135.         Example:
  136.  
  137.              0        1         2
  138.              1234567890123456789012345...
  139.              <^F^>ile List via EFL
  140.                  Hotkey   : F
  141.  
  142.                  Function : 60 - Run ProBoard SDK File
  143.  
  144.                  Data     : EFL130
  145.  
  146.                  Level    : 1
  147.                  Flags    : --------------------------------
  148.  
  149.                  Color    : White on Black            Example Text
  150.  
  151.         7.  If you are using FrontDoor and have a high-speed modem, please
  152.             read the special FrontDoor note below.
  153.  
  154.                                    That's it!
  155.  
  156.       *******************************************************************
  157.       NEW!  EFLCFG supports two environment variables (EFLINI and EFLPEX)
  158.             placed in the AUTOEXEC.BAT file that will allow you to run
  159.             EFLCFG from anywhere providing:
  160.  
  161.             A.  EFLCFG.EXE is somewhere in your path.
  162.             B.  EFLINI is defined as your ProBoard SYSTEM directory:
  163.                 eg.  SET EFLINI=C:\PB
  164.             C.  EFLPEX is defined as your ProBoard PEX directory:
  165.                 eg.  SET EFLPEX=C:\PB\PEX
  166.  
  167.             Once this is setup, EFLCFG will read/write .INI, .CFG, and
  168.             .KEY files from the defined directories.
  169.       *******************************************************************
  170.  
  171.         ┌──────────────────────────────────────────────────────────────┐
  172.         │                        Using EFL 1.30                        │
  173.         └──────────────────────────────────────────────────────────────┘
  174.  
  175.                                   Take a look!
  176.                                   ~~~~~~~~~~~~
  177.         o  All of EFL's commands are available from the Tag menu.
  178.         o  The top line contains useful information and the bottom line
  179.            keeps track of tagged info.
  180.  
  181.         Here's what it looks like:
  182.  
  183.  EFL 1.30 │ Area: 100      │ Node: 1  │ Dn: 822   │ Up: 21    │ Time: 58  │ Top
  184.  --------   -----------      --------   ---------   -------     --------    ---
  185.  version    Area number      BBS Node   Downloads   Uploads     Time        Pg
  186.  number     CD=CD-ROM        number     to you      from you    Remaining    #
  187.             FREE or FR                  (in Kb)     (in Kb)     (minutes)
  188.  
  189.  A      .                                <*> flashes if New File!
  190.  B      .
  191.  C      .
  192.                                   file listing
  193.  T      .
  194.  U      .
  195.  V      .
  196.  
  197.  Help file    Some Commands Available     # files tagged   Amount     dl time
  198.  -------  ------------------------------  -------------- ----------  ---------
  199.  [?]Help│ Tag:A..V │ [/]Dload │ [$]Batch │ # Tagged: 3  │ Kb: 848   │ Time: 58
  200.                                     help bar
  201.  
  202.  
  203.         EFL allows you to very easily Tag or Untag any file on the screen.
  204.         Just press the appropriate letter that is listed along the left side
  205.         of the screen to Tag or Untag the file.  EFL will update the tag
  206.         information on the bottom bar, keeping track of tagcount, tagsize,
  207.         and download time.  After you have selected your files, you can go
  208.         into the batch menu [$] or directly into the download menu [/] to
  209.         quickly download your files.  EFL 1.30 also remembers your tags when
  210.         you leave it, and will give you the options of deleting or listing
  211.         them upon re-entry.
  212.  
  213.                         Access to all of EFL's Functions
  214.  
  215.          [?] - Display help file.
  216.          [/] - Enters the download menu.
  217.          [$] - Enters the batch menu.
  218.          [3] - Page down the file list, can also use the [Enter] key.
  219.          [9] - Page up the file list, can also use the [B]ack key.
  220.          [7] - Goes to the top of the file list.
  221.          [*] - Re-displays the whole screen.
  222.          [&] - Toggles Word-Wrap.
  223.          [Esc] - Escape takes you back to ProBoard.
  224.          [+, -, =] - Navigates through the file areas: forward, back, and
  225.                      pick from list.
  226.          [Enter] - Page down the file list.
  227.          [!] - Quick logoff.
  228.          [P] - Pauses display when listing.
  229.          [S] - Stops display when listing, gives user control of commands.
  230.  
  231.  
  232.                                    BATCH MENU
  233.                                    ~~~~~~~~~~
  234.         Selecting the [$] command takes you into the batch menu.
  235.  
  236.         [A] - Add a file, filename needs to be exact (for now).
  237.         [S] - Subtract a file:  EFL will prompt you for # to delete from
  238.               the list.
  239.         [C] - Clear all:  resets the tagged file counters to zero.  EFL
  240.               will ask the infamous "are you sure?" before clearing.
  241.         [V] - View a file, only available if the viewer is defined in the
  242.               EFL130.INI file.  The external file viewer needs to be
  243.               correctly installing before this function works.  Consult the
  244.               docs of the viewer of your choice.
  245.         [D] - Goto the download menu.
  246.         [Esc] - Go back to the file listing.
  247.  
  248.                                  DOWNLOAD MENU
  249.                                  ~~~~~~~~~~~~~
  250.         Selecting the [/] command takes you into the download menu.
  251.  
  252.         [Enter] - Checks for file accessability and then prompts you to
  253.                   make a protocol selection.
  254.  
  255.         [B] - Goto the batch menu.
  256.         [Esc] - Go back to the file listing.
  257.  
  258.         ┌──────────────────────────────────────────────────────────────┐
  259.         │           FrontDoor notes - high speed modems only           │
  260.         └──────────────────────────────────────────────────────────────┘
  261.  
  262.                                  Read CAREFULLY
  263.                                  ~~~~~~~~~~~~~~
  264.         In the FDSETUP, under Modem -> Messages:
  265.         change the 1200 line from "CONNECT 1200" to "CONNECT 1200/".
  266.  
  267.         Also make sure you add an errorlevel for 12000 in the FDSETUP,
  268.         under Misc -> Errorlevels.  Then in your bbs.bat file, add the
  269.         necessary support for responding to that errorlevel.
  270.  
  271.         This will allow FrontDoor to properly answer 12000 bps calls,
  272.         which otherwise come in at CONNECT 1200.  Of course, you will
  273.         need the proper modem (like a USR Dual Standard) in order for
  274.         users to connect at that bps rate.
  275.  
  276.         ┌──────────────────────────────────────────────────────────────┐
  277.         │                   EFL 1.30 Technical Notes                   │
  278.         └──────────────────────────────────────────────────────────────┘
  279.  
  280.         EFL and EFLCFG are written in C++ using Borland C++ 3.1.  EFL use
  281.         about 45K of memory, and supports 8086/286/386/486 computers.
  282.  
  283.                             File access information:
  284.                             ~~~~~~~~~~~~~~~~~~~~~~~~
  285.         Only two files are created by EFL, both are located in the
  286.         startup directory:
  287.  
  288.         + EFL130.TAG - a file used to save file tag info, it is only
  289.                        created upon exit of EFL and then read back
  290.                        when entering.
  291.  
  292.         + DSZCTL.TXT - needed by protocols, such as DSZ/GSZ, in order to
  293.                        process the "batch" request.  Note that this
  294.                        filename is configurable in PROCFG.  Each line
  295.                        lists the full path and filename to the file.
  296.  
  297.             The following external files are opened read-only by EFL
  298.             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  299.         + EFL.KEY - registration key file.
  300.  
  301.         + EFL130.INI - the configuration file for various colors and options.
  302.                        If it doesn't exist, default values will be used.
  303.  
  304.         + FILES.BBS - the file listing.
  305.  
  306.         + FREEFILE.CTL - a listing of files that can be downloaded "free", i.e.
  307.                          no update to the user record after download.
  308.  
  309.         + ONLINE.PRO - provides additional user information.
  310.  
  311.         + PROTOCOL.PRO - provides protocol information.
  312.  
  313.         + EFL130.ANS - Help file for EFL, placed in the textfiles dir.
  314.  
  315.               The following external files are appended to by EFL
  316.               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  317.         + PROBOARD.LOG - updates to the main log.
  318.  
  319.         ┌──────────────────────────────────────────────────────────────┐
  320.         │                    EFL 1.30 Registration                     │
  321.         └──────────────────────────────────────────────────────────────┘
  322.  
  323.         Many hours have been spent into the design and development of EFL.
  324.         If you are still using it after 30 days - you must register.
  325.  
  326.         Registering EFL provides you with the following benefits:
  327.  
  328.         +  Maximum number of tagged files increases from 5 to 30,
  329.            totally configurable.
  330.         +  "UNREGISTERED" sign replaced with your name and BBS name in
  331.            both EFL (on startup) and EFLCFG (main screen).
  332.         +  EFLCFG goes right into color selection, bypassing help screen.
  333.            Help is still available via [H].
  334.         +  Free minor and major releases up to but not including version 2.0.
  335.            You will be able to download the future releases of EFL off my BBS.
  336.  
  337.         Registration is easy, just fill out the EFL.REG file and a check
  338.         or money order (payable to Paul Tabara) in the amount of $10 US
  339.         dollars to:
  340.  
  341.         Paul Tabara
  342.         P.O. Box 361
  343.         Champlin, MN  55316
  344.         USA
  345.  
  346.         You will receive your personalized "KEY" file through Netmail or
  347.         it will be uploaded to your BBS if you don't have a FidoNet node
  348.         number.  If none of those options are possible, you will receive
  349.         a disk in the mail.
  350.  
  351.         Thank you for trying out EFL!  I know you and your users will
  352.         enjoy using it.
  353.  
  354.         ┌──────────────────────────────────────────────────────────────┐
  355.         │                     Notes of recognition                     │
  356.         └──────────────────────────────────────────────────────────────┘
  357.  
  358.         I would like to thank all the users that provided me with ideas,
  359.         encouragment, bug reports, Netmails, and registrations.  You
  360.         really made me continue to work and refine EFL into this release.
  361.  
  362.         Special thanks to the following guys that really made a difference:
  363.  
  364.                                    Jim Biggs
  365.                    [The O-Zone BBS (612-537-8659) | 1:282/30]
  366.                    ──────────────────────────────────────────
  367.         -  You provided the CD-ROM for testing, thanks Jim!
  368.         -  All of your early comments and ideas (much needed).
  369.         -  For a practical wish list.
  370.         -  Pre-alpha screening and testing...I just had to
  371.            show someone, guess who it was?  :)
  372.  
  373.                        Philippe Leybaert and Rutger Lasuy
  374.               [The Home of ProBoard (32-91-66-22-91) | 2:292/1905]
  375.               ────────────────────────────────────────────────────
  376.         -  EFL wouldn't be possible without you two.
  377.            Thanks for writing one terrific bulletin board!
  378.         -  For pointing out the small bugs...bugs?  What bugs?  :)
  379.         -  All of the oooo's and ahhhh's in Dutch.
  380.         -  For the thrill of a lifetime on Excalibur!
  381.  
  382.                                  Stan Hirschman
  383.                     [Odyssey BBS (612-832-5127) | 1:282/40]
  384.                     ───────────────────────────────────────
  385.         -  Thank you for all of your Netmails and great suggestions.
  386.  
  387.                                   Henk Van.Ess
  388.               [4.3.2.1 Ups & Downs (31-21-55-28-681) | 55:222/105]
  389.               ────────────────────────────────────────────────────
  390.         -  You really helped a lot with your uploaded reports
  391.            and quick response.
  392.  
  393.                                   Greg Shaffer
  394.                    [Route 66 BBS (706-769-0318) | 1:370/510]
  395.                                  Craig Peterson
  396.                    [Flightline BBS (612-544-5118) | 1:282/47]
  397.                    ──────────────────────────────────────────
  398.         -  Thanks for the comments in the echo and Netmails.
  399.  
  400.  
  401.        ──────────────────────────────────────────────────────────────────
  402.               For the latest shareware version, or if you have any
  403.                             questions/comments call:
  404.  
  405.                 ╔══════════════════════════════════════════════╗
  406.                 ║ Rivendell BBS - Home of ProBoard Support USA ║
  407.                 ║                (612-323-9473)                ║
  408.                 ║                   1:282/90                   ║
  409.                 ║        HST/V.32/V.32bis/V.42/V.42bis         ║
  410.                 ╚══════════════════════════════════════════════╝
  411.  
  412.