home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / dos_util / honto096.zip / HONTO.DOC < prev    next >
Text File  |  1993-09-03  |  8KB  |  179 lines
  1. Honto v0.96ß                                                            9/3/93
  2. (c) 1993 Sam Leventer
  3.  
  4. Description
  5. ~~~~~~~~~~~
  6.   Honto is a program that helps you identify an unknown filetype.  Its name
  7. comes from the Japanese word meaning really, or truely.  This is because
  8. Honto is not mislead by an incorrect extension; It tells you what a file
  9. really is.  Honto colors a file's listing, depending on its type, tells you
  10. what type of file it is, and optionally displays extra information.
  11.  
  12.   One situation where you might need a program like this is if you have a
  13. large number of backup files, all with the extension .BAK, some created with
  14. PKLite, some with GIFLite, others backups from your paint program, other
  15. backups from your word processor, etc... and you need to restore these
  16. backups.  Rather than going through a trial and error process in each program,
  17. you can simply type HONTO *.BAK, and find out what each file is.  Or, if a
  18. file comes with a couple WHATEVER.000, WHATEVER.001, etc..., and you are
  19. curious as to what type of files those are, simply type HONTO *.0*.
  20.  
  21.   Another usage of Honto would be as replacement for the DIR command.  Honto
  22. is designed to look identical to the DIR command, except for including extra
  23. information on the right side of the screen, and coloring files depending on
  24. their filetype.  Keep in mind that Honto differs from the DIR command in that
  25. it must be passed *.* to display all files.  If you do not specify a fileset,
  26. Honto will display its help screen.  Also, Honto currently does not handle
  27. relative paths (ie ..\backups\*.bak), so you must specify the complete path.
  28. Honto also differs from DIR in that directories are not listed, as they are
  29. not really files.
  30.  
  31.   If a file has an extension that Honto recognizes as not matching the
  32. standard extension for that filetype, such as if a ZIP file has been renamed
  33. to .QWK, then the file's current extension will be displayed in lower case.
  34. This will draw your attention to files with incorrect extensions.  The correct
  35. file description will still appear beside the directory listing.
  36.  
  37.   Honto displays files in different colors depending on the type of file that
  38. it is.  The following chart shows the colors:
  39.  
  40.                         Archives....... Bright Blue
  41.                         Programming.... Dark Blue
  42.                         Pictures....... Red
  43.                         Sound.......... Magenta
  44.                         Executables.... White
  45.                         Text........... Gray
  46.                         Unknown files.. Gray
  47.  
  48.   This grouping was done so that you could easily pick out related files.
  49.  
  50.  
  51. Command line switches
  52. ~~~~~~~~~~~~~~~~~~~~~
  53.   If you specify /E, for extra, then (with certain types of files), Honto will
  54. give you extra information.  The chart below shows which filetypes contain
  55. extra information.  I tried to come to a reasonable trade-off between amount
  56. of information and time to retrieve it.  Specifying /E should not slow Honto
  57. down unreasonably, except in the case of new GIFs.  The GIF 89a format is
  58. very flexible, and to find comments and application blocks, almost the whole
  59. file must be scanned.
  60.   Normally, direct screen writes are used, for color support.  However, if you
  61. need to re-direct the output, direct screen writes will not work.  To solve
  62. this problem, use /B, for Black and white output. If you have speech software,
  63. or other specialty software that needs to trap information being written to
  64. the screen, it will be able to trap output when /B is used.
  65.   Specifying /P will pause the screen every time it fills up.  This way you
  66. can easily view large directorys, without keeping your finger on the pause
  67. key.  (Note that ^S will not pause the display, unless /B is used)
  68.   Command line switches do not actually need to be preceded by a '/' or '-',
  69. but you may include those switch characters if you want to, since most other
  70. programs require them.  Also, a space may be put between options, if you wish.
  71.   The following are all CORRECT uses of Honto:
  72.  
  73. HONTO C:\GIFS\*.GIF /EPB
  74. HONTO D:\DOWNLOAD\*.* E B
  75. HONTO ..\*.bak -p
  76. HONTO *.0* -p /E
  77. HONTO *.* EP
  78.  
  79.   The following are INCORRECT uses of Honto:
  80.  
  81. HONTO /E *.*
  82. HONTO /P
  83. HONTO *.GIF *.PCX /E            ; Note: This format will be supported soon
  84.  
  85. Notes
  86. ~~~~~
  87.   Note: For some file types, there is no reliable way to identify files.  This
  88. shows nothing but a lack of foresight by the designer of the file format.  For
  89. example, Amiga modules (music files) have no ID information whatsoever.  There
  90. is no quick way to identify the file as a .MOD, and I felt that speed was more
  91. important than searching the file for correct sample information.  For some
  92. other file types, notably .COM files, the detection is not too reliable.  In
  93. general, if Honto says "probably", it means just that.
  94.  
  95.  
  96. Beta Note
  97. ~~~~~~~~~
  98.   ßeta Note: This version .96, is the first version of Honto that I am
  99. releasing to the public.  It has now been tested reasonably, and works in
  100. every situation that I can construct.  In a very few cases, mostly involving
  101. files smaller than 16 bytes, it may still abort with a run-time error.  The
  102. full release version will be made more "bullet-proof."
  103.   As I do not run windows, OS/2 or any extended OS, I have been able to fully
  104. test the extended .EXE information on windows or OS/2 executables.  If you
  105. run OS/2 or windows, please let me know of any problems/inconsistencies with
  106. extra information on executables.
  107.   If you notice any problems / run-time errors, please notify me of them.
  108. This software can only be improved with YOUR feedback.
  109.  
  110.  
  111. Registration
  112. ~~~~~~~~~~~~
  113.   Since this version is only a Beta, payment is not required for the Beta
  114. period.  What this means is that you may use this software without paying,
  115. ONLY until version 1.00 is released.  Since you may not know if version 1.00
  116. has come out, this version may also be legally used only until January 1st,
  117. 1994.  However, I would still appreciate it if you let me know that you are
  118. evaluating this software, either by sending a postcard to my address, or by
  119. sending netmail to me.  Once version 1.00 comes out, you MUST pay for
  120. continued use of the software.
  121.  
  122.  
  123. Copyrights
  124. ~~~~~~~~~~
  125.   All program code and data, including this Documentation file, are
  126. copyrighted 1993 by Sam Leventer.
  127.   GIF is a trademark of Compu$erve, an H&R Block company.
  128.   PC Paintbrush is a trademark of Z-Soft, Inc.
  129.   Turbo Pascal is a trademark of Borland International.
  130.   PKZip is a trademark of PKWare.
  131.   Word Perfect is a trademark of the Word Perfect Corp.
  132.   ARJ is copyright R.K. Jung.
  133.  
  134.  
  135. Contacting Me
  136. ~~~~~~~~~~~~~
  137.  
  138. Snail mail:
  139.   Sam Leventer
  140.   42 Oakdale Dr.
  141.   Rochester, NY 14618-1120
  142.  
  143. E-Mail:
  144.    FidoNet-  1:2613/313 (Knight Moves)
  145.    Internet- sam.leventer.f1.z2613.n313@fidonet.org
  146.  
  147.  
  148. Current list of files Honto can Identify
  149. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  150. Extra       Versions that
  151. info  ext   Honto knows
  152. ----  ---   -------------
  153.   X   ZIP : All versions
  154.   X   ARJ : All versions
  155.       ARC : All versions
  156.  
  157.   X   TPU : Turbo Pascal v4.0-7.0 (all)
  158.       OVR : All versions I could find
  159.       OBJ : Microsoft/Intel format
  160.  
  161.   X   WPD : Word Perfect 5.x only
  162.       WRD : Word v5.5
  163.       TXT : N/A
  164.       PAS : Programs & units
  165.       C   : N/A
  166.  
  167.       ANS : N/A
  168.   X   PCX : All versions
  169.   X   GIF : All versions
  170.   X   BMP : All versions
  171.  
  172.   X   WAV : N/A
  173.   X   VOC : N/A
  174.  
  175.   X   EXE : N/A
  176.       COM : Most .COM files I could find
  177.       SYS : Most .SYS files I could find
  178.  
  179.