home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / PWABAL16.ZIP / AREA.DOC < prev    next >
Text File  |  1995-10-23  |  7KB  |  152 lines
  1.  
  2. <«─----──-───--────-------──────--─────-------──────---────-------────----──»>
  3.   ░▒▓██████████████▓▒░│ [PWA] FILE AREA LISTER v1.6 │░▒▓█████████████████▓▒░
  4. <«─------──---──-────────-------------───---───-─────----------──--──---───-»>
  5.  
  6.                             (C) BlackCat 1995
  7.  
  8. <«─----──-───--────-------──────--─────-------──────---────-------────----──»>
  9.  
  10.    This is a lightbar driven file area lister. Initially this was only a PPE 
  11.    that read  the conference information and showed a  simple file area menu. 
  12.    But I wanted a better menu with file/byte totals  and since I had coded a 
  13.    directory menu creator I decided to combine the two. Here's the result and 
  14.    I think you may like it ;)
  15.         
  16. <«─----──-───--────-------──────--─────-------──────---────-------────----──»>
  17.   ░▒▓█▓▒░│ INSTALLATION │░▒▓█████████████████████████████████████████████▓▒░
  18. <«─------──---──-────────-------------───---───-─────----------──--──---───-»>
  19.  
  20.  
  21.    ■ Make sure  that you've extracted  the zip with  the -d option (or if 
  22.      you're using any other program to extract this make sure you extract 
  23.      it so that empty directories in the zip are also created).
  24.  
  25.    ■ Edit DM.CFG and make sure the path to your conference (CNAMES.@@@) 
  26.      file is correct.
  27.  
  28.    ■ Run DM.EXE. This will generate the directory files in the DIRS 
  29.      directory with file/bytes summary information.
  30.  
  31.      To write a single directory in case of any problems or when you just
  32.      want to update a directory menu that you've changed use 'DM <number>',
  33.      which will only create the requested conference directory.
  34.  
  35.      The reason that DM.EXE does not overwrite your real directory files is
  36.      because the files created in DIRS contain no headers/footers (these 
  37.      are handled by the PPE, see below)
  38.  
  39.      You can put DM.EXE in a daily event to easily update your areas each
  40.      day.
  41.  
  42.    ■ Replace your 'F' command with AREA.PPE the following way and that 
  43.      should be it.
  44.  
  45.                1 - run PCBSETUP
  46.            2 - Press B B 
  47.            3 - Move to your CMD.LST file and press F2 to edit it.
  48.            4 - Enter 'F' as the command, the security you want and the 
  49.                full path and name of AREA.PPE.
  50.  
  51.  
  52. <«─----──-───--────-------──────--─────-------──────---────-------────----──»>
  53.   ░▒▓█▓▒░│ CONFIGURATION │░▒▓████████████████████████████████████████████▓▒░
  54. <«─------──---──-────────-------------───---───-─────----------──--──---───-»>
  55.     
  56.  
  57.    DM is totally configurable by the use of replacement codes in DM.CFG.
  58.    You can arrange the codes any way you like. You can even remove a code
  59.    with information you don't want/need. 
  60.  
  61.    The replacement codes allowed for a directory line in DM.CFG are:
  62.  
  63.            %NR%       - Directory number. (length 3)
  64.            %DESC%     - Directory description. (length 35)
  65.            %FILES_R%  - # of files in directory. (length 9)
  66.            %BYTES_R%  - # of bytes in directory. (length 15)
  67.  
  68.  
  69.    The following codes are also allowed in the menu display file (MENU) 
  70.    file. 
  71.  
  72.            %TOTF_R%   - Total number of files in conference directories.
  73.                         (length 9)
  74.            %TOTB_R%   - Total number of bytes in conference directories.
  75.                         (length 15)
  76.  
  77.    The '_R' in some codes above means right justification, use '_L' for
  78.    left justification.
  79.  
  80.    CFG2.ZIP contains an example of another codes/menu configuration,
  81.    try it and see if you like it. It's a metallic menu setup like seen
  82.    in so many other utils. After extracting CFG2.ZIP don't forget to 
  83.    run DM.EXE again, to create the new directory lines.
  84.  
  85.    The command line syntax for DM is:
  86.            
  87.                         DM [NR] [/v] [/r]
  88.  
  89.     NR = Conference to create directory menu for. Only the directory
  90.          menu for this conference is created. Without this option
  91.          the directory menus for ALL conferences are created.
  92.     /v = Verbose (for testing purposes).
  93.     /r = Check for REAL file existence when calculating directory
  94.          totals. Normally the values found in the directory files
  95.          are just added together without actually checking if the
  96.          files are on the disk. Using this option is slower but
  97.              also more accurate, so use it if the other method seems
  98.          to get it wrong.
  99.  
  100.  
  101.  
  102.    You can also configure the PPE to use conference specific files
  103.    by appending the conference number to any of the following files. 
  104.  
  105.         dm<nr>.cfg     - Conference specific DM.EXE configuration file.
  106.                          Note that only DM.CFG needs the conference file
  107.                          given (line 1), the other configuration specific
  108.                          DM<nr>.CFG files don't need this line.
  109.         area<nr>.cfg   - Conference specific area PPE config file.
  110.         graph\atxt<nr> - Conference specific text.
  111.         menu<nr>       - Conference specific menu file. Will be used
  112.                          by DM.EXE.
  113.  
  114.    Note that it is not needed to create each file for a conference,
  115.    if you just want to have another (color) layout for the dir lines
  116.    you can just add the appropriate dm<confnr>.cfg etc.
  117.  
  118.  
  119. <«─----──-───--────-------──────--─────-------──────---────-------────----──»>
  120.   ░▒▓█▓▒░│ AREA GROUPS │░▒▓██████████████████████████████████████████████▓▒░
  121. <«─------──---──-────────-------------───---───-─────----------──--──---───-»>
  122.  
  123.    As of version 1.4 area group support has been added. The PPE will
  124.    look for a file GRP<CONFNR>.CFG, where <CONFNR> is the current
  125.    conference number, and if found will use it as a group configuration
  126.    file for the current conference. If a conference specific file is not 
  127.    found but the GRP.CFG file exists it will be used as a default! 
  128.  
  129.    The display file used for the group menu is GRP<CONFNR> or a
  130.    default GRP file.
  131.    
  132.    The group configuration file lets you define area groups, see _grp2.cfg
  133.    as an example. The number of groups as well as areas per group is 
  134.    unlimited, but try to keep the numbering of the area listings in the
  135.    group configuration file as sequential as possible, this will keep the 
  136.    ppe as fast as possible.
  137.  
  138.    The file _grp2.cfg contains an example group configuration for conference
  139.    2. Copy the file to grp2.cfg and do a 'f' command in conference 2 to see
  140.    how it looks.
  141.  
  142.  
  143. <«─----──-───--────-------──────--─────-------──────---────-------────----──»>
  144.   ░▒▓█▓▒░│ AUTHOR │░▒▓███████████████████████████████████████████████████▓▒░
  145. <«─------──---──-────────-------------───---───-─────----------──--──---───-»>
  146.  
  147.    If you find any bugs or have any comments/suggestions or additions you
  148.    want you can mail me on internet at: an275793@anon.penet.fi (the old
  149.    anonymous address has become invalid).
  150.  
  151.    You can also get the newest versions of my utils at +31-365362117.
  152.