home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TLIST120.ZIP / TEZYLIST.DOC < prev    next >
Text File  |  1993-03-27  |  20KB  |  473 lines
  1.  
  2.  
  3.  
  4.  
  5.      ╓──╥──┐ ╥──┐ ╓─┐  ╥  ┬ ╥       ─╥─  ╓─┐ ╓─╥─┐
  6.         ║    ╟─   ╓─┘  ╙──┤ ║        ║   ╙─┐   ║
  7.         ║    ╨──┘ ╙──┘ ╙──┘ ║       ─╨─ ╙──┘   ╨    ╥  ┬    ─╖    ───┐ ╓──┐
  8.         ║                   ║                       ╙╖┌┘     ║    ╓──┘ ║  │
  9.         ╨                   ╨─────┘                  ╙┘  o  ─╨─ o ╙─── ╙──┘
  10.   ───────────────────────────────────────────────────────────────────────────
  11.             Filelist and Filearea Header generator for Ezycom 1.02
  12.                                                        ──────
  13.                  (TEzyList is copyright 1993 Thomas Holmström)
  14.  
  15.              (Manual written by Thomas Holmström and David Morris)
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38. ┌──────────────────────────────────────────────────────────────────────────────┐
  39. │ THF's Ezycom FileList Generator v1.20 - Copyright Thomas Holmström Frandzen  │
  40. └──────────────────────────────────────────────────────────────────────────────┘
  41.  
  42.  
  43.  
  44.    Table of Contents
  45.  
  46.      CONDITIONS OF USE....................................1
  47.      REGISTRATION.........................................1
  48.      COPYRIGHTS...........................................2
  49.      THANKS...............................................2
  50.      REQUIREMENTS.........................................3
  51.      INSTALLATION.........................................3
  52.      TZYSETUP - HOW DO I SET UP TEzyList..................4
  53.        Banner file........................................4
  54.        Output list filename...............................4
  55.        "New files" list name..............................5
  56.        Days in Newfiles...................................5
  57.        Top downloads list.................................5
  58.        Entries in list....................................5
  59.        Minimum Security Required..........................6
  60.        Filegroups Included................................6
  61.        Area Numbers.......................................6
  62.        Area Headers.......................................7
  63.      REMARKS ABOUT AREAS..................................7
  64.      TEzyList - HOW DO I USE THE MAIN PROGRAM.............7
  65.  
  66. ┌──────────────────────────────────────────────────────────────────────────────┐
  67. │ THF's Ezycom FileList Generator v1.20 - Copyright Thomas Holmström Frandzen  │
  68. └──────────────────────────────────────────────────────────────────────────────┘
  69.  
  70.                                                                       Page 1
  71.    CONDITIONS OF USE
  72.    -----------------
  73.  
  74.    * TEzyList is the copyrighted materials of Thomas Holmström Frandzen.
  75.      "TEzyList" refers to the executable files, the documentations and the key
  76.      files in the TEzyList package.
  77.  
  78.    * TEzyList is classified as ShareWare. That permits you to try out TEzyList
  79.      for 45 days. After that period you must either register TEzyList, or you
  80.      MUST stop using it.
  81.  
  82.    * TEzyList may NOT be used in any kind of illegal environment, including
  83.      BBS's that distributes cracked, or illegally altered programs on purpose.
  84.  
  85.    * In using this program, you agree that in no event shall Thomas H. Frandzen
  86.      be liable for any indirect, direct, incidental, consequential, special, or
  87.      exemplary damage or lost profits, even if Thomas H. Frandzen have been
  88.      advised of the possibility of such damages or lost profits. You further
  89.      agree that if for any reason Thomas H. Frandzen is found to be liable to
  90.      you as a result of your use of the program and software, that as partial
  91.      consideration of Thomas H. Frandzen granting you this license, you agree
  92.      that Thomas H. Frandzen, sole and exclusive cumulative liability to you
  93.      or others shall be no greater than the amount of any registration fee paid
  94.      by you. If no such registration fee was paid, then Thomas H. Frandzen shall
  95.      not be liable for any amount.
  96.  
  97.    * Thomas H. Frandzen is in no way obligated to provide support for the
  98.      current or any future versions of TEzyList.
  99.  
  100.    * Registration of TEzyList entitles you to the use of the current version of
  101.      TEzyList. Any future versions may have new conditions of use, which may
  102.      change the terms of your current licensing agreement.
  103.  
  104.    REGISTRATION
  105.    ------------
  106.  
  107.      Included with the TEzyList package, in the archive called REGISTER.ARJ is
  108.      REGISTER.TZY. It contains information on how to register, and it contains
  109.      also a registration form.
  110.  
  111.      If you live in Sweden or Finland use REGISTER.FIN instead.
  112.      If you live in United Kingdom use REGISTER.UK
  113.  
  114. ┌──────────────────────────────────────────────────────────────────────────────┐
  115. │ THF's Ezycom FileList Generator v1.20 - Copyright Thomas Holmström Frandzen  │
  116. └──────────────────────────────────────────────────────────────────────────────┘
  117.  
  118.                                                                       Page 2
  119.    COPYRIGHTS
  120.    ----------
  121.  
  122.    The following products are copyrighted to the following people or companies.
  123.  
  124.     DesqView          Quarterdeck Office Systems
  125.     Ezycom            Peter Davies
  126.     IBM               International Business Machines
  127.     MS-DOS            Microsoft
  128.     TEzyList          Thomas Holmström Frandzen
  129.     Turbo Pascal      Borland International
  130.  
  131.  
  132.    FidoNet is a registered trademark belonging to Tom Jennings
  133.  
  134.    THANKS
  135.    ------
  136.  
  137.    I would like to thank the following persons and companies, without whom
  138.    TEzyList wouldn't have been made.
  139.  
  140.  
  141.    My mother and father        For bringing me to this world
  142.    Borland International       For making Turbo Pascal
  143.  
  144.    Magnus Jacobsen,
  145.    Peter Grundl,
  146.    Flemming Engström
  147.    and Jan Meldtoft            For being my FidoNet uplinks & friends
  148.  
  149.    Peter Davies                For making Ezycom
  150.  
  151.    Lars Eriksson               For his great work in testing TEzyList
  152.    David Morris                For his many suggestions, and his
  153.                                manual-writing.
  154.  
  155.  
  156.  
  157.    The latest Version Of TEzyList Is Available From The Following BBS Sites:
  158.    ______________________________________________________________________
  159.  
  160.    THF's EzyBoard System (Authors board)
  161.    Speeds: V32bis/V42bis/ZYX
  162.    BBS-Number: +45-31-635330
  163.    SysOp: Thomas Holmström
  164.    FidoNet 2:234/127, EzyNet 150:4501/1
  165.  
  166.    Octopus BBS (UK Rego. site)
  167.    Speeds: V32bis/V42bis
  168.    BBS-Number: +44-706-874802
  169.    SysOp: David Morris
  170.    FidoNet 2:250/131, EzyNet 150:4401/1
  171.  
  172.    Sunny Island Ezycom System (Sweden & Finland Rego. site)
  173.    Speeds: V32bis/V42bis/HST
  174.    BBS-Number: +358-28-41992
  175.    SysOp: Lars Eriksson
  176.    FidoNet: 2:20/211, EzyNet 150:3581/1
  177.  
  178. ┌──────────────────────────────────────────────────────────────────────────────┐
  179. │ THF's Ezycom FileList Generator v1.20 - Copyright Thomas Holmström Frandzen  │
  180. └──────────────────────────────────────────────────────────────────────────────┘
  181.                                                                       Page 3
  182.    REQUIREMENTS
  183.    ------------
  184.  
  185.    In order to use TEzyList you need a PC-compatible computer, running under some
  186.    kind of MS-DOS compatible operative system. The system has also been tested
  187.    successfully in a DOS box under OS/2.0, in LILO under Linux 0.99 and            
  188.    running under Qemm 2.41 & DesqView 6.01.
  189.  
  190.    In order to use TEzyList in a sensible way, you must have an installed
  191.    version of Ezycom on your harddisk, and an environment variable called
  192.    EZY pointing to the directory where your Ezycom configuration files are
  193.    placed.
  194.  
  195.    INSTALLATION
  196.    ------------
  197.  
  198.    Unlike many other BBS related programs, TEzyList is easy to install.
  199.    Just do the following things:
  200.  
  201.      1. Unpack/move all the files in the TEzyList package to one single
  202.         directory. It doesn't matter if the directory isn't empty.
  203.  
  204.      2. You run the program called TZYSETUP (which should have been in the
  205.         TEzyList package). (See page 4 for the usage of TzySetup.)
  206.  
  207.      3. When you have made a/some usable configuration file(s), you are ready to
  208.         being to start TEzyList by following step 4, which is:
  209.  
  210.      4. Type TEzyList (followed by a parameter from the configuration file) on
  211.         the command line, and you should be running.
  212.  
  213. ┌──────────────────────────────────────────────────────────────────────────────┐
  214. │ THF's Ezycom FileList Generator v1.20 - Copyright Thomas Holmström Frandzen  │
  215. └──────────────────────────────────────────────────────────────────────────────┘
  216.                                                                       Page 4
  217.    TZYSETUP - HOW DO I SET UP TEzyList?
  218.    ------------------------------------
  219.  
  220.    In order to use TEzyList you need one (or more) configuration files. There's
  221.    one configuration file for each type of file-list you want. It might sound a
  222.    bit ridiculous, but it isn't. In fact that makes it much easier to make
  223.    several filelists.
  224.  
  225.    So, you start TZYSETUP with one parameter. The parameter is the letter or
  226.    number you want the configuration file you are about to make to be called.
  227.    Well, sort of - all configuration files are called TEzyList.CF? - the
  228.    parameter which you state replaces the ?.
  229.  
  230.    Example:-
  231.  
  232.      C:\EZY\TEzyList> TZYSETUP A
  233.  
  234.    Of course it doesn't matter what the path is named. So, the example will
  235.    make a configuration file called TEzyList.CFA - logic isn't it? You can make
  236.    as many different configuration files as possible from A to Z and 0 to 9.
  237.  
  238.    Okay, when you start TZYSETUP (with a parameter) you'll see a screen with a
  239.    window in the upper middle. The window is the place that keeps the
  240.    information. The highlighted (Purple) line is the one you're at, and you can
  241.    change lines by using the up/down arrows on the keypad. (Remember to set
  242.    Num Lock OFF) You don't have to press enter after each question. The line is
  243.    saved even if you use the arrow keys. You can get some help on each question
  244.    by pressing function key 1 (F1). You can save the final configuration file by
  245.    pressing Control (CTRL) and END (on the keypad) at the same time. Okay, let's
  246.    describe each question:
  247.  
  248.    Banner file: (optional)
  249.    ------------
  250.  
  251.    This is the name of an ASCII file, containing a header if that is what you
  252.    want. The file will then be placed first thing in the filelist. This may be
  253.    a BBS commercial and/or some additional information about your filebase.
  254.    Leave this field blank if you don't want any header in the filelist created
  255.    by this configuration.
  256.  
  257.    Example:-
  258.  
  259.    Banner file: C:\EZY\TXT\BBSAD.ASC
  260.  
  261.    This will place the file C:\EZY\TXT\BBSAD.ASC in the top of the filelist.
  262.  
  263.    Output list filename:
  264.    ---------------------
  265.  
  266.    This one is the name of the filelist created by the configuration you are
  267.    editing. In fact this is the only field you MUST write something in.
  268.  
  269.    Example:-
  270.  
  271.    Output list filename: C:\FREE\FILELIST\MYBBS.LST
  272.  
  273.    This example will write the output filelist to a file called:-
  274.    C:\FREE\FILELIST\MYBBS.LST.
  275. ┌──────────────────────────────────────────────────────────────────────────────┐
  276. │ THF's Ezycom FileList Generator v1.20 - Copyright Thomas Holmström Frandzen  │
  277. └──────────────────────────────────────────────────────────────────────────────┘
  278.                                                                       Page 5
  279.    TZYSETUP - HOW DO I SET UP TEzyList? (cont.)
  280.    ------------------------------------
  281.  
  282.    "New files" list name: (optional)
  283.    ----------------------
  284.    This is the name you want the "New Files" list to be called. This will write
  285.    all files which are less than ** days old, where ** is the number you defines
  286.    on the next line of the configuration (Days in Newfiles), to the filename
  287.    stated here. Just leave it blank if you don't want any "newfiles" list.
  288.  
  289.    Example:-
  290.  
  291.    "New files" list name: C:\FREE\FILELIST\MY30DAYS.LST
  292.  
  293.    The example will write the new-files list to a file called:-
  294.    C:\FREE\FILELIST\MY30DAYS.LST
  295.  
  296.    Days in Newfiles: (Optional) 
  297.    -----------------
  298.    This is the maximum number of days that a file may be to be included in the
  299.    Newfiles list. The name of the newfiles list is stated at the line above this
  300.    entry ("New Files" list name). Just leave blank, or type 0 if you don't want
  301.    any newfiles list.
  302.  
  303.    Example:-
  304.  
  305.    Days in Newfiles: 30
  306.  
  307.    The example will write all filenames which are less than 30 days old to the
  308.    newfiles list.
  309.  
  310.    Top downloads list: (Optional)
  311.    -------------------
  312.    This is the name you want the "Most Downloaded Files" list to be called.
  313.    This will write the ** most downloaded files to the filename stated here.
  314.    ** is a number from 1 to 99 which you define in the next line
  315.    (Entries in list).
  316.  
  317.    Example:-
  318.  
  319.    Top downloads list: \EZY\TXT\TOP15DL.ASC
  320.  
  321.    The example will write the ** most downloaded files to a file called
  322.    \EZY\TXT\TOP15DL.ASC
  323.  
  324.    Entries in list: (Optional)
  325.    ----------------
  326.    This is the number of files you want in the "Most Downloaded Files" list.
  327.    This can be anything from the one (1) most downloaded file, to the 100 most
  328.    downloaded files. Just type 0 if you don't want any "Most Downloaded" list.
  329.  
  330.    Example:-
  331.  
  332.    Entries in list: 15
  333.  
  334.    The example will write the 15 most downloaded files to the filename stated
  335.    on the line above this one (Top downloads list).
  336.  
  337. ┌──────────────────────────────────────────────────────────────────────────────┐
  338. │ THF's Ezycom FileList Generator v1.20 - Copyright Thomas Holmström Frandzen  │
  339. └──────────────────────────────────────────────────────────────────────────────┘
  340.                                                                       Page 6
  341.    TZYSETUP - HOW DO I SET UP TEzyList? (cont.)
  342.    ------------------------------------
  343.  
  344.    Minimum Security required.: (Optional)  (Also see page 6 "Remarks about areas")
  345.    -------------------------
  346.    Only file-areas which need this (or a lower) security level are included in   the 
  347.    file list. Just leave blank or type 65000 to ignore the security levels.
  348.  
  349.    Example:-
  350.  
  351.    Minimum Security required: 5
  352.  
  353.    The example will ignore all areas that needs a higher security level that 5.
  354.  
  355.    Minimum Security required.: (Optional)  (Also see page 6 "Remarks about areas")
  356.    -------------------------
  357.    Only file-areas which need this (or a lower) security level are included in
  358.    the file list. Just leave blank or type 65000 to ignore the security levels.
  359.  
  360.    Example:-
  361.  
  362.    Minimum Security required: 5
  363.  
  364.    The example will ignore all areas that needs a higher security level that 5.
  365.  
  366.  
  367.    Filegroups included: (Optional)  (Also see page 6 "Remarks about areas")
  368.    --------------------
  369.    Only filegroups stated here are included in the file list. Leave blank to
  370.    ignore file groups, and include all areas. Valid file-groups are letters from
  371.    A to Z and *
  372.  
  373.    Example:-
  374.  
  375.    Filegroups included: AOPD*
  376.  
  377.    The example will exclude all areas not in the filegroups A, O, P, D or *
  378.  
  379.    Area numbers:- (Optional)  (Also see "Remarks about areas" on this page)
  380.    -------------
  381.  
  382.    Only filegroups inside the area range stated here are included in the
  383.    filelist. You can write one single area (124) or area ranges (1-15). You can
  384.    not write multiple single area numbers like "124 200 234 235". Leave blank to
  385.    ignore area numbers.
  386.  
  387.    Example:-
  388.  
  389.    Area numbers: 50-75
  390.  
  391.    The example will exclude all areas below 50 and all areas above 75.
  392.  
  393. ┌──────────────────────────────────────────────────────────────────────────────┐
  394. │ THF's Ezycom FileList Generator v1.20 - Copyright Thomas Holmström Frandzen  │
  395. └──────────────────────────────────────────────────────────────────────────────┘
  396.                                                                       Page 7
  397.    
  398.    Area Headers:- (Optional - For Ezycom Fileareas Only, Not File Lists)
  399.    ---------------
  400.  
  401.    TEzyList will also now create filearea headers, these are filearea 
  402.    descriptions.
  403.  
  404.    Example:- TEzyList /HEADER /NOUPL
  405.  
  406.    Will tell TEzList produce the filearea headers only, without thanking the user
  407.    for uploading the best downloaded file. Where as :- TEzylist /HEADER would
  408.    produce the header, and also show the users name in the header of the best
  409.    downloaded file for that area. i.e.
  410.  
  411.     ---> This header was produced by: TEzyList v1.20 (C) Thomas Holmstrom <---
  412.   ┌──────────────────────────────────────────────┬─────────────────────────────┐
  413.   │ Area: Ezycom BBS Utilities                   │      Area number: 071       │
  414.   ├──────────────────────────────────────────────┴─────────────────────────────┤
  415.   │ Most popular file in this area (which was downloaded 3 times) is:          │
  416.   │ TLIST120.ARJ  24980  TEzyList v1.20. THE! Ezycom filelist generator        │
  417.   │ Thanks goes to Thomas Holmstrom for uploading this file                    │
  418.   ├────────────────────────────────────────────────────────────────────────────┤
  419.   │   Total files in area: 44                  Total size of files: 1624kb     │
  420.   └────────────────────────────────────────────────────────────────────────────┘
  421.  
  422.  
  423.    Example:- TEzyList 1 /HEADER
  424.  
  425.    Will tell TEzyList to produce the filearea headers for all fileares and the
  426.    filelists as defined in Tzysetup 1.
  427.  
  428.    Example:- TEzyList 1 
  429.  
  430.    Will tell TEzyList to produce the filelists defined in Tzysetup 1, and not
  431.    produce any filearea headers
  432.  
  433.    REMARKS ABOUT AREAS:
  434.    ---------------------
  435.  
  436.    File areas will only be included if it slips through all given conditions.
  437.    So, if you write "Minimum Security required.: 500", "Filegroups included: AD"
  438.    and "Area numbers: 4-99", only areas which fulfils all conditions (needs
  439.    security level 500 or below, are in filegroup A or D, and has an area number
  440.    between 4 and 99) and at the same time is stated as "Include in filelist"
  441.    (In the Ezycom configuration) are included in the filelist. Of course, you
  442.    can leave all fields blank if you want a list including all areas. The
  443.    "Special" list functions, like "newfiles" and "most downloaded files" is also
  444.    affected by the conditions stated in the configuration. 
  445.  
  446.    TEzyList - HOW DO I USE THE MAIN PROGRAM:
  447.    -----------------------------------------
  448.    
  449.    Well, this is in fact the easiest thing of all. You simply write TEzyList         
  450.    followed by the letter of the configuration file you wish to run. For example, if 
  451.    you have made a special configuration file called "E", which writes a list of all 
  452.    your Amiga areas (Could be Filegroups ABC in the range 50-90) then you type       
  453.    TEzyList E - if you've made a configuration file called "G" which should be       
  454.    generating a master list of all your file areas you write TEzyList G, and it is   
  455.    processing. Easy isn't it?
  456.  
  457.    Example:-
  458.  
  459.    C:\EZY\TEzyList> TEzyList E
  460.  
  461.    Will read the configuration file TEzyList.CFE, and make a file-list from the
  462.    information given by the configuration file.
  463.  
  464. ┌──────────────────────────────────────────────────────────────────────────────┐
  465. │ THF's Ezycom FileList Generator v1.20 - Copyright Thomas Holmström Frandzen  │
  466. └──────────────────────────────────────────────────────────────────────────────┘
  467.  
  468.    This version was publicly released on Saturday 27. March 1993
  469.  
  470. ┌──────────────────────────────────────────────────────────────────────────────┐
  471. │ THF's Ezycom FileList Generator v1.20 - Copyright Thomas Holmström Frandzen  │
  472. └──────────────────────────────────────────────────────────────────────────────┘
  473.