home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / TGFL_150.ZIP / TGFL.DOC < prev    next >
Text File  |  1998-02-25  |  38KB  |  895 lines
  1.  
  2.  
  3.  
  4.            Telegard File Lister Pro v1.50 Documentation
  5.            Copyright (c) 1998-1999 iCode Software.
  6.            All rights reserved.
  7.  
  8.            File List Creator for Telegard Bulletin Board
  9.            Software (BBS) v3.10 (3.09g?)
  10.  
  11.            Configuration and Reference Manual
  12.            Written by David Stumpf
  13.  
  14.            iCode Software
  15.            7230 White Oak Circle
  16.            Houston, Texas 77040 USA
  17.  
  18.            Internet Email : David.Stumpf@Earthling.net
  19.            World Wide Web : http://www.darktech.org/icode
  20.  
  21.  
  22.  
  23.               TABLE OF CONTENTS
  24.  
  25.        Section 1.0    Software License Agreement
  26.        Section 1.1      Warranty Information
  27.        Section 1.2      Copyright Notice
  28.        Section 2.0    Product Information
  29.        Section 2.1      System Requirements
  30.        Section 3.0    Installation and Operation
  31.        Section 3.1      Installing the Software
  32.        Section 3.2      Command Line Options
  33.        Section 3.3      Config Files
  34.        Section 3.4      Include/Exclude Files
  35.        Section 3.5      Header/Footer Files
  36.        Section 3.6      MCI Codes
  37.        Section 4.0    Additional Product Information
  38.        Section 4.1      Product Revisions/Changes
  39.        Section 4.2      Product Coders and Testers
  40.        Section 5.0    Acknowledgments
  41.  
  42.  
  43.  
  44.  
  45.        Section 1.0       Software License Agreement
  46.  
  47.        Dark Zone Software  has  taken  every  precaution to  ensure
  48.        that no  harm  or damage will occur to systems running TGFL.
  49.        However, we  cannot  be responsible for any damages or other
  50.        losses  sustained  as a result of  running this  software on
  51.        your system.  The user assumes  full  responsibility for the
  52.        proper use of this program, whether damage occurs as a fault
  53.        of operator error or software error.
  54.        NO WARRANTIES ARE IMPLIED OR EXPRESSLY STATED.
  55.  
  56.        TGFL is distributed under the concept of FreeWare.   Users are
  57.        allowed to use as distribute this program as they see fit.  No
  58.        fees are required for the use or  distribution  of the package
  59.        nor can any be charged for the use, distribution or access too
  60.        this package.
  61.  
  62.        Dark Zone Software  grants an  unlimited  license  to  make and
  63.        distribute  TGFL which has been released to the public by  Dark
  64.        Zone  Software.   Absolutely  no  modifications  to  the  files
  65.        contained in the software package, including this documentation
  66.        file,  may be  made  for distribution.  No  fee  may be charged
  67.        by anyone other than  Dark Zone Software beyond the actual cost
  68.        of providing these copies  without the prior written consent of
  69.        Dark Zone Software.
  70.  
  71.  
  72.  
  73.        Section 1.1      Warranty Information
  74.  
  75.       This  package is provided as-is, without warranty of any  kind,
  76.       either  expressed or implied, and is only guaranteed to  occupy
  77.       disk  space.  In no event will the author be liable to  you  or
  78.       anyone else for any damages, including (but not limited to) any
  79.       lost profits, lost savings or other incidental or consequential
  80.       damages  arising out of the use of, or inability to  use,  this
  81.       package.
  82.  
  83.       In short:  You're on your own.  If it works for you, great;  if
  84.       not,  or if it breaks something, c'est la vie.  As  the  saying
  85.       goes,  "Use it at your own risk, but if it breaks,  *YOU*  have
  86.       the pieces."
  87.  
  88.  
  89.  
  90.        Section 1.2      Copyright Notice
  91.  
  92.      This package and all files contained herein are Copyright (c) 1998
  93.      and 1999 by iCode Software.   No modifications may be made to  any
  94.      part  of this  program  and/or  package  without  express  written
  95.      permission from iCode Software.    This package may be distributed
  96.      in  any  medium  so long as  the  following  conditions  are  met;
  97.      a)  The package  must  be  unmodified    b)  No fees of  any  kind
  98.      may be charged for this package or  directly for  access  to  this
  99.      package.  This software may be distrubited by CD-ROM media  and/or
  100.      "pay-only" system.
  101.  
  102.  
  103.  
  104.        Section 2.0    Product Information
  105.  
  106.     TGFL is a file list creator.  In short, TGFL reads your Telegard
  107.     BBS files areas, and, according to the options that you use it
  108.     creates a list of files contained in your files base.  It also
  109.     has the ability to create several other files which can aid you
  110.     in running your BBS.
  111.  
  112.     This documentation will explain all of the availible options and
  113.     useses of TGFL and how it can help you and your system.  Please
  114.     take the time to read this entire document.  Knowing exactly how
  115.     this software functions can help you use it more reliably and
  116.     safely.
  117.  
  118.  
  119.  
  120.  
  121.        Section 2.1      System Requirements
  122.  
  123.      TGFL requires the following minimal system to operate properlly.
  124.  
  125.         100% IBM Compatible Computer
  126.         80286 or above CPU
  127.         MS-DOS v4.00 or Compatible
  128.         Telegard v3.10 (3.09x)
  129.  
  130.         TGFL has been tested with MS-DOS v5.00, MS Windows v3.11,
  131.         MS Windows v95, 98, NT v4.0 and OS2 Warp 4 and has had
  132.         to problems.  Also, this software was written for Telegard
  133.         BBS Software v3.09g1, which is a pre-release of v3.10.
  134.         In the event any changes are made to Telegard before the
  135.         release of v3.10 TGFL will be updated, although no changes
  136.         are expected.
  137.  
  138.  
  139.  
  140.  
  141.        Section 3.0    Installation and Operation
  142.  
  143.     The installation and operation of TGFL can be somewhat complicated
  144.     due to the large number of options it has and the range of things
  145.     it can preform.
  146.  
  147.     In the following sections, each and every option will be explained
  148.     in full detail.  In some instances a cross-reference may be listed
  149.     to help explain all possible operations.
  150.  
  151.  
  152.  
  153.        Section 3.1      Installing the Software
  154.  
  155.     To install TGFL simply unarchive the main package in to a directory
  156.     of your choice.  A sub directory off of your main BBS directory is
  157.     suggested, although you may place it anywhere you wish.
  158.  
  159.     Along with the installation procedures, you should add a line to
  160.     you AUTOEXEC.BAT file to help TGFL and many other utilities to
  161.     find your BBS software.  Telegard BBS software uses a standard
  162.     environment variable of "TELEGARD=C:\BBSDIR".  Some utilities
  163.     also support the "BBS=" environment variable.  If you are not
  164.     low on environment space, it is suggested that you place both
  165.     of these variables in your environment.  For more help on your
  166.     environment, refer to your operating system manual.
  167.  
  168.     Considerations when choosing a directory.
  169.  
  170.       1. Putting TGFL in your main BBS directory is not suggested,
  171.          the reason for this is simple.  TGFL has several optional
  172.          files it can be configured to use.  Even though at first
  173.          you may choose NOT to use these files, you may decide to
  174.          add them later.  The more files that are contained in your
  175.          main BBS directory the more difficult it is for you to
  176.          sort through them and know what file belongs to what other
  177.          application.
  178.  
  179.       2. It is strongly suggested that if you run a local network
  180.          that you place TGFL on a local drive.  Not only will your
  181.          computer be able to access TGFL faster, but TGFL creates
  182.          some temporary files that is uses to keep track of some
  183.          information.  TGFL will be able to access these files
  184.          and any others faster if it is not run over a network.
  185.  
  186.     After you have decided on a directory and unarchived this package
  187.     in to that directory, you will need to decide what it is that you
  188.     would like TGFL to do for you.  To help you decide I suggest that
  189.     you read the sections explaining the options that TGFL has and
  190.     review which ones you would like to use.
  191.  
  192.  
  193.  
  194.        Section 3.2      Command Line Options
  195.  
  196.     TGFL has many command line options that can be used to provide
  197.     several desired results.  All of the command line options will
  198.     be listed below with detailed information about each.  A short
  199.     description of all command line options is also provided by
  200.     TGFL when the /? or /H command line options are used, or when
  201.     no command line option is supplied.
  202.  
  203.     Any option that contains a (See Also:) field means to refer to
  204.     the example TGFL.CFG file that came with this package.
  205.  
  206.     For any options that allow a number, anything larger than the
  207.     below listed valid numbers will cause TGFL to use it's internal
  208.     default.  Also, if no number is presented, the default is used.
  209.     This means, for example, if you just use "/N" then a value
  210.     of 5 is assumed (the default).
  211.  
  212.     Any option which asks for a filename MUST end with a space, as
  213.     an example: "TGFL /LST:ALLFILES.LST /N" is the correct format,
  214.     the use of "TGFL /LST:ALLFILES.LST/N" WILL cause an error.
  215.  
  216.     All options are list in alphabetical order;
  217.  
  218.     /?     This option tells TGFL to display a help screen.  The help
  219.            screen will also be displayed if no command line parameters
  220.            are given.
  221.  
  222.  
  223.     /#     This option tells TGFL to add the total number of downloads
  224.            for each file the list, below the file description.
  225.            (See also: Downloads=)
  226.  
  227.  
  228.     /BBSx  This option tells TGFL to create a file named FILES.BBS
  229.            in each file directory that is processes.  This file can
  230.            be in one of four different formats.  To specify a format,
  231.            add the format number after the parameter. (Example: /BBS1)
  232.            (Note: CD-ROM areas are ignored)  (See also: MakeBBS=)
  233.            Below is a list of the formats.
  234.  
  235.             1 = RemoteAccess 1.xx  (13 spaces as long description seperator)
  236.             2 = RemoteAccess 2.xx  ("| " as long description seperator)
  237.             3 = ProBoard           ("+" as long description seperator)
  238.             4 = Maximus            (one long description line)
  239.  
  240.            If any number other than the above is specified, 1 is assumed.
  241.  
  242.  
  243.     /BL    This option tells TGFL to add a blank line at the end of every
  244.            file description.  This allows each file to be seperated by a
  245.            blank line for easier reading. (See also: SeperateDesc=)
  246.  
  247.  
  248.     /CFG:  This option specifies a config or configuration file for
  249.            TGFL to use.  The config file can contain a number of options
  250.            and also makes it easier to configure multiple lists without
  251.            trying to get a command line just perfect.  The format for this
  252.            command is;
  253.  
  254.             TGFL /CFG:C:\DIR\TO\FILE\FILENAME.EXT
  255.  
  256.            The config file does NOT have to have any particular name OR
  257.            extension, as you must specify both on the command line, it
  258.            simply must be of the correct format.  (IE: plain text)
  259.            (See also: Config Files)
  260.  
  261.  
  262.     /D     This option tells TGFL to add the date on which the file was
  263.            uploaded to the list below the description.
  264.            (See also: UploadDate=)
  265.  
  266.  
  267.     /E     This option tells TGFL to display extended file information
  268.            after the file description.  This information tells wether
  269.            the file is a Free Download, Availible and wether or not it was
  270.            "Hatched" in to the file area.  This option ONLY works when
  271.            used with the /S option. (See also: ExtendedStatus=)
  272.  
  273.  
  274.     /EXC:  This parameter specifies a path and filename to an Exclude
  275.            file. The Exclude file contains a list of file names of the
  276.            file bases.  These names are simply listed one on each line.
  277.  
  278.            For example;
  279.  
  280.             SYSOP
  281.             UPLOADS
  282.  
  283.            This will exclude the SYSOP and UPLOADS file areas from the
  284.            output files.  This filename and possibly the path are
  285.            specified the same way as the /CFG: command.
  286.            (See also: ExcludeFile=)
  287.  
  288.  
  289.     /FN    This option tells TGFL to filter extra spaces out of file
  290.            names.  So a name like "TEST    .ZIP" now becomes "TEST.ZIP".
  291.            This will make the list readible by many more programs such
  292.            as TimEd.  (See also: FilterName=)
  293.  
  294.  
  295.     /FTR:  This option tells TGFL to use the specified FOOTER file.
  296.            This file is a basic ASCII (text) file that will be added
  297.            to the bottom of the output list file.  You can use this
  298.            file to provide detailed information about the files list
  299.            or your system.  (See also: FooterFile=)
  300.  
  301.  
  302.     /HDR:  This option tells TGFL to use the specified HEADER file.
  303.            This files is a basic ASCII (text) file that will be added
  304.            to the top of the output list file.  This file works the
  305.            same as the footer file.  (See also: HeaderFile=)
  306.  
  307.     /HFT:  This option tells TGFL to use the specified files as a
  308.            footer for all HTM files that it creates.  Since this
  309.            is a generalized footer, you cannot specify detailed
  310.            information about the file area directly.  Some MCI
  311.            codes can help provide this information though.
  312.            This file is layed out in HTML (HyperText Markup
  313.            Language) format and MUST end with;
  314.  
  315.             </body>
  316.             </html>
  317.  
  318.            (See also: HTMFooter= and Sample Files)
  319.            (Other HTML code may be used as well but it MUST have the)
  320.            (two above listed line at the end or the file may not display)
  321.  
  322.  
  323.     /HHD:  This option tells TGFL to use the specified files as a
  324.            header for all HTM files that it creates.  Since this
  325.            is a generalized header, you cannot specify detailed
  326.            information about the file area directly.  Some MCI
  327.            codes can help provide this information though.
  328.            This file is layed out in HTML (HyperText Markup
  329.            Language) format and MUST end with;
  330.  
  331.             <html>
  332.             <body>
  333.  
  334.            (See also: HTMHeader= and Sample Files)
  335.            (Other HTML code may be used as well but it MUST have the)
  336.            (two above listed line at the top or the file may not display)
  337.  
  338.     /HTMx  This option tells TGFL to create an index.htm file in
  339.            each file directory that it processes.  This file contains
  340.            a list of all of the files in the directory, with size and
  341.            date information as well as description.  The HTML file
  342.            also contains links to the files for easy D/L from a web page.
  343.            Three different formats are accessable.
  344.  
  345.              1 = A table within a table, provides a nice border.
  346.              2 = A single table, no extra border.
  347.              3 = A single table, no borders at all, this makes
  348.                  the text seem to "float" on the page.
  349.  
  350.             Any number other than one of the above is ignored and
  351.             1 is assumed.  (See also: HTMType= & MakeHTM=)
  352.  
  353.     /IDXx  This parameter instructs TGFL to create an index file
  354.            in the same directory as the files, for each area processed,
  355.            with a listing of only the files in that base.  This is a
  356.            simplified file and does not contain any totals information.
  357.            CD-ROM areas are ignored.  The optional "x" afterwards is a
  358.            number, either 1 or 2.  The default is 1.  This specifies the
  359.            desired file name only. (See also: IDXType= & MakeIDX=)
  360.  
  361.                    1 = 00index.txt
  362.                    2 = 00_index.txt
  363.  
  364.            The only difference in the two styles is the file name.
  365.  
  366.  
  367.     /INC:  This parameter specifies a path and filename to an Include
  368.            file, this file contains a list of file names of the file bases.
  369.            These names are simply listed one on each line.  For example;
  370.  
  371.             GENERAL
  372.             TELEGARD
  373.  
  374.            This will include the GENERAL and TELEGARD file areas in the
  375.            output file (file list).  This filename and possible the
  376.            path are specified the same way as the /CFG: command.
  377.  
  378.            Rememver, if you specify an include file, ONLY the names
  379.            of the bases in this file will be in the output file.
  380.            (See also: IncludeFile=)
  381.  
  382.  
  383.     /IFT:  This option tells TGFL to use the specified files as a
  384.            footer for all IDX files that it creates.  Since this
  385.            is a generalized footer, you cannot specify detailed
  386.            information about the file area directly.  Some MCI
  387.            codes can help provide this information though.
  388.            This file is layed out in plain ASCII.
  389.            (See also: IDXFooter= and Sample Files)
  390.  
  391.  
  392.     /IHD:  This option tells TGFL to use the specified files as a
  393.            header for all IDX files that it creates.  Since this
  394.            is a generalized header, you cannot specify detailed
  395.            information about the file area directly.  Some MCI
  396.            codes can help provide this information though.
  397.            This file is layed out in plain ASCII.
  398.            (See also: IDXHeader= and Sample Files)
  399.  
  400.  
  401.     /LST:  This option specifies the path and filename to an output
  402.            file.  If used the file that will be created by TGFL and
  403.            will contain the list of files in your files bases.  The
  404.            path and filename are specified the same as on the /CFG:
  405.            option. (See also: FileName=)
  406.  
  407.     /Nxx   This option tells TGFL to list new files ONLY.  This is useful
  408.            when you want to create a list of new files that have been added
  409.            to your system recently.  You may optionally add a number ranging
  410.            between 0 and 99 after the N to denote the number of days old
  411.            an upload is before it is considered new.  The default age
  412.            is 5 days. (See also: NewDays=)
  413.  
  414.     /O     This option tells TGFL to append an "Overall Totals" area to
  415.            the bottom of the list with the total number of files and bytes
  416.            is all areas listed. (See also: OverallStats=)
  417.  
  418.     /S     This option tells TGFL to add a "Status" line, under the file's
  419.            description telling wether or not the file is offline or online,
  420.            and if it is validated or not. (See also: FileStatus=)
  421.  
  422.     /TFxx  This option tells TGFL to include a list of the top xx overall
  423.            downloaded (i.e. most popular) files at the bottom of the output
  424.            list file. (See also: TopFiles= & MaxFiles=)
  425.  
  426.     /TI    This option tells TGFL to include the time of day next to the
  427.            date, if it is included (/D). (See also: UploadTime=)
  428.  
  429.     /TX    This option tells TGFL to make a basic text file which
  430.            contains no extended ASCII characters.  Very useful when
  431.            creating a list to be viewed on the www. (See also: BareText=)
  432.  
  433.             NOTE: This option does NOT filter ANY extended
  434.                   characters out of file descriptions.
  435.  
  436.     /U     This option tells TGFL to add the uploaders name to the list,
  437.            below the description. (See also: UploaderName=)
  438.  
  439.     /V     This option tells TGFL to NOT list files which are not validated
  440.            for download by the users yet. (See also: IgnoreUnvalidated=)
  441.  
  442.     NewName=  The NewName field has been added to the config file.
  443.               Due to the number of current command line parameters
  444.               I have not added one of this option.
  445.  
  446.               What this option is;
  447.  
  448.                 In the Telegard file editor, if you set the uploaders
  449.                 name to the same as this field, every time TGFL runs
  450.                 it will modify the files upload date, to the current
  451.                 date.  This will cause the file to always be listed
  452.                 as new.  This is useful for files that you really
  453.                 want people to download, since they will show up
  454.                 in the users newscan every time.  This is also great
  455.                 for file lists and the such, since they are always
  456.                 changing and are actually new.
  457.  
  458.  
  459.  
  460.  
  461.        Section 3.3      Config Files
  462.  
  463.     TGFL can optionally read a configuration file.  This file is a
  464.     simple ASCII (text) file containing a list of parameters for
  465.     the operation of TGFL.  This file can be extreemly helpful as
  466.     you can easily change settings without being forced to remember
  467.     a long and complicated command line.
  468.  
  469.     A config file is used by telling TGFL where it is.  Here is a
  470.     simple example;
  471.  
  472.                TGFL /CFG:TGFL.CFG
  473.                        or
  474.          TGFL /CFG:C:\BBS\TGFL\TGFL.CFG
  475.  
  476.     The file itself is layed out much like many other .cfg or .ini
  477.     files.  All lines starting with a simi-colon (;) are ignored,
  478.     as well as blank lines and lines containing text that is not
  479.     relivant.  Although, the more blank lines and lines containing
  480.     useless information there are the more time it will take TGFL
  481.     to read the file.
  482.  
  483.     An example file is proved in the SAMPLES.ZIP archive, it is
  484.     named TGFL.CFG.  Each possible option is listed in the file
  485.     and can be changed with ease.  There is also an easy reference
  486.     to the options in the Command Line Options section.  Each
  487.     command line option has a config file option as well.
  488.  
  489.  
  490.  
  491.        Section 3.4      Include/Exclude Files
  492.  
  493.     This section will explain the use of Include and Exclude files
  494.     with TGFL.
  495.  
  496.     Both of these files are layed out in the same format, the are
  497.     simple ASCII (text) file which contain a file name on each line
  498.     of the file.  The file names are the names of the data files
  499.     for each file area (base).  These names can be found from the
  500.     file bases editor within Telegard.  By default Telegard comes
  501.     packaged with two file areas.  These areas are the Sysop area
  502.     and the General Files area.  Thier default file names are SYSOP
  503.     and GENERAL.
  504.  
  505.     If you wanted to exclude your sysop area (which is strongly
  506.     suggested) from you over file list, you would use either an
  507.     exclude or include file to do so.  If you wanted to ONLY
  508.     exclude the sysop file area and to allow all other file areas
  509.     to be processed you would put the sysop area in the exclude
  510.     list and tell TGFL the filename of the exclude list so it
  511.     will use it.
  512.  
  513.     Both the include and exclude lists can contain a maximum of
  514.     1,000 areas each.  Both files may also be used at the same
  515.     time if you want, although the exclude file is processed
  516.     AFTER the include file, so if you added a base in the
  517.     include file to be processed and also listed it in the
  518.     exclude file as well, it would not be processed.
  519.  
  520.  
  521.  
  522.        Section 3.5      Header/Footer Files
  523.  
  524.     TGFL also has the option to use header and footer files.  The
  525.     format of these files varies depending on which ones they are.
  526.  
  527.     The normal header and footer files are plain ASCII, as well as
  528.     the IDX header and footer files.  The HTM header and footer
  529.     files are in HTML (Hyper Text Markup Language) format.
  530.  
  531.     When you create either a main list, idx files or htm files and
  532.     tell TGFL to use headers/footers it will add the information
  533.     contained in those files to the desired output files.
  534.  
  535.     These files can be used to contain extended information about
  536.     the files and the BBS system.  Examples of all of the files
  537.     are provided in the SAMPLES.ZIP archive included with TGFL.
  538.  
  539.     You may also use MCI code to provided up to date information
  540.     about the system within these files.  Check the MCI Codes
  541.     section for deatiled information about what MCI codes are
  542.     availible and how to use them.
  543.  
  544.  
  545.  
  546.        Section 3.6      MCI Codes
  547.    
  548.     TGFL will translate several MCI codes which can be put in any
  549.     of the header or footer files.  To use these codes, simply place
  550.     them in the header/footer file where you desire the information
  551.     to be placed.
  552.  
  553.        System Information
  554.        ~SA     System Name
  555.        ~SB     System Location
  556.        ~SF     System Phone #
  557.        ~SV     Telegard Version
  558.        ~FB     File Base Name
  559.  
  560.        Time/Date Information
  561.        ~DL     Day Name (Long)
  562.        ~DN     Abbreviated Day Name
  563.        ~DY     Day of month
  564.        ~DZ     Day of month (Leading Zero)
  565.        ~HR     Hour (1-12)
  566.        ~HZ     Hour (Leading Zero / 0-23)
  567.        ~MI     Minute (Leading Zero)
  568.        ~ML     Month Name (Long)
  569.        ~MN     Month Number (Leading Zero)
  570.        ~MS     Month Name (Short)
  571.        ~SC     Second (Leading Zero)
  572.        ~TP     PM/AM
  573.        ~YR     Year (xx)
  574.        ~YL     Year (xxxx)
  575.  
  576.  
  577.  
  578.        Section 4.0    Additional Product Information
  579.  
  580.     This section contains additional information about TGFL, the
  581.     people that have helped produce it and many other things.  If
  582.     you like TGFL, please take the time to read this section so
  583.     you can better understand the people that have worked on this
  584.     project and possible take a chance to send them a message to
  585.     say thanks for their help.
  586.  
  587.  
  588.  
  589.        Section 4.1      Product Revisions/Changes
  590.  
  591.             + Added     * Changed/Fixed   - Removed     ! Notes
  592.  
  593.  
  594.  
  595.                               v1.00
  596.  
  597.             ! First version.
  598.  
  599.  
  600.                               v1.10
  601.  
  602.             + Added the /N command line parameter.  This
  603.               tells TGFL to list new files ONLY.
  604.             + Added some TG version checking code.
  605.             + Added file list totals on the screen, now
  606.               list total number of files and areas scanned
  607.               including time (number of seconds) that it
  608.               took to create the list.
  609.             + Added Color Code Filtering (Both `xx and |xx)
  610.               in file descriptions as well as area names.
  611.             + Now also translates TG color codes in the area
  612.               descriptions (on local display while processing).
  613.             + Added checking for the "TELEGARD=" environment
  614.               variable.  If found, it is used to find the
  615.               CONFIG.TG file if one does not exist in the
  616.               directory that TGFL is in.
  617.             + Added (/O) Overall Totals option.
  618.             * Spruced things up so they look a little better.
  619.               Added some color and such.
  620.             * Fixed bug which caused files to not be listed
  621.               if there was no description.
  622.             * You can now use the "-" delimiter as well as "/"
  623.               for command line options.
  624.             * Fixed bug which caused the ignore list not to work
  625.               properly. (Causes by a last minute change, sorry
  626.               folks.)
  627.             * The "/ver" command line option is no longer case
  628.               sensitive.
  629.  
  630.  
  631.                               v1.11
  632.  
  633.             * Now filters the display of empty file bases.
  634.             * Description are now seperated with a CR/LF
  635.               instead of just a CR.  (Thanks Lars)
  636.             * Now excepts command line like;
  637.               (TGFL FILES.LST /#/d/o) with no spaces
  638.               between the options.
  639.             ! Minor bug fix over 1.10, which most folks
  640.               never saw.
  641.             ! TGFL currently chops the file descriptions at 45
  642.               characters MAX.  I'll see what I can do about
  643.               this in the future.
  644.  
  645.  
  646.                               v1.20
  647.  
  648.             + Added /TX option, which produces a simplified
  649.               ascii file similar to a FILES.BBS file.
  650.             + Added status bars.
  651.             * Now supports over 2gigs of files in listing.
  652.               (limit should now be roughly 2,147 gigs)
  653.             * Help screen is now displayed if no command line
  654.               is passed.
  655.             * Changed the local display around again.  ;}
  656.             * Blank line between descriptions is now optional
  657.               via the /B command line option.
  658.             * Filenames can now optionally have the spaces removed
  659.               to be more friendly to things like TimEd.
  660.             * The /T command line has been changed to /TI.
  661.             * You may now, optionally, specify the number of
  662.               days old a file needs to be to be considered
  663.               new.  Days range from 1 to 10.
  664.             * Fixed bug which caused the description to be
  665.               separated by a spare line if the extended
  666.               file stats were included.
  667.             * Re-wrote unix date code with some help from
  668.               SWAG donators.
  669.             * Fixed Pentium II (200mhz+) bug.
  670.             * Fixed bug which caused TG not to find .FA/.FAD
  671.               files if they were in a path other than the
  672.               default file path.
  673.  
  674.  
  675.                               v1.21
  676.  
  677.             * Fixed minor output bug which put the wrong title
  678.               line above the file area stats on a text list
  679.               when the overall totals were added.
  680.             * I did some work on the description reading
  681.               code.  All tests I have done show it to be
  682.               only slightly faster, but, it should be
  683.               more stable now.
  684.             * Fixed bug that caused TGFL to freeze up some
  685.               times if a description ended in a color code.
  686.               IE (Whatever`70) but not (Whatever`70{CR}{LF}).
  687.  
  688.  
  689.                               v1.30
  690.  
  691.             + Added a config file.
  692.             + Added top files (downloads) list.  (/TF)
  693.             + Added the include/exclude/header/footer file
  694.               names to the main screen so you know which ones
  695.               TGFL is using.
  696.             + TGFL now checks the environment for BBS= as well
  697.               as TELEGARD= in order to find the CONFIG.TG.
  698.             - Removed the default search for the exclude file.
  699.               This file must now either be specified on the
  700.               command line or via the config file.
  701.             * Fixed bug which removed the spaces from
  702.               file base headers in TEXT (/TX) mode.
  703.             * Removed the odd number from the local display
  704.               when TGFL was finished.  My appologies, it was
  705.               some debug code.
  706.             * Fixed bug which caused some descriptions (actually
  707.               most) to be ended with a blank line.  This was
  708.               caused by the new description reading code.
  709.             * The output file name on the command line has been
  710.               changed, it is no longer the first parameter, it
  711.               must now be specified via a command line switch.
  712.               This was done because of the command line changes
  713.               for the new config file.
  714.             * Worked on the error checking code some.  Fixed one
  715.               bug and made some changes to make it easier to know
  716.               what happened.
  717.             * Fixed visual bug which caused the name of the file
  718.               being processed to be right justified instead of
  719.               left justified if the filter spaces option is used.
  720.             - Removed the default search for the TGFL.HDR and
  721.               TGFL.FTR files, they are now passed via the command
  722.               line or config file.
  723.  
  724.  
  725.                               v1.40
  726.  
  727.             + Added code to check for OS version information,
  728.               which is now displayed near the top of the screen.
  729.               The main part of this code was donated by Tim Strike.
  730.               It will search and find OS2 v2.00+, DESQView v2.00+,
  731.               Windows v3.00+ (Including 95/98/NT) and MS-DOS
  732.               versions.  If TGFL finds OS2/DV/WIN it will release
  733.               time slices (one between each file area).
  734.  
  735.             + Added ability to translate some MCI codes in all header
  736.               & footer files.  Look at TGFL.DOC for a list of them.
  737.               At this time there are no justifing type MCI codes, I'll
  738.               likely add this later, I wanted to see if they MCI's are
  739.               going to work out and be useful first.
  740.  
  741.             + Added ability to create 00index.txt/00_index.txt files
  742.               in each file directory.
  743.  
  744.             + Added ability to create files.bbs files in each file
  745.               directory.  Four different formats are supported.
  746.               Special thanks to Jeff Irvine for his work on
  747.               TG2FBBS.EXE that helped me figure out the different
  748.               formats.
  749.  
  750.             + Added ability to create index.htm files in each
  751.               directory, these html files also have a link to the
  752.               file, for easy downloading.
  753.  
  754.             * Fixed minor bug, TGFL was NOT filtering the colors from
  755.               the base names unless you used TEXT output.  Sorry about
  756.               that.
  757.  
  758.             * Fixed old bug which was causing TGFL not to search
  759.               the environment for the "BBS=" variable.
  760.  
  761.             * Switched over to Tim Strike's time/date code for
  762.               handling the unix timestamps.
  763.  
  764.             * Changed the top files code around, thanks for the code
  765.               suggestions Ken.
  766.  
  767.             * TGFL is no longer dependant on creating a single all
  768.               files list.  You now may choose only to create say the
  769.               FILES.BBS, unlike the first addition of the 00index.txt
  770.               code where it was an add on.
  771.  
  772.             * Fixed bug which caused TGFL to error out if the config
  773.               file you specified did not exist.
  774.  
  775.             * The /B command line parameter has been changed to /BL to
  776.               make it easier to add te /BBSx command line parameter.
  777.  
  778.             * Fixed bug in the INI code which caused TGFL not to find
  779.               the number of days old a file is to be new.
  780.  
  781.             * Reworked the help screen, made it more user interactive.
  782.  
  783.             * Changed the error handling code output to be more screen
  784.               friendly, IE, it always puts all error messages in the
  785.               same color and in the same place now.
  786.  
  787.             * If only /CFG is used on the command line, the name
  788.               "TGFL.CFG" is assumed.
  789.  
  790.  
  791.  
  792.                               v1.50
  793.  
  794.             + Add MaxFiles= field to the config file, this field
  795.               specifies the number of files you would like included
  796.               in the top files list if it is used.
  797.  
  798.             + Added NewName= to the config file.
  799.  
  800.             + Added an indicator on the main screen as to wether or not
  801.               a normal output list is being created.
  802.  
  803.             * The /TF (Top Files) command line parameter also now
  804.               allows you to specify a number between 1 and 99 for
  805.               the number of top files you with to be included in the list.
  806.  
  807.             * Changed the /Nx parameter to /Nxx, so you can now specify
  808.               up to 99 days for new files.
  809.  
  810.             * Fixed bug which caused the new file parameter (/N) to stick
  811.               on 5 days no matter what you told it.
  812.  
  813.             * Fixed some visual bugs on the advanced help screen.
  814.  
  815.             * Fixed a spelling error on the main screen.
  816.  
  817.             * Switched from Doug Reynolds color code unit to my own code
  818.               for pipe code translation.  This is to resolve some bugs in
  819.               Doug's unit and for added speed.
  820.  
  821.             * Worked on the error handling some, added some message to
  822.               help explain what the error was.
  823.  
  824.             ! Started changing some of the code so I can compile an
  825.               OS2 native version.  Mostly small changes, no differences
  826.               should be noticed.
  827.  
  828.  
  829.  
  830.  
  831.        Section 4.2      Product Coders and Testers
  832.  
  833.     Coders that have helped and how;
  834.  
  835.          David Stumpf  - TGFL main author.
  836.          Tim Strike    - Proveded a lot of code ideas as
  837.                          well as the majority of the
  838.                          multitasker code.
  839.          Ken Reaverson - Helped write the top files code
  840.                          and provided many other helpful
  841.                          suggestions.
  842.          Scott Adams   - Helped with a lot of code concepts
  843.                          and ideas.
  844.          Lars Hellsten - Helped with code concepts and ideas.
  845.  
  846.  
  847.     Product Testers
  848.  
  849.                    Name: David Stumpf
  850.                  Handle: KattManDo
  851.                   EMail: David.Stumpf@Earthling.net
  852.                   BBS #: 713-856-8048
  853.                     WEB: http://www.dzs.home.ml.org/
  854.                     ICQ: 3594353
  855.                  Duties: Main programmer and Alpha testing of
  856.                          all new additions.
  857.  
  858.                    Name: Ken Reaverson
  859.                  Handle: Forsaken
  860.                   EMail: tremere@mindless.com
  861.                   BBS #: 770-985-7396
  862.                     WEB: http://www.darktech.org/shadowdale/
  863.                     ICQ: 12241816
  864.                  Duties: Preform pre-release testing of software
  865.                          to insure bug free releases and help with
  866.                          code concepts.  Did the majority of the
  867.                          FILES.BBS testing and also provided the
  868.                          format information.
  869.  
  870.  
  871.  
  872.  
  873.        Section 4.3      Future Plans
  874.  
  875.     Currently TGFL supports all of the options that have been asked
  876.     for by poeple.  If you have any more suggestions for it, please
  877.     feel free to send your suggestions.
  878.  
  879.     The current plan is to keep updating TGFL as long as it has a
  880.     strong user base and people continue to make suggestions.  I
  881.     hope you stick around and keep up with the development of this
  882.     application as I hope it will be around and kicking for a long
  883.     time to come.
  884.  
  885.  
  886.  
  887.        Section 5.0    Acknowledgments
  888.  
  889.     Telegard is Copyrighted by Tim Strike
  890.     MS-DOS is Copyrighted by MircoSoft Inc.
  891.     Windows is Copyrighted by MircoSoft Inc.
  892.     OS2 is Copyrighted by Internation Business Machines
  893.     IBM is Trademarked by Internation Business Machines
  894.     TimEd is Copyright Gerard van Essen
  895.