home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / srev13h.zip / SHOWDIR.DOC < prev    next >
Text File  |  1998-04-17  |  3KB  |  59 lines
  1. 15 Apr 1998
  2.                The SHOWDIR dynamic directory list processor
  3.  
  4. SRE-http's SHOWDIR.CMD is a front-end to the SHOWDIR dynamic directory
  5. list processor, a procedure  developed by Tim Tassonis for the GOHTTP filter.
  6. SHOWDIR is comparable to SRE-http's !DIR facility (and to the
  7. GETAFILE add-on), with a few nice tricks, such as the ability to extract the 
  8. contents of .ZIP files (a trick that GETAFILE now supports).
  9. This document briefly discusses how to use SHOWDIR.CMD in the SRE-http
  10. environment.
  11.  
  12. *) The first point is that, unlike !DIR, SHOWDIR does NOT work well
  13.    as a stand along "directory display" tool.  Although it is possible
  14.    to call it directly, it is best used to resolve "directory only"
  15.    URLS (that is, URL's that end with a /).
  16.  
  17. *)  SHOWDIR can use the contents of HTACCESS files
  18.     (i.e.; to dictate file exclusion).  Note that SHOWDIR will look for
  19.     an HTACCESS file even if you are NOT using HTACCESS for access control
  20.     (that is, even if DO_HTACCESS='NO') --  SHOWDIR merely extract the
  21.     "dynamic directory" variables from the HTACCESS file, and pays no
  22.     attention to the access control, redirection, and default index
  23.     parameters.   Of course, if there is no HTACCESS file specified
  24.     then SHOWDIR will not attempt to find one.
  25.  
  26. *)  Basically, the best way to use SHOWDIR is to include:
  27.         !SHOWDIR
  28.     in either the AUTO_NAME variable, or in the defaultindex parameter
  29.     in the HTACCESS file.  This is similar to the !CREATE option,
  30.     but instead of invoking !DIR, it invokes SHOWDIR.
  31.  
  32. *)  For more details on the use of HTACCESS files, see:
  33.       http://w3.ag.uiuc.edu/DLM/GoHTTP/Submissions/
  34.  
  35. *)  And most importantly, to obtain the SHOWDIR package, see:
  36.        http://w3.ag.uiuc.edu/DLM/GoHTTP/Submissions/tt/showdir.zip
  37.  
  38. *)  Note to GOHTTP mavens: the DIR.BUILDER parameter in HTACCESS files is
  39.     ignored by SRE-http.
  40.  
  41. *)  Hint: _Dir.Exclude or Dir.exclude HTACCESS parameter can be used 
  42.      to suppress display of sensitive files.  For example:
  43.          _DIR.EXCLUDE: filename.ext fes.htm *.gif pic86.htm filenam2.ext
  44.  
  45. *)  Hint: the Dir.Describe parameter can be used to provide file-by-file
  46.     descriptions.  For example:
  47.           Dir.Describe: descript.txt
  48.     The "descript.txt" file should have the form:
  49.         filename.1   a description
  50.         filename.2  a description
  51.     where filename.n should NOT contain path information.
  52.     Note that descript.txt file is only used for files in the same directory.
  53.     
  54. *)  CAUTION: The DIR.Info parameter (that display a header file) assumes
  55.     HTML code -- if you header file contains plain text, it will NOT
  56.     be formatted (it will be  displayed as one paragraph).
  57.  
  58.  
  59.