home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / dirmap10.zip / dirmap.txt < prev   
Text File  |  1998-08-12  |  4KB  |  120 lines
  1. CONTENTS
  2.  
  3. # PURPOSE OF THIS PROGRAM
  4. # PREREQUISITES
  5. # USER SETUP
  6. # CALLING SYNTAX
  7. # PROGRAM OUTPUT
  8. # DISCLAIMER AND CREDITS
  9. # BUG REPORT, COMMENTS ETC.
  10.  
  11.  
  12. # PURPOSE OF THIS PROGRAM
  13.  
  14. The purpose of this program is to automatically compile directory
  15. overviews into one or more HTML files which then can be viewed with a
  16. browser.
  17.  
  18. It can be used to compile any directory overviews, but was primarily
  19. written to get a more or less comfortable overview of the ever growing
  20. number of HTML files which find their way on the local hard disk these
  21. days.
  22.  
  23. When HTML files are found the program will extract the document title
  24. and display it in the overview. This is especially useful when you
  25. have to deal with cryptic filenames which will not let you get any
  26. idea of the contents of the document itself.
  27.  
  28. If you are using the Netscape browser the program will make use of
  29. Javascript for extended information about the files found like file
  30. size, file date etc.
  31.  
  32.  
  33. # PREREQUISITES
  34.  
  35. You should have OS/2 and classic REXX installed.
  36.  
  37. # USER SETUP
  38.  
  39. None.
  40.  
  41.  
  42. # CALLING SYNTAX
  43.  
  44. The calling syntax will be also shown to you if you call the program
  45. without any commandline arguments.
  46.  
  47.  
  48. dirmap [/a /1 /2 /3 /n<map.htm> /-<def...>] <filemask> [...]
  49.  
  50.   /a: scan all disk drives
  51.   /1: one HTML page for all files (default)
  52.   /2: one HTML page per drive
  53.   /3: one HTML page per directory
  54.   /n: name of root page (default: dirmap.htm)
  55.   /-: drives to be excluded
  56.  
  57. Examples:
  58.  
  59. dirmap c:\netscape\cache\*.*htm? g:\hypertxt\html\*.*
  60.  
  61. => Compile an overview for the two directories given and
  62.    put it on one page, the root page. Look for HTML files
  63.    only in the first directory and for all files in the 
  64.    second directory given.
  65.  
  66. dirmap /a /3 /-ij *.*htm? *.gif *.jp*g
  67.  
  68. => Compile an overview for all disk drives, but exclude drive
  69.    i: and drive j:. Look for HTML, GIF and JPEG files and make
  70.    one HTML page for every directory.
  71.  
  72.  
  73. # PROGRAM OUTPUT
  74.  
  75. The program output depends on which commandline arguments are used and
  76. can get huge. It's a good idea to call the program in an empty
  77. directory especially when you plan to use commandline argument /3.
  78.  
  79. E.g. when I call the program with commandline argument /3 on my home
  80. PC it compiles 670 files resulting in approximately 4 megabytes.
  81.  
  82.  
  83. # DISCLAIMER AND CREDITS
  84.  
  85. This program is freeware. You may use it in any context, commercial
  86. or private. However I would appreciate if you send me an eMail if
  87. you use it and say hello.
  88.  
  89. This program comes without any warranty. The author shall not be helt
  90. responsible for any dammage you may suffer from using this program.
  91. PLEASE USE THIS PROGRAM AT YOUR OWN RISK.  You may freely use and
  92. modify it as long as these credits are kept.
  93.  
  94. I originally wanted to call this program 'dir2html', but found out
  95. that there already is a program out there with that name.
  96.  
  97. Thanks to Michel Plungjan <mplungjan@epo.nl> for testing this program
  98. under Windows NT. (It failed.)
  99.  
  100. I also sent this program out to some beta testers, but never heard of
  101. any of those again. It either means the program had no bugs or it
  102. didn't fit their needs and they threw it away ;-)
  103.  
  104.  
  105. # BUG REPORT, COMMENTS ETC.
  106.  
  107. It would like to hear your comments, both positive and negative.  The
  108. program does a satisfying job as far as myself is concerned, so if you
  109. want it to be developed further, you should say so.
  110.  
  111. I can be reached at (and in that order please):
  112.  
  113. oheiabbd@zedat.fu-berlin.de
  114. o.heidelbach@telemail.berlinet.de
  115.  
  116. Please note: These addresses are for response to this program only.
  117. You may not send unsolicited commercial e-mail to these or legal
  118. action will be taken.
  119.  
  120.