home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PCBOARD / PCFAE094.ZIP / FAE.DOC < prev    next >
Text File  |  1994-02-16  |  67KB  |  1,553 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                    The Ultimate File Area Management Utility
  10.  
  11.                            for PC-Board BBS Software
  12.  
  13.  
  14.                              ▄▄▄▄▄▄▄
  15.                             █████████
  16.                            ▐███▀   ▀
  17.                           ▐███▌     ▄▄▄▄▄▄      ▄▄▄▄▄▄
  18.                           ██████▄  ██▀ ▀███    ██▀ ▀███
  19.                          ▐█████▀  ▐███▄▄███▌  ▐███▄  ▀
  20.                          ████▌    ████▀▀████  ███▀  ▄▄
  21.                         ▐█████   ▐████▌▐████▌▐████▄████
  22.                          ▀▀▀▀     ▀▀▀▀  ▀▀▀▀  ▀▀▀▀▀▀▀▀ 
  23.  
  24.                                       0.94
  25.  
  26.                           Released February 16, 1994
  27.  
  28.                            Written by Steffan Surdek
  29.                          Suggestions by Marc Bouchard
  30.  
  31.  
  32.                              Technical Support BBS
  33.                                ~~~~~~~~~~~~~~~~
  34.                                The Tiger's Claw
  35.                                » 819-563-6054 «
  36.  
  37.                             Supra v.32bis Faxmodem
  38.                              2400 up to 14400 bps
  39.  
  40.  
  41.                This program is Copyright (C)1993 Steffan Surdek
  42.                Documentation is Copyright (C)1993 Steffan Surdek
  43.                    Portions Copyright Borland International
  44.                         Compiled Using Turbo Pascal 7.0
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.     
  53.                                Table of Contents
  54.                                ~~~~~~~~~~~~~~~~~
  55.  
  56.     Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . .  2
  57.  
  58.     Disclaimer. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  59.  
  60.     Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  61.  
  62.     Registration. . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  63.  
  64.     Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  65.        Using FAESET . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  66.        Default Text . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  67.           File Description. . . . . . . . . . . . . . . . . . . . . . .  7
  68.           Uploader Name . . . . . . . . . . . . . . . . . . . . . . . .  7
  69.        Default Options. . . . . . . . . . . . . . . . . . . . . . . . .  8
  70.           Min Offline . . . . . . . . . . . . . . . . . . . . . . . . .  8
  71.           Sort Method . . . . . . . . . . . . . . . . . . . . . . . . .  8
  72.           Mass Upload . . . . . . . . . . . . . . . . . . . . . . . . .  8
  73.           Offline Scan. . . . . . . . . . . . . . . . . . . . . . . . .  8
  74.           Archive Sort. . . . . . . . . . . . . . . . . . . . . . . . .  8
  75.           File Listing. . . . . . . . . . . . . . . . . . . . . . . . .  8
  76.           Use FILE_ID . . . . . . . . . . . . . . . . . . . . . . . . .  9
  77.           Sort Comments . . . . . . . . . . . . . . . . . . . . . . . .  9
  78.           Scan Trash. . . . . . . . . . . . . . . . . . . . . . . . . .  9
  79.           Save Changes. . . . . . . . . . . . . . . . . . . . . . . . .  9
  80.        External Programs. . . . . . . . . . . . . . . . . . . . . . . .  9
  81.           Text Viewer . . . . . . . . . . . . . . . . . . . . . . . . .  9
  82.           Extract Dir . . . . . . . . . . . . . . . . . . . . . . . . .  9
  83.           Trash File. . . . . . . . . . . . . . . . . . . . . . . . . . 10
  84.        Color Configuration. . . . . . . . . . . . . . . . . . . . . . . 10
  85.        Master File Listing. . . . . . . . . . . . . . . . . . . . . . . 10
  86.           List Name . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  87.           List Confer.. . . . . . . . . . . . . . . . . . . . . . . . . 10
  88.           Empty Text. . . . . . . . . . . . . . . . . . . . . . . . . . 10
  89.           Area Stats. . . . . . . . . . . . . . . . . . . . . . . . . . 10
  90.           Confer. Stats . . . . . . . . . . . . . . . . . . . . . . . . 11
  91.           Total Stats . . . . . . . . . . . . . . . . . . . . . . . . . 11
  92.        Using the FAE.INI file . . . . . . . . . . . . . . . . . . . . . 11
  93.           [DefaultDisplay]. . . . . . . . . . . . . . . . . . . . . . . 11
  94.           [LoadConferences] . . . . . . . . . . . . . . . . . . . . . . 11
  95.           [UpdateExitSize]. . . . . . . . . . . . . . . . . . . . . . . 11
  96.           [AutoSaveChanges] . . . . . . . . . . . . . . . . . . . . . . 11
  97.           [DescriptionFile] . . . . . . . . . . . . . . . . . . . . . . 11
  98.           [AutoKillDir] . . . . . . . . . . . . . . . . . . . . . . . . 12
  99.           [MakeDIRBackup] . . . . . . . . . . . . . . . . . . . . . . . 12
  100.           [BackupDirectory] . . . . . . . . . . . . . . . . . . . . . . 12
  101.           [UseDLPaths]. . . . . . . . . . . . . . . . . . . . . . . . . 12
  102.           [Extensions]. . . . . . . . . . . . . . . . . . . . . . . . . 12
  103.           [NoUploads] . . . . . . . . . . . . . . . . . . . . . . . . . 12
  104.  
  105.     Command Line Parameters . . . . . . . . . . . . . . . . . . . . . . 13
  106.  
  107.  
  108.  
  109.  
  110.  
  111.     
  112.     Conference Selection Menu . . . . . . . . . . . . . . . . . . . . . 14
  113.        F2: Add New Files. . . . . . . . . . . . . . . . . . . . . . . . 14
  114.        F3: Sort All Areas . . . . . . . . . . . . . . . . . . . . . . . 14
  115.        F4: Remove Offline Files . . . . . . . . . . . . . . . . . . . . 14
  116.        F5: Create file list . . . . . . . . . . . . . . . . . . . . . . 14
  117.        T : Tag Conference . . . . . . . . . . . . . . . . . . . . . . . 14
  118.        U : Untag Conference . . . . . . . . . . . . . . . . . . . . . . 14
  119.        ALT+J: Jump to DOS . . . . . . . . . . . . . . . . . . . . . . . 14
  120.  
  121.     File Area Selection . . . . . . . . . . . . . . . . . . . . . . . . 15
  122.        D : Delete File Area . . . . . . . . . . . . . . . . . . . . . . 15
  123.        E : Edit File Area Stats . . . . . . . . . . . . . . . . . . . . 15
  124.        N : Create New File Area . . . . . . . . . . . . . . . . . . . . 15
  125.        O : Reorder File Areas . . . . . . . . . . . . . . . . . . . . . 15
  126.        P : Private Uploads Area . . . . . . . . . . . . . . . . . . . . 15
  127.        ALT+J: Jump to DOS . . . . . . . . . . . . . . . . . . . . . . . 15
  128.        Special notes about this section . . . . . . . . . . . . . . . . 15
  129.  
  130.     Files Management Menu . . . . . . . . . . . . . . . . . . . . . . . 16
  131.        F2: Add New Files. . . . . . . . . . . . . . . . . . . . . . . . 16
  132.       ^F2: Add Selected Files . . . . . . . . . . . . . . . . . . . . . 16
  133.        F3: Sort All Files . . . . . . . . . . . . . . . . . . . . . . . 16
  134.        F4: Remove Offline Files . . . . . . . . . . . . . . . . . . . . 16
  135.       ^F4: Remove old files . . . . . . . . . . . . . . . . . . . . . . 17
  136.        F5: Search for text. . . . . . . . . . . . . . . . . . . . . . . 17
  137.        F6: Search for next. . . . . . . . . . . . . . . . . . . . . . . 17
  138.        F7: Batch Menu . . . . . . . . . . . . . . . . . . . . . . . . . 17
  139.              Description. . . . . . . . . . . . . . . . . . . . . . . . 17
  140.              Uploaded by. . . . . . . . . . . . . . . . . . . . . . . . 17
  141.              File Ext.. . . . . . . . . . . . . . . . . . . . . . . . . 17
  142.              Touch File Size. . . . . . . . . . . . . . . . . . . . . . 18
  143.        F8: Toggle Size/Date . . . . . . . . . . . . . . . . . . . . . . 18
  144.       RET: Edit file description. . . . . . . . . . . . . . . . . . . . 18
  145.        A : Add Blank Comment Line . . . . . . . . . . . . . . . . . . . 19
  146.        C : Copy Files . . . . . . . . . . . . . . . . . . . . . . . . . 19
  147.        D : Delete File. . . . . . . . . . . . . . . . . . . . . . . . . 19
  148.        G : Get FILE_ID.DIZ. . . . . . . . . . . . . . . . . . . . . . . 19
  149.        M : Move Files . . . . . . . . . . . . . . . . . . . . . . . . . 19
  150.        N : Move file to another conference. . . . . . . . . . . . . . . 19
  151.        O : Move Files Offline . . . . . . . . . . . . . . . . . . . . . 19
  152.        P : Purify Archive . . . . . . . . . . . . . . . . . . . . . . . 19
  153.        R : Rename file. . . . . . . . . . . . . . . . . . . . . . . . . 19
  154.        S : Save FILE_ID.DIZ . . . . . . . . . . . . . . . . . . . . . . 20
  155.        T : Tag File . . . . . . . . . . . . . . . . . . . . . . . . . . 20
  156.        U : Untag File . . . . . . . . . . . . . . . . . . . . . . . . . 20
  157.        V : View Archive/File. . . . . . . . . . . . . . . . . . . . . . 20
  158.        ALT+J: Jump to DOS . . . . . . . . . . . . . . . . . . . . . . . 20
  159.        ALT+S: Display free space. . . . . . . . . . . . . . . . . . . . 20
  160.        Special Notes about this section.... . . . . . . . . . . . . . . 20
  161.  
  162.     
  163.  
  164.     Archive Manager . . . . . . . . . . . . . . . . . . . . . . . . . . 21
  165.       RET: View File. . . . . . . . . . . . . . . . . . . . . . . . . . 21
  166.        A : Archive Statistics . . . . . . . . . . . . . . . . . . . . . 21
  167.        C : Clean Archive. . . . . . . . . . . . . . . . . . . . . . . . 21
  168.        D : Delete File. . . . . . . . . . . . . . . . . . . . . . . . . 21
  169.        E : Extract a file . . . . . . . . . . . . . . . . . . . . . . . 21
  170.        G : Archive Password . . . . . . . . . . . . . . . . . . . . . . 21
  171.        I : Test file integrity. . . . . . . . . . . . . . . . . . . . . 21
  172.        P : Change Extract Path. . . . . . . . . . . . . . . . . . . . . 21
  173.        S : Sort Files . . . . . . . . . . . . . . . . . . . . . . . . . 22
  174.        T : Tag File . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  175.        U : Untag File . . . . . . . . . . . . . . . . . . . . . . . . . 22
  176.        ALT+J: Jump to DOS . . . . . . . . . . . . . . . . . . . . . . . 22
  177.        Special notes about this section.... . . . . . . . . . . . . . . 22
  178.  
  179.     Suggestions When Using FAE. . . . . . . . . . . . . . . . . . . . . 23
  180.  
  181.     Editing Commands. . . . . . . . . . . . . . . . . . . . . . . . . . 24
  182.  
  183.     Known Bugs/Problems . . . . . . . . . . . . . . . . . . . . . . . . 24
  184.  
  185.     Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . 25
  186.  
  187.     System Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
  188.  
  189.     Other Products from us. . . . . . . . . . . . . . . . . . . . . . . 26
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.   -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 4 ]=-=-=-
  222.  
  223.                                   Disclaimer
  224.                                   ~~~~~~~~~~
  225.          Users of FAE must accept this disclaimer of warranty:
  226.  
  227.          "FAE is supplied as is.  The author disclaims all warranties, 
  228.          expressed or implied, including, without limitation, the
  229.          warranties of merchantability and of fitness for any purpose.
  230.          The author assumes no liability for damages, direct or
  231.          consequential, which may result from the use of FAE. "
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.   -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 5 ]=-=-=-
  270.  
  271.                                  Introduction
  272.                                  ~~~~~~~~~~~~
  273.          Did you ever wish for a user friendly and powerful File Area Editor
  274.     for your PC-Board BBS?  One that would provide an easy way to add new
  275.     files, edit descriptions, do the general maintenance of your file
  276.     conferences?  Well, here it is!
  277.  
  278.         It has a multitude of options, some of which are:
  279.  
  280.             * Tag files to work on
  281.             * Move files through file areas/conferences
  282.             * Copy files
  283.             * Edit Descriptions
  284.             * Batch Descriptions with Auto Numbering capability
  285.             * Reorder File Areas
  286.             * Manipulate ARJ/LZH/SQZ/ZIP Archives
  287.             * View PCX/BMP/TIF/GIF/LBM graphic files
  288.             * Creation of new file areas
  289.             * Support for importing/exporting FILE_ID.DIZ description file
  290.             * Remove old or offline files
  291.             * Create Master file listings with configurable statistics.
  292.             * 5 Different sorting methods!
  293.             * Easy creation of new file areas
  294.             * Extremely configurable!
  295.  
  296.          This program has all the options YOU need to maintain your file
  297.     areas, and then some!  Do you need to remove those bbs ads from an
  298.     archive?  FAE can do it!  Do you want to delete a file and remove the
  299.     credit from the person who sent it?  This program does that too!  If you
  300.     can't find a special function you want, simply tell the author and he
  301.     will add it in a future version.
  302.  
  303.          FAE supports PC-Board 14.5 and 15.0 systems.  It recognizes the
  304.     different sizes of the PCBFILER.DEF file from these two versions, and
  305.     saves it using the appropriate size.
  306.  
  307.          The history file (HISTORY.DOC) contains all changes made (new
  308.     features, bug fixes, etc.) since the last version.
  309.  
  310.          You can divide the program in three parts: the Conference
  311.     Selection, the File Area Selection, and the Files Management section. 
  312.     Press F1 from anywhere to get on-line help.
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.   -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 6 ]=-=-=-
  329.  
  330.                                  Registration
  331.                                  ~~~~~~~~~~~~
  332.          Since this program will be VERY useful to PC-Board Sysops, I
  333.     require a registration fee of 40$ US (40$ Canadian), and 5$ for
  334.     shipping. If you own a modem, you can get your registered version on the
  335.     support BBS once I receive the registration fee (thus saving the 5$
  336.     shipping cost).
  337.  
  338.          The registered version has some additional features, for example:
  339.  
  340.        * the Archive Manager allows you to view/delete/extract files.
  341.  
  342.        * you can have a selection window when mass uploading files.  With
  343.          this  window, you can tag files to put on-line, view contents (with
  344.          archive manager if it is a compressed file) . . . 
  345.  
  346.        * the ability to select a default sorting method for when you use F3
  347.          in the file selection menu and in the conference selection menu.
  348.  
  349.        * the ability to sort files 5 different ways.  You can sort by
  350.          filename, extension, description, date or by size.
  351.  
  352.        * Anything else that I add in future versions.
  353.  
  354.          Registration gives you those features plus a year of updates free.
  355.     When that year expires, additional updates are 5$ US / Year (8$
  356.     Canadian) If you wish to register this software, send a MONEY ORDER only
  357.     to:
  358.  
  359.                                     Steffan Surdek
  360.                                     1104, Duplessis #7
  361.                                     Sherbrooke, Qc
  362.                                     Canada, J1K 2G6
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.   -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 7 ]=-=-=-
  375.  
  376.                                  Installation
  377.                                  ~~~~~~~~~~~~
  378.          FAE is very easy to install.  When performing the installation you
  379.     have two choices, either create a directory for FAE, or copy it directly
  380.     in your PC-Board directory.
  381.  
  382.          When installing FAE in it's own directory, you must indicate to DOS
  383.     where to find the program by modifying your DOS path.  This is necessary
  384.     because at run-time, FAE must be able to find some files (FAE.HLP,
  385.     FAE.DAT, and sometimes FAESET.EXE).  
  386.  
  387.          After copying the program files to a directory, the next thing you
  388.     need to do is run the FAESET program to configure FAE for your needs. 
  389.     Help is available from anywhere in FAESET by pressing the F1 key.
  390.  
  391.     Using FAESET
  392.     ~~~~~~~~~~~~
  393.          FAESET was written specifically to configure the FAE to meet the
  394.     needs of its users.  It would have been fairly easy to hard code
  395.     everything, but this program will give you a bit more flexibility when
  396.     you are using FAE.  You can call FAESET from any of the main sections of
  397.     the program by pressing the F9 key.  
  398.  
  399.          To move through the program, use the cursor keys to highlight the
  400.     command that you want and press ENTER to edit/access that line/block. 
  401.     Also, hitting ESCape when editing a line will restore its previous
  402.     contents.  Pressing ESC while moving through a block will return you to
  403.     the previous menu.  Now, let's go through the 3 blocks of this program.
  404.  
  405.     Default Text
  406.     ~~~~~~~~~~~~
  407.          FAE allows you to configure some text strings that it uses.  Thus,
  408.     you have this section to allow you to choose what you want the FAE to
  409.     write in certain cases.
  410.  
  411.          File Description: Default file description when mass uploading.
  412.          ────────────────  When using the "Use FILE_ID" option, FAE uses
  413.          this description only if no FILE_ID.DIZ is found.
  414.  
  415.                    FAE Default: "No Description Given"
  416.  
  417.          Uploader Name: When mass uploading files, FAE will append the name
  418.          ─────────────  entered here to the description of the file using an
  419.          "Uploaded by: " line.  Leave this field blank and FAE will not add
  420.          any uploader information to the description.
  421.  
  422.                    FAE Default: <<BLANK>>
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.   -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 8 ]=-=-=-
  433.  
  434.     Default Options
  435.     ~~~~~~~~~~~~~~~
  436.          When designing FAE, I decided to make the program as versatile as
  437.     possible, because sysops do have preferences.  In this section, you have
  438.     a multitude of things that you can configure, here they are:
  439.  
  440.          Min Offline: Specify the minimum percentage of files offline in an
  441.          ───────────  area for it to be considered an offline file area. 
  442.          It's used with the "Offline Scan" toggle, when using the "remove
  443.          offline" command.  Please see "Offline Scan" for more details.
  444.  
  445.                    FAE Default: 0% (inactive)
  446.          
  447.          Sort Method: When you sort file areas using F3, FAE will 
  448.          ───────────  automatically use this sorting method.  Available
  449.          sorting methods are: by filename, extension, description, date
  450.          sent, file size in ascending or descending fashion.
  451.          
  452.                    FAE Default: by filename (Asc).
  453.  
  454.          Mass Upload: Default method for mass uploads.  This option is valid
  455.          ───────────  when entering an empty file area, when FAE asks if it
  456.          should search for new files.  If you answer yes, it uses the method
  457.          that you select here.
  458.  
  459.               All Files   -  Uploads all files that are on disk but not
  460.                              on-line.
  461.               Select Files-  Lets you see the files you can upload and
  462.                              select the ones that you want on-line.
  463.  
  464.                    FAE Default: Select Files
  465.  
  466.          Offline Scan: This option says if the FAE should scan the current
  467.          ────────────  area to figure out if it is an offline file area. 
  468.          Using the value specified in "Min Offline", when a possible offline
  469.          file area is found, you are prompted wether or not you wish to
  470.          continue with the procedure.
  471.  
  472.                    FAE Default: Don't Scan Area
  473.  
  474.          Archive Sort: FAE uses this field when loading files in the 
  475.          ────────────  archive manager.  Available sorting methods are: by
  476.          filename, extension, path (if there are any), and finally, unsorted
  477.          (in the order the files were originally in the archive).
  478.  
  479.                    FAE Default: Unsorted
  480.  
  481.          File Listing: This option is active, when the FAE displays the list
  482.          ────────────  in the file selection menu, it checks if the file
  483.          exists and if it doesn't, instead of displaying the size, it writes
  484.          "-Off-".
  485.  
  486.                    FAE Default: Mark Offline Files
  487.  
  488.  
  489.  
  490.  
  491.   -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 9 ]=-=-=-
  492.  
  493.     Default Options (Continued...)
  494.  
  495.          Use FILE_ID: With this toggle on, when mass uploading files, FAE
  496.          ───────────  will check if a "FILE_ID.DIZ" file is present in the
  497.          current archive.  If it finds one, it extracts the file and puts it
  498.          as the file description.
  499.  
  500.                    FAE Default: Ignore FILE_ID.DIZ
  501.  
  502.          Sort Comments: If you have comment lines in a file area, use this
  503.          ─────────────  option!  When using it, FAE will ignore comment
  504.          lines when sorting, it will sort around them automatically.  When
  505.          not using this option, FAE sorts the entire file list, EVEN comment
  506.          lines (same as PCBFILER).
  507.  
  508.                    FAE Default: Around comment lines
  509.  
  510.          Scan Trash: With this toggle, when deleting a file in an archive,
  511.          ──────────  you have the choice of putting that filename in the
  512.          trashcan file.  This option will scan to see if it is already
  513.          present in the trashcan.
  514.  
  515.                    FAE Default: Scan Trash File
  516.  
  517.          Save Changes: This toggle tells FAE wether prompt you before saving 
  518.          ────────────  changes made to a file area, or to save all changes
  519.          automatically.  Use this option with caution, it's better have FAE
  520.          prompt you before taking action.
  521.  
  522.                    FAE Default: Confirm Save
  523.  
  524.     External Programs
  525.     ~~~~~~~~~~~~~~~~~
  526.          FAE sometimes needs other programs to function adequately and you
  527.     can configure some of them here.  You cannot configure the names of the
  528.     archive programs (i.e., PKZIP, ARJ, etc.) for obvious reasons.
  529.  
  530.          Text Viewer: This is for the complete path to your favorite text
  531.     ───────────  viewer.  Remember, you need a text VIEWER, not an
  532.     EDITOR, mainly because if you make changes to the file, FAE does
  533.     not update the archive.
  534.  
  535.                    FAE Default: "LIST.COM" (if found in path) or <<BLANK>>
  536.  
  537.          Extract Dir: This is the default extraction directory for the
  538.          ───────────  Archive Manager.  You can also change it by hitting
  539.          'P' in the archive submenu.  By default, this field is blank, so
  540.          FAE will extract the files in the current directory (unless you
  541.          change it once in the archive manager).
  542.  
  543.                    FAE Default: <<BLANK>>
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 10 ]=-=-=-
  551.  
  552.     External Programs (Continued...)
  553.  
  554.          Trash File : You can use this field to specify the path and name of 
  555.          ──────────   the BBS ads file.  This file contains the names of 
  556.          miscellaneous files that are sometimes added to promote a BBS.  If
  557.          you already have a similar file for your BBS, then all you have to
  558.          do is specify the complete path and name of it.
  559.  
  560.                    FAE Default: "BBSADS.TXT"
  561.  
  562.     Color Configuration
  563.     ~~~~~~~~~~~~~~~~~~~
  564.          FAESET also allows you to change the colors of the DIR files, in
  565.     the same style as PCBFILER.  To use this option, the file PCBFILER.DEF
  566.     must be in your DOS path.  If it is not, then the program will not allow
  567.     you to make any modifications.
  568.  
  569.          To change the colors, all you have to do, is move to the block of
  570.     text you want to change by using the cursor keys.  Then, use SHIFT+LEFT
  571.     or SHIFT+RIGHT to change the background color.  To modify the
  572.     foreground, use SHIFT+UP or SHIFT+DOWN.  Finally, use ESCAPE when you
  573.     are finished setting up the colors.
  574.  
  575.     Master File Listing
  576.     ~~~~~~~~~~~~~~~~~~~
  577.          FAE can create a master file list by pressing F5 at the conference
  578.     menu, or by adding "/LIST" as command line parameter.  This section of
  579.     FAESET allows you to configure some of the things that are in the file
  580.     listings.
  581.  
  582.          List Name: Allows you to select the name of the file that will
  583.          ─────────  contain the master file list.
  584.  
  585.                    FAE Default: "PCBFILES.LST"
  586.  
  587.          List Confer.: You can use this option to choose which conferences
  588.          ────────────  FAE should include in the list.  Leaving this field
  589.          blank tells the program that you want to include ALL conferences. 
  590.          To specify the conferences to process, you can use different
  591.          methods.  For example, "0-2,4" would use conferences 0 to 2 as well
  592.          as conference 4.
  593.  
  594.                    FAE Default: "0"  (Include only the Main Conference)
  595.  
  596.          Empty Text: When FAE creates the master file list, it might 
  597.          ──────────  sometimes encounter an empty area.  Here, you can
  598.          configure the text FAE writes in these cases.  
  599.  
  600.                    FAE Default: "No files in this area!"
  601.  
  602.          Area Stats: This toggle tells FAE wether or not to include the
  603.          ──────────  statistics for every area processed.
  604.  
  605.                    FAE Default: No
  606.  
  607.  
  608.  
  609.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 11 ]=-=-=-
  610.     Master File Listing (Continued...)
  611.  
  612.          Confer. Stats: This toggle is used to determine if the statistics
  613.          ─────────────  for every conference should be put in the file list.
  614.  
  615.                    FAE Default: Yes
  616.  
  617.          Total Stats: You can set this toggle on if you want the statistics
  618.          ───────────  for ALL file areas displayed at the end of the
  619.          listing.
  620.  
  621.                    FAE Default: Yes
  622.  
  623.     Using the FAE.INI file
  624.     ~~~~~~~~~~~~~~~~~~~~~~
  625.          For even more configurability, FAE allows you to configure it's use
  626.     through the FAE.INI file.  This is a straight ASCII text file containing
  627.     instructions for the program.  The following commands are available:
  628.  
  629.          [DefaultDisplay]: This instruction allows you to select the display 
  630.          ────────────────  that FAE will use when you enter a file area. 
  631.          Setting this to 1 makes the program display the list with the file
  632.          size.  Using the value 2 will make FAE display the list with the
  633.          file dates.
  634.  
  635.                    Example: [DefaultDisplay] = 1
  636.  
  637.          [LoadConferences]: This parameter allows you to specify which     
  638.          ─────────────────  conferences FAE should load in the conference
  639.          selection menu.  The best use for this feature is when you have a
  640.          lot of conferences that have the exact same file areas as the "Main
  641.          Board".  To specify the list of conferences, use the same method of
  642.          entry as usual (ie: 0,2-4 will load 0, 2, 3 and 4) you are limited
  643.          to a maximum length of 80 characters.
  644.  
  645.                    Example: [LoadConferences] = 0,10-15,20,23
  646.  
  647.          [UpdateExitSize]: This toggle will tell FAE if it should          
  648.          ────────────────  automatically update the size of all files when
  649.          saving a file area.  This flag will also provide a means to put
  650.          files back on-line if they were either 'OFF-LINE' or 'DELETED'. 
  651.  
  652.                    Example: [UpdateExitSize] = Yes
  653.  
  654.          [DescriptionFile] allows you to specify the name of the description
  655.          ───────────────── file FAE will create when using the "Save
  656.          Description File" command.  The default is FILE_ID.DIZ, but if you
  657.          prefer, you can create a DESC.SDI or anything else.  The name must
  658.          not exceed 12 characters...
  659.  
  660.                    Example: [DescriptionFile] = FILE_ID.DIZ
  661.  
  662.          [AutoKillDir] makes FAE remove its temporary directory #FAE# if it 
  663.          ───────────── finds one instead of prompting you.  With this option
  664.          on, you don't have to use the /KILLDIR parameter.
  665.  
  666.                    Example: [AutoKillDir] = Yes
  667.  
  668.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 12 ]=-=-=-
  669.  
  670.          [MakeDIRBackup] will force FAE to create a backup of a DIR file   
  671.          ─────────────── before it loads it in.  FAE doesn't allow you to
  672.          overwrite a backup file without your authorisation.
  673.  
  674.                    Example: [MakeDIRBackup] = No
  675.  
  676.          [BackupDirectory] Allows you to tell FAE where to create a backup 
  677.          ───────────────── of your DIR files.  If this path does not exist,
  678.          FAE will create it automatically.  The option to make backups
  679.          automatically is only available in the registered version.
  680.  
  681.                    Example: [BackupDirectory] = D:\PCBOARD\FILES\BACKUP\
  682.  
  683.          [UseDLPaths] tells FAE to search all the download paths to        
  684.          ──────────── determine if a file is on-line or not.  This option is
  685.          especially useful if you run a large BBS with areas that are spread
  686.          out through multiple directories. If an area uses only the attached
  687.          directory, you can leave this toggle to "No".
  688.  
  689.                    Example: [UseDLPaths] = No
  690.  
  691.          [AutoIndex] tells FAE to automatically update the IDX file if     
  692.          ─────────── changes were made to a file area.  This can be used in
  693.          the registered version only.
  694.  
  695.                    Example: [AutoIndex] = Yes
  696.  
  697.          [Extensions]: This parameter is multi-line.  Meaning that when you 
  698.          ────────────  must write [EndExtensions] to mark the end of the
  699.          instructions.  Using this command tells FAE which external programs
  700.          to execute when it encounters a certain file extension when you use
  701.          the view command.  You must have a period at the beginning of the
  702.          extension of FAE will ignore the line.  It is also possible to pass
  703.          the following parameters to the program FAE executes:
  704.  
  705.               %1 = Complete name and path of highlited file
  706.               %2 = Only the file name of current file (no path)
  707.  
  708.          In the following example:
  709.  
  710.               [Extensions]
  711.               .MOD = C:\MODS\MP %1
  712.               [EndExtensions]
  713.  
  714.          You are telling FAE to shell to the program C:\MODS\MP when it
  715.          encounters the .MOD file extension.
  716.  
  717.          [NoUploads]: This option is used when mass uploading new files.  It 
  718.          ───────────  allows you to tell FAE which files you want it to
  719.          ignore.  You can use wildcards (?,*) in the specified filenames. 
  720.          To mark the end of your list, you must use [EndNoUploads].
  721.  
  722.                    Example:
  723.                            [NoUploads]
  724.                            *.BAK
  725.                            [EndNoUploads]
  726.  
  727.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 12 ]=-=-=-
  728.  
  729.                             Command Line Parameters
  730.                             ~~~~~~~~~~~~~~~~~~~~~~~
  731.          FAE also has support for some command line switches.  The program
  732.     processes these commands in sequence (meaning you can specify more than
  733.     one) and exits when it's completes the job.
  734.  
  735.          To specify the file conferences to process, use the same method as
  736.     in FAESET when you indicate the conferences to include in the master
  737.     file list. 
  738.  
  739.               Example: FAE /NEW:0,3,5-7     -->  This command will upload
  740.                                                  new files in conferences
  741.                                                  0,3 and 5 to 7.
  742.                    
  743.     The available commands are preceded by a slash (/) and when you need to
  744.     specify conferences to process, they are ended by a colon (:).
  745.  
  746.          ?    :    Display help screen.  It shows you all available
  747.                    commands.
  748.  
  749.          LIST : Generate master file list.   You don't need to specify any 
  750.          ────   conferences to process.  FAE will automatically use the list
  751.          you specified in FAESET.
  752.  
  753.          NEW  : Mass upload new files.  FAE processes all the file areas
  754.          ────   in the conferences that you specify on the command line.
  755.  
  756.                    Example: FAE /NEW:0  --> Upload new files in the "Main
  757.                                             Board" conference.
  758.  
  759.          SORT : Sort file areas in the specified conferences.  For now, it 
  760.          ────   sorts by file name, but FAE will be able to use the default
  761.          sorting method for each area.
  762.  
  763.                    Example: FAE /SORT:0,2 -> Sorts conferences 0 and 2.
  764.  
  765.          CLEAN: Remove offline files in the specified conferences.
  766.          ─────
  767.                    Example: FAE /CLEAN:1 -> Removes offline files in
  768.                                             conference #1.
  769.  
  770.          KILLDIR: This switch will force FAE to automatically remove the   
  771.          ───────  #FAE# temporary directory if it is present.
  772.  
  773.          INDEX: Make FAE create .IDX files for all file areas, in all      
  774.          ─────  conferences.
  775.  
  776.          You can also combine all the previous parameters and FAE will
  777.     process them in sequence.  When using the /? switch, the program
  778.     terminates automatically after displaying the help screen.
  779.  
  780.               Example: FAE /NEW:0 /SORT:0-3 /CLEAN:0 /LIST  
  781.  
  782.          This example will mass upload new files in conference 0, sort
  783.     conferences 0 to 3, remove offline files in conference 0 and create the
  784.     master file list.
  785.  
  786.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 13 ]=-=-=-
  787.  
  788.                            Conference Selection Menu
  789.                            ~~~~~~~~~~~~~~~~~~~~~~~~~
  790.          This is where you will find yourself when you load the program. 
  791.     From this menu you select which conference you wish to work on or you
  792.     can do global conference commands.  They available functions here are:
  793.  
  794.      F2: Add New Files: You can mass upload all offline files for every file
  795.          ─────────────  area in a conference when you use this option.  It
  796.          will show you the name of the current area it is working on, and
  797.          the number of files added.  
  798.  
  799.          The file description will be the one you entered in the setup
  800.          program. When your are using the load FILE_ID.DIZ toggle, and a
  801.          description file is found, FAE will use it instead.
  802.  
  803.          Finally, you can use CTRL+F2 to mass upload files in all tagged
  804.          conferences.
  805.  
  806.      F3: Sort All Areas: Eventually, you might need to sort your file areas.
  807.          ──────────────  Well, this should do the trick.  It uses the method
  808.          you specified in FAESET.  To abort the sorting, hit escape anytime
  809.          and the current file area will remain partially sorted.  It's also
  810.          possible to sort all tagged conferences by using CTRL+F3.
  811.  
  812.      F4: Remove Offline Files: This will scan the areas and remove the files
  813.          ────────────────────  that are offline.  Be careful not to use this
  814.          if you have an "Offline File" area, as it will remove all of the
  815.          files for obvious reasons.  As an extra measure of protection, you
  816.          can use the MIN OFFLINE and OFFLINE SCAN options in the setup
  817.          program.  As usual, CTRL+F4 will process all tagged conferences.
  818.  
  819.      F5: Create file list: This option allows you to create the master file
  820.          ────────────────  list of your BBS.  FAE creates the file under the
  821.          name specified in FAESET.  Another way to create it is to type "FAE
  822.          /LIST" at the command line. 
  823.  
  824.      F6: Create IDX files: This option tells FAE to create the index files 
  825.          ──────────────── (.IDX) that are used since PC-Board 15.1.  Using
  826.          CTRL+F6 will process all tagged conferences.
  827.  
  828.      T : Tag Conference: Tags the current conference to do batch commands on
  829.          ──────────────  selected conferences.  Using CTRL+T will tag all
  830.          available conferences.
  831.  
  832.      U : Untag Conference: Untags the current conference if it was tagged. 
  833.          ────────────────  Using CTRL+U will untag all tagged conferences.
  834.  
  835.      ALT+J:   Jump to DOS: If you need to check anything in DOS while you
  836.               ───────────  are in this menu, this option will perform a DOS
  837.               shell, swapping current memory to XMS/EMS/disk for maximum
  838.               available memory.
  839.  
  840.     Special Notes about this section...
  841.     ───────────────────────────────────
  842.        * FAE will only display conferences that have file areas in them.  
  843.  
  844.  
  845.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 14 ]=-=-=-
  846.  
  847.                               File Area Selection
  848.                               ~~~~~~~~~~~~~~~~~~~
  849.          After selecting a conference, FAE will show you the list of file
  850.     areas in that conference.  From this menu you can select which area you
  851.     wish to work on or you can do global file area commands.  The commands
  852.     affecting file areas are:
  853.  
  854.      D : Delete File Area: This option deletes the current file area from
  855.          ────────────────  your area list and asks you if you want to delete
  856.          the data file too.  If you have shared data files, do NOT delete it
  857.          (unless you really want to). You cannot use this on the "New
  858.          Uploads" file area.
  859.  
  860.      E : Edit File Area Stats: You can modify anything related to the      
  861.          ────────────────────  highlighted area using this command.  You
  862.          cannot use this on the "New Uploads" file area.
  863.  
  864.      N : Create New File Area: If you wish to create a new file area, this
  865.          ────────────────────  command will allow you to do so.  Just fill
  866.          the appropriate information.  To abort this process, hit Escape
  867.          without entering an area name.
  868.         
  869.      O : Reorder File Areas: You must press this key when on the area you
  870.          ──────────────────  wish to move, then the highlight bar will turn
  871.          red.  Move up and down with the arrow keys and press enter to
  872.          select the current position.  FAE inserts the area between the
  873.          others, but it does not overwrite anything.  Note that when moving
  874.          up/down you cannot move down after the "New Uploads" file area,
  875.          also, you cannot use this on the "New Uploads" area.
  876.  
  877.      P : Private Uploads Area: This command will allow you to enter the
  878.          ────────────────────  the private upload area of the current
  879.          conference.  You can use all of the regular file selection menu
  880.          commands when using this option.
  881.  
  882.      ALT+J:   Jump to DOS: If you need to check anything in DOS while you
  883.               ───────────  are in this menu, this option will perform a DOS
  884.               shell, swapping current memory to XMS/EMS/disk for maximum
  885.               available memory.
  886.  
  887.     Special notes about this section...
  888.     ────────────────────────────────
  889.        * In supporting the "New Uploads" area, I had to take out some
  890.          commands because it's a bit harder to update a text file than it is
  891.          to update a file that uses file records.  Edit is out because of
  892.          this, Delete is also out for obvious reasons, Reorder is out
  893.          because the new upload section is always the last area.
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 15 ]=-=-=-
  905.  
  906.                              Files Management Menu
  907.                              ~~~~~~~~~~~~~~~~~~~~~
  908.          After selecting an area, FAE will show you the list of files that
  909.     are in the area.  If none are present, FAE will ask you wether it should
  910.     upload all the files that are in the area path.  If you accept, one of
  911.     two things can happen:
  912.  
  913.            1. The FAE will load ALL of the files in the area.
  914.            2. The FAE will allow you to pick the files that you want
  915.               uploaded from a list of files that are present in the
  916.               directory.
  917.  
  918.          With a registered version of the FAE, you can choose what you want
  919.     to happen by using the Mass Upload toggle in the FAESET program.  With
  920.     the evaluation version, FAE will upload all the files.
  921.  
  922.          When all the files are loaded, you can have another set of
  923.     commands, which I will try to explain clearly in the following pages. 
  924.     I will include a description of ALL of the features wether they are only
  925.     available in the registered version or not.
  926.  
  927.      F2: Add New Files: This will process the current file area and add all
  928.          ─────────────  of the files that are on the disk but not in the
  929.          file listings.  FAE uploads everything, and uses either a
  930.          FILE_ID.DIZ or the default description from FAESET to describe the
  931.          program.
  932.  
  933.     ^F2: Add Selected Files: You can also use this command to mass upload 
  934.          ──────────────────  new files to the current area.  FAE will
  935.          display a list of files that are not on-line.  Then, you can browse
  936.          through the list using the arrow keys and select the files you want
  937.          on-line.  To select an entry, press 'T' to tag the file (or CTRL+T
  938.          to tag them all), you can also use 'U' (CTRL+U for all) to untag a
  939.          file.   It is possible to view the contents of a file by pressing
  940.          'V' when you are on the file to process.  To put the files on-line,
  941.          press ENTER, to cancel the command, press ESCape.  If you press
  942.          enter with no tagged files, then FAE will upload the highlighted
  943.          file.
  944.  
  945.      F3: Sort All Files: Sorts all the files by default sorting method.  For
  946.          ──────────────  Evaluation Copies, this only sorts by filename, if
  947.          you are a registered user, you can select the default method in the
  948.          setup program.  Also in the registered version, is the CTRL+F3
  949.          command that allows you to select a method before sorting. 
  950.          Available sorting methods are by filename, extension, date, size,
  951.          and finally by description.
  952.               
  953.      F4: Remove Offline Files: This will scan the current file area and
  954.          ────────────────────  remove all the files that are NOT on the disk
  955.          and are in the file list.  The FAE will ask you to confirm before
  956.          proceeding so don't forget to avoid this if you have some offline
  957.          file areas.  If you used the offline scan option in FAESET, then
  958.          FAE will warn you before proceeding if there is more than the
  959.          percentage specified in the setup program.
  960.        
  961.  
  962.  
  963.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 16 ]=-=-=-
  964.  
  965.     ^F4: Remove old files: This Allows you to remove files uploaded before
  966.          ────────────────  a certain date.  It removes the old files from
  967.          the list AND deletes them from your HD.  Registered users have the
  968.          advantage of choosing wether the FAE removes all files automati-
  969.          cally, or if the user must be prompted for each file.  The
  970.          unregistered version removes all old files automatically without
  971.          confirmation.
  972.  
  973.      F5: Search for text: When you use this command, you will be asked for
  974.          ───────────────  a search string.  After you have entered the
  975.          string, FAE will search the file area STARTING FROM THE CURRENT
  976.          POSITION and will highlight the first occurrence of the text to be
  977.          found.  After, you are free to move around, or hit enter to edit
  978.          the description/comment.  FAE will display an error message if it
  979.          reaches the end of the list without finding the text. 
  980.  
  981.      F6: Search for next: Searches for the next occurrence of the string
  982.          ───────────────  entered by using the F5 command.  This command
  983.          also starts from the position where you are.  If the text is not
  984.          found, FAE will display a message telling you so.  Please note that
  985.          when you enter a search string, it is valid through out that
  986.          session of FAE.  
  987.                            
  988.      F7: Batch Menu: First, to get to this menu, you need at least one  
  989.          ──────────  tagged file.  You have many useful features in this
  990.          menu, and these commands will affect ALL tagged files:
  991.  
  992.             * Description: This choice shall prove to be very useful if you
  993.               ───────────  want to modify the description of a program with
  994.               many disks.  All you have to do is enter a description and
  995.               press enter.
  996.  
  997.               Also, if you wish, FAE can auto-number the description by
  998.               adding pipe commands in the description.  Use |1 to have the
  999.               first number displayed, and |2 for the second number.  For
  1000.               example, if you want to obtain the following result:  "I'm a
  1001.               big program (01/10)" all you have to do is enter this as your
  1002.               description "I'm a big program (|1/|2)".  If the number of
  1003.               tagged files is greater than 10, FAE will automatically round
  1004.               out the first number with a zero.  You have to sort the area
  1005.               for the numbering to work correctly.
  1006.  
  1007.             * Uploaded by: This batch command will allow you to change the
  1008.               ───────────  name of the uploader (which is specified by
  1009.               "Uploaded by: ").  If there is no uploader for the file being
  1010.               processed, FAE will append a line with "Uploaded by: " and the
  1011.               user name entered.
  1012.  
  1013.             * File Ext.  : If you ever change your file compression method
  1014.               ─────────    (i.e., use ZIP instead of ARJ), all of your files
  1015.               on disk are renamed.  Use this option to change the extension
  1016.               of the files concerned.  This way you can keep the file
  1017.               information, without going through the trouble of re-uploading
  1018.               everything in your file areas.
  1019.  
  1020.  
  1021.  
  1022.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 17 ]=-=-=-
  1023.  
  1024.             * Touch File Size: If you ever need to verify the size of
  1025.               ───────────────  certain files, this option allows you to do
  1026.               this.  Use this for example if you remove BBS ads from
  1027.               compressed files and the size of the archive changes.  In
  1028.               these cases, PC-Board displays the old size.  This option
  1029.               checks all tagged files and does updates when necessary.
  1030.  
  1031.      F8: Toggle Size/Date: This command allows you to switch the display
  1032.          ────────────────  between one displaying the file size, and one
  1033.          that shows the file date.  When you use this option, FAE refreshes
  1034.          the screen to show the proper display.
  1035.  
  1036.     RET: Edit file description: You can change the description of the 
  1037.          ─────────────────────  current file by pressing ENTER.  This part
  1038.          is a very important one in FAE.  You have many commands that are
  1039.          available when you enter what I call the FAE Edit Mode.  Here's a
  1040.          list:
  1041.  
  1042.               UP   - Go up one line (Multi-line descriptions)
  1043.  
  1044.               DOWN - Go down one line (Multi-line descriptions)
  1045.  
  1046.               CTRL+I -  Insert blank line.  If you are currently editing a
  1047.                         file description, than a description line will be
  1048.                         added, if you are editing a comment line, then that
  1049.                         will be added.
  1050.  
  1051.               CTRL+Y -  Delete Line.  When you are editing a multi-line
  1052.                         description, FAE will remove the line you are
  1053.                         currently on. If you are editing a comment line,
  1054.                         when no comment lines remain, FAE will exit from
  1055.                         Editing Mode.
  1056.  
  1057.               CTRL+LEFT - Move one word left.
  1058.  
  1059.               CTRL+RIGHT - Move one word right.
  1060.  
  1061.               HOME - Go to beginning of current line.
  1062.  
  1063.               END  - Go to end of current line.
  1064.  
  1065.               INSERT -  Put yourself in Insert Mode.  Does not overwrite
  1066.                         the string.
  1067.  
  1068.               DELETE -  Remove current character.
  1069.  
  1070.               LEFT   -  Move one character left. 
  1071.  
  1072.               RIGHT  -  Move one character right.  If you are editing a
  1073.                         comment line, FAE will scroll the display left when
  1074.                         you reach column 69.
  1075.  
  1076.               BACKSPACE - Delete previous character.
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 18 ]=-=-=-
  1082.  
  1083.      A : Add Blank Comment Line: Use this command to add an empty comment
  1084.          ──────────────────────  line in the file listing.  FAE adds it at
  1085.          the current position, and treats it the same way as a comment line
  1086.          when you are in Edit Mode.
  1087.  
  1088.      C : Copy Files: Copies the DOS file to a specified destination, you can
  1089.          ──────────  also use CTRL+C to copy all tagged files.
  1090.  
  1091.      D : Delete File: Delete the current file from the file list, and
  1092.          ───────────  prompts you for confirmation to remove it from disk. 
  1093.          You can also mark the file as "DELETED".  If you choose to do this,
  1094.          FAE will not remove the DOS file unless you ALSO specified the
  1095.          "Delete DOS file".
  1096.  
  1097.          Also, there is a flag called "Remove Credit".  When you use this,
  1098.          FAE searches for the user who sent the file, and if it finds him,
  1099.          removes credit for the size, and for the number of uploads.  FAE
  1100.          learns the uploader by the "Uploaded by" line.  If none is present,
  1101.          then no updates can be done.  Of course, CTRL+D does the same thing
  1102.          on all tagged files.
  1103.  
  1104.      G : Get FILE_ID.DIZ: This command allows you to extract a FILE_ID.DIZ
  1105.          ───────────────  from an archive and put the contents as the
  1106.          description of the current file.  Using CTRL+G processes all tagged
  1107.          files, when there is a line with the uploader name, FAE saves it
  1108.          and appends it at the end of the FILE_ID.DIZ description.
  1109.  
  1110.      M : Move Files: Moves the current file from one area to another in
  1111.          ──────────  the same conference along with its file record.  FAE
  1112.          displays the list of available areas, you select where you want to
  1113.          move the file(s) and press ENTER to confirm.  Pressing ESCape while
  1114.          in the area listing cancels this command.  Using CTRL+M does the
  1115.          same action on all tagged files.
  1116.  
  1117.      N : Move file to another conference: Move the current or the tagged
  1118.          ───────────────────────────────  files (CTRL+N) to a file area in
  1119.          another conference.  First, the program shows you a list of all
  1120.          available conferences, press ENTER to select where to move the
  1121.          files or ESCape to cancel.  After, FAE will display the file areas
  1122.          if the conference you chose.  Here again, press ENTER after
  1123.          selecting an area, or hit ESCape to cancel.  The program will also
  1124.          move the file physically to the directory of the area specified.
  1125.  
  1126.      O : Move Files Offline: Moves the DOS file to a specified destination
  1127.          ──────────────────  but leaves the file information in the current
  1128.          area.  Thus, putting it offline.  If you use CTRL+O, all tagged
  1129.          files will be processed.
  1130.  
  1131.      P : Purify Archive: Allows you to remove unwanted BBS ads from
  1132.          ──────────────  archives.  If you use the trashcan file in the
  1133.          archive manager, this function uses the same file to process the
  1134.          archive.  You can use CTRL+P to clean all tagged archives.
  1135.  
  1136.      R : Rename file: This will allow you to change the filename of the
  1137.          ───────────  current file.  If the original file exists on disk,
  1138.          then FAE will rename it physically to the name entered.
  1139.  
  1140.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 19 ]=-=-=-
  1141.  
  1142.      S : Save FILE_ID.DIZ: This command will make FAE save the description 
  1143.          ────────────────  of the current file to a FILE_ID.DIZ file.  It
  1144.          will also put it in the archive.  FAE will warn you if there is
  1145.          already a FILE_ID.DIZ before overwritting it.  CTRL+S will perform
  1146.          the save action on all tagged files.
  1147.  
  1148.      T : Tag File: Tags the current file to do batch commands on the
  1149.          ────────  selected files.  Using CTRL+T will tag all the files in
  1150.          the area.
  1151.  
  1152.      U : Untag File: Untags the current file if it was tagged.  Using CTRL+U
  1153.          ──────────  will untag all tagged files.
  1154.  
  1155.      V : View Archive/File: FAE will either display the current file in the
  1156.          ─────────────────  file viewer, or will load it in the archive
  1157.          manager.  The program can also display GIF files, by loading them
  1158.          to the viewer specified in FAESET.  With the evaluation copy of
  1159.          FAE, you can't view GIF files.
  1160.  
  1161.     ALT+J:    Jump to DOS: If you need to check anything in DOS while you
  1162.               ───────────  are in this menu, this option will perform a DOS
  1163.               shell, swapping current memory to XMS/EMS/disk for maximum
  1164.               available memory.
  1165.  
  1166.     ALT+S:    Display free space: Displays the free space of every drive
  1167.               ──────────────────  present from C: to Z:
  1168.  
  1169.  
  1170.     Special Notes about this section...
  1171.     ────────────────────────────────
  1172.        * When editing multi-line descriptions or comment lines, FAE will
  1173.          highlight the entire block that is with this file.  Note that you
  1174.          cannot move past the top or bottom limits of this block.
  1175.  
  1176.        * When deleting lines with CTRL+Y, FAE will not delete the current
  1177.          file if you are on a one line description file.  It will only clear
  1178.          the current line.
  1179.  
  1180.        * Comment lines can be longer than the 68 columns the program
  1181.          displays the text in.  In these cases, when you are in edit mode,
  1182.          FAE will scroll the display right when the cursor is at position
  1183.          68.  FAE always scrolls the entire block of comment lines, instead
  1184.          of only the current line.
  1185.  
  1186.        * If you don't use the "Uploaded by" feature of PC-Board, then you
  1187.          can't remove credit from the uploader when deleting files.
  1188.  
  1189.        * One small annoyance in FAE happens when you move files through file
  1190.          areas or file conferences.  This little problem occurs when the FAE
  1191.          can't move the file. FAE tells you something like "ERROR: Cannot
  1192.          move FILENAME.EXT".  Actually, it does move the file through the
  1193.          DIR files, but it does not move it physically.
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 20 ]=-=-=-
  1200.  
  1201.                                 Archive Manager
  1202.                                 ~~~~~~~~~~~~~~~
  1203.          The complete Archive Manager is only available to registered users. 
  1204.     There might be some hidden bugs I did not find, but for general
  1205.     maintenance of archives, it does the job quite well.  To use this
  1206.     feature, you need to have PKZIP.EXE, PKUNZIP.EXE, ARJ.EXE, LHA.EXE and
  1207.     SQZ.EXE in your DOS path.  If, you do not have any LZH files on your
  1208.     BBS, you don't need LHA.EXE.  This might seem stupid to mention, but I
  1209.     don't want people panicking over this.  In future versions, there might
  1210.     be an Edit command, and a virus scanner.  But for now, here are the
  1211.     current functions:
  1212.  
  1213.     RET: View File: Extracts the current file and loads it into the external
  1214.          ─────────  viewer.  If the file is also an archive, FAE shows you
  1215.          the contents, and you can view files in that one also.
  1216.  
  1217.      A : Archive Statistics: This command will show you the name of the    
  1218.          ──────────────────  current file, as well as some statistics
  1219.          related to it.  You can also see the archive type, and wether or
  1220.          not the file is protected by a security enveloppe.
  1221.  
  1222.      C : Clean Archive: Allows you to remove all files present in the
  1223.          ─────────────  compressed file that are in the trashcan file.  Of
  1224.          course, you must confirm before the FAE processes the archive.
  1225.  
  1226.      D : Delete File: Deletes the file from the archive but first it asks if 
  1227.          ───────────  you want to add the deleted file to the trashcan.  The
  1228.          trashcan is the BBSADS.TXT file supplied with the FAE and is a list
  1229.          of BBS ads, and other useless files that inflate compressed files
  1230.          for nothing.  CTRL+D deletes all tagged files, but does not offer
  1231.          to put the filenames in the trashcan.  
  1232.  
  1233.      E : Extract a file: Extracts the current file to the specified default
  1234.          ──────────────  directory.  Using CTRL+E produces the same result
  1235.          for all tagged files.
  1236.  
  1237.      G : Archive Password: Allows you to indicate the password for encrypted
  1238.          ────────────────  ZIP/ARJ files.  Please keep in mind that this
  1239.          feature is not available for LZH and SQZ archives.  Every time you
  1240.          enter a new archive, FAE resets this field to blank for security
  1241.          reasons.
  1242.  
  1243.      I : Test file integrity: This option allows you to test a compressed
  1244.          ───────────────────  file.  But for now, it does nothing if the
  1245.          file is corrupt.  This is not a virus scanner!
  1246.  
  1247.      P : Change Extract Path: This option will allow you to change the
  1248.          ───────────────────  default directory where files are extracted
  1249.          when using the archive manager.  If the directory specified does
  1250.          not exist, FAE will offer to create it for you.  Changes made here
  1251.          are valid until you exit the program.
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 21 ]=-=-=-
  1259.  
  1260.      S : Sort Files: Allows you to sort the files in the present archive.
  1261.          ──────────  You can presently sort by filename, extension, packed
  1262.          size, date and path.  I will add more methods if it becomes
  1263.          necessary.  This only processes the displayed list, it DOES NOT
  1264.          affect the archive contents in any way.
  1265.  
  1266.      T : Tag File: Tags the current file to do batch commands on the
  1267.          ────────  selected files.  Using CTRL+T tags every file in the
  1268.          list.
  1269.  
  1270.      U : Untag File: Untags the current file if it was tagged.  Once again,
  1271.          ──────────  CTRL+U untags all tagged files.
  1272.  
  1273.     ALT+J:    Jump to DOS: If you need to check anything in DOS while
  1274.               ───────────  you are in this menu, this option will perform a
  1275.               DOS shell, swapping current memory to XMS/EMS/disk for maximum
  1276.               available memory.
  1277.  
  1278.     Special notes about this section...
  1279.     ────────────────────────────────
  1280.        * FAE recognizes archives through their signatures not by using the
  1281.          file extension.  So don't be surprised if a file is loaded in the
  1282.          Archive Manager but doesn't have the proper file extension.
  1283.  
  1284.        * Some files in archives have special characters in their names
  1285.          (i.e., spaces or !) when processing these, it is better to tag them
  1286.          and then do the command that you want to do.  This problem usually
  1287.          happens because archiver uses the character in question (! to pass
  1288.          a file list) or ignores it on the command line (space).  I will fix
  1289.          this in the next version.
  1290.  
  1291.        * The code for processing SQZ files is very preliminary, but it
  1292.          should process most files correctly.  If you find a file that FAE
  1293.          cannot use, please send it to the support BBS.
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 22 ]=-=-=-
  1318.  
  1319.                           Suggestions When Using FAE
  1320.                           ~~~~~~~~~~~~~~~~~~~~~~~~~~
  1321.  
  1322.          I designed FAE with speed in mind.  I'm writing this program using
  1323.     a 286 computer (yeah, really!) so when I say that it's fast, I'm talking
  1324.     on a slow computer.  Most of the configurable options will either speed
  1325.     up or slow down the FAE, but some are necessary.
  1326.  
  1327.        * The first thing that I suggest is using the "Offline Scan" option
  1328.          in FAESET. Why?  Because if you use the remove offline command in
  1329.          an area with many offline files, you can lose a lot of files in a
  1330.          matter of seconds.
  1331.  
  1332.          But, when using the "Offline Scan", FAE will alert you if a file
  1333.          area has more than a certain percentage of offline files in an
  1334.          area. This protects you from scrapping an entire area accidentally.
  1335.  
  1336.        * Another option that I recommend, is the "Sort around comment" flag. 
  1337.          With this on, when sorting, FAE will ignore all lines that are
  1338.          there as comment lines, it sorts around them.
  1339.  
  1340.        * One feature that is good (and not planned!) happens with comment
  1341.          lines.  If there is a file name as the first word, when mass
  1342.          uploading files, FAE will not upload this file.  This is very
  1343.          useful if you update your master file list every night and it
  1344.          always has the same name.
  1345.  
  1346.        * When in the file listings, you can do SHIFT+letter to jump to the
  1347.          first/next file name beginning with that letter.
  1348.  
  1349.  
  1350.                                  Future Plans
  1351.                                  ~~~~~~~~~~~~
  1352.        * Make FAE faster and smarter.
  1353.        * Put in a search for duplicate files.
  1354.        * Support more archive types in the archive manager (suggestions are
  1355.          welcome!).
  1356.        * Add more conference wide commands
  1357.        * Expand command line parameters.
  1358.        * and much... much more!
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 23 ]=-=-=-
  1376.  
  1377.                                Editing Commands
  1378.                                ~~~~~~~~~~~~~~~~
  1379.         While editing, there are many commands available. Here they are:
  1380.  
  1381.         CTRL-Left      : Move left one word
  1382.         CTRL-Right     : Move right one word
  1383.         Left Arrow     : Move left one character
  1384.         Right Arrow    : Move right one character
  1385.         Home           : Move to beginning of line
  1386.         End            : Move to end of line
  1387.  
  1388.         Backspace      : Delete previous character
  1389.         Delete         : Delete current character
  1390.         CTRL-Backspace : Delete previous word
  1391.         CTRL-Y         : Delete line
  1392.  
  1393.         Insert         : Toggle Insert/Overwrite mode
  1394.         Return         : Accept and save edited line
  1395.         Escape         : Abort edition and restore previous entry.
  1396.  
  1397.  
  1398.                               Known Bugs/Problems
  1399.                               ~~~~~~~~~~~~~~~~~~~
  1400.          In this section, I will briefly show some problems that ─>MIGHT<─
  1401.     occur with this program.  I tested rigorously, but I do not have time to
  1402.     fix everything. So here is a rundown of a few of the bugs that I know
  1403.     are present at this time:
  1404.  
  1405.        * When moving files, should it be from one area to another, of one
  1406.          conference to another, if you get a message "ERROR: Cannot move
  1407.          FILENAME.EXT", this message says it cannot physically move the
  1408.          file, either because the file is not present on disk, or because
  1409.          there is a problem with the destination path (i.e., file doesn't
  1410.          exist, disk full, etc.).  FAE still moves the file record to the
  1411.          new location though.
  1412.  
  1413.          If this is a problem for anybody, leave me a message, and I'll fix
  1414.          it ASAP.
  1415.  
  1416.        * This is a dumb bug, but here goes.  The program might crash if you
  1417.          do not specify a text viewer, mainly because it won't know what to
  1418.          do with the file.  I'll fix this shortly.
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 24 ]=-=-=-
  1435.  
  1436.                                Technical Support
  1437.                                ~~~~~~~~~~~~~~~~~
  1438.          You can get technical support by either by calling the support
  1439.     board, or by sending me a letter directly.  Unregistered users will get
  1440.     help by mail only if they send me a self-addressed stamped envelope. 
  1441.     When contacting me for support, tell me about your equipment (XT, 386,
  1442.     486, etc.), also mention the nature of your problem.  Don't just say
  1443.     things like: "When I press enter, I can't edit the description".  Try to
  1444.     be as specific as possible, and also, if you can recreate the problem,
  1445.     tell me how so I can help you.
  1446.  
  1447.          If you have suggestions, or comments, don't be a stranger, I take
  1448.     note of every new idea and try to put it in the program.
  1449.  
  1450.  
  1451.                                  System Files
  1452.                                  ~~~~~~~~~~~~
  1453.          The following is the list of all files present in this package, if
  1454.     any file is missing, please contact me to get a complete version.
  1455.  
  1456.          FAE.DAT      - This file is created by FAESET or FAE and it
  1457.                         contains the configuration for the program.
  1458.          FAE.EXE      - Executable file, PC-Board file area editor.
  1459.          FAE.HLP      - Help file, must be in your DOS path for FAE to find
  1460.                         it.
  1461.          FAE.INI      - Data File, must be in DOS path or it will not be
  1462.                         loaded.
  1463.          FAE.DOC      - This file, documentation for the program.
  1464.          KEYS.FAE     - Quick reference to keyboard commands in FAE
  1465.          FAESET.EXE   - Setup program, must also be in your DOS path.
  1466.          SUPPORT.BBS  - List of FAE Official Support Bulletin Boards.
  1467.          HISTORY.DOC  - History file, contains all changes made since the
  1468.                         last version of the program.
  1469.          REGISTER.TXT - Registration form for FAE.
  1470.          PCBFILER.DEF - This file is supplied by PC-Board, you need it when
  1471.                         configuring the DIR file colors.
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 25 ]=-=-=-
  1494.  
  1495.                                   Conclusion
  1496.                                   ~~~~~~~~~~
  1497.          I hope this program delivers what I said it would, and that you
  1498.     will appreciate the time I've put in it by registering the program, and
  1499.     by getting back to me via Comments/Suggestions/Bug Reports.
  1500.  
  1501.          All FAE users (registered or unregistered) are welcome to call the
  1502.     support BBS to get answers to their questions.  When creating your user
  1503.     account, tell the sysop you are a user of the program, and you will get
  1504.     access to the support conference.
  1505.  
  1506.                                                   Steffan Surdek
  1507.                                                           
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.                             Other Products from us
  1514.                             ~~~~~~~~~~~~~~~~~~~~~~
  1515.     AV21    - An ANSI Graphics Viewer with Internal ANSI Driver, 50 Lines
  1516.               Mode viewer, File Descriptions and much much more.
  1517.               
  1518.               By Marc Bouchard & Steffan Surdek.
  1519.  
  1520.     FAE15   - A Celerity 1.4x File Area Editor to manage all the file
  1521.               conferences.
  1522.  
  1523.               By Steffan Surdek.
  1524.  
  1525.     NSE20B  - A CelerityNet Subs Editor to keep up with your sub list.
  1526.  
  1527.               By Marc Bouchard & Steffan Surdek.
  1528.  
  1529.     RESET10B- A Celerity Reset Utility for miscellaneous user parameters
  1530.  
  1531.               By Marc Bouchard & Steffan Surdek.
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  -=-=-=[ PC-Board FAE Documentation (c) 1993 Steffan Surdek - Page 26 ]=-=-=-
  1553.