home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / fixtitle.zip / fixtitle.doc < prev   
Text File  |  1995-01-11  |  5KB  |  121 lines
  1. FIXTITLE               A utility to reconcile OS/2 file names and titles
  2.  
  3. M. H. Prager                                               January, 1995
  4.  
  5.  
  6. ************************************************************************
  7. WARNING -- READ THIS BEFORE USING FIXTITLE
  8.  
  9. The program FIXTITLE is provided free of charge, AS IS, and with NO
  10. WARRANTY OF ANY KIND. The program has been used successfully under OS/2
  11. 2.1 and OS/2 Warp 3.0, but the author accepts NO RESPONSIBILITY for
  12. consequences of the use of this program, whether used in accordance with
  13. instructions or not. It is possible to cause SERIOUS SYSTEM DAMAGE if
  14. FIXTITLE is used to rename OS/2 system files or files stored by certain
  15. backup programs. DO NOT USE FIXTITLE UNLESS YOU ACCEPT THESE CONDITIONS.
  16. ************************************************************************
  17.  
  18.  
  19. Introduction
  20. ------------
  21.  
  22. FIXTITLE is a REXX program to address a peculiar bug in IBM's OS/2
  23. operating system. To explain FIXTITLE, it is necessary to explain a bit
  24. about OS/2's filesystems. The explanation that follows is derived from
  25. my observations about how OS/2 works, and I may have missed some
  26. subtleties; however, it is correct for the present purpose.
  27.  
  28. In OS/2 (unlike DOS), all files can have two names: the physical file
  29. name ("filename") and the longname extended attribute ("longname"). This
  30. allows files on FAT volumes to be displayed with long names by the WPS,
  31. but it can cause confusion when the two names are different. EVERY file
  32. has a filename, but not every file has a longname.
  33.  
  34. When a directory (synonymous with "folder") is displayed in OS/2's
  35. workplace shell, the title displayed under the icon is the longname if
  36. one exists; otherwise, the filename is displayed. If the icon title is
  37. edited by the user, and the file is on an HPFS volume, the new name is
  38. stored as BOTH longname and filename. This is true on a FAT volume if
  39. the new name meets the 8.3 requirement; if not, a contracted version is
  40. used for the filename.
  41.  
  42. In contrast, when files are renamed through the command line, OS/2
  43. changes ONLY the filename, and NOT the longname. This doesn't matter if
  44. the file has no longname; but if the filename has ever been changed
  45. through the WPS, the file WILL have a longname. As a result, the same
  46. file could be called "Bill" as part of a DIR listing and "Newt" when
  47. viewed as an icon. For users who use both the command line and the WPS
  48. to manage files, this situation is intolerable.
  49.  
  50.  
  51. FIXTITLE to the Rescue
  52. ----------------------
  53.  
  54. FIXTITLE is a command-line utility that lets the user identify files
  55. with longnames different from their filenames and and optionally change
  56. the longnames to match the filenames. To use FIXTITLE, you must have
  57. installed Rexx when you installed OS/2.
  58.  
  59. To install FIXTITLE, copy FIXTITLE.CMD to a directory on your OS/2 PATH.
  60.  
  61. FIXTITLE can then be invoked with the following syntax:
  62.  
  63.    fixtitle [filename] [-[option...]]
  64.  
  65.    where the available  options are:
  66.  
  67.    H or ?   Prints a short help message
  68.    S        Processes all subdirectories
  69.    N        Doesn't rename - just lists files with nonmatching titles
  70.  
  71.  
  72. Examples
  73. --------
  74.  
  75.    fixtitle * -s
  76.  
  77. will process all files in all subdirectories of the present directory. That
  78. means that it will print out each file with unmatched names and ask if you
  79. want to match the longname to the filename.
  80.  
  81.    fixtitle -ns
  82.  
  83. will list all files with unmatched names in all subdirectories of the
  84. present directory.
  85.  
  86.  
  87. Notes
  88. -----
  89.  
  90. 1. FIXTITLE never changes a longname without your permission. This is
  91. done for reasons of safety. Those familiar with REXX can modify the
  92. source to add an unprompted option, but this is NOT RECOMMENDED.
  93.  
  94. 2. FIXTITLE changes the longname immediately, but for some reason,
  95. the WPS does not display the new name immediately. It seems to require
  96. either opening the Settings Notebook for the file or rebooting OS/2
  97. to display the new name.
  98.  
  99. 3. You can cause SERIOUS DAMAGE to your OS/2 installation by telling
  100. FIXTITLE to rename OS/2 system files. Don't do it!
  101.  
  102. 4. The options are not case-sensitive. The default filename is '*'.
  103.  
  104. 5. Because the command line does not change the longname directly, and
  105. the WPS changes BOTH longname and filename, FIXTITLE always modifies the
  106. longname to match the filename. (If you want to change the filename, you
  107. can do so directly from the command line or from the WPS). FIXTITLE is
  108. most useful after you have renamed files from the command line, to make
  109. sure you will see the new filenames when viewing the directory with the WPS.
  110.  
  111. 6. I will endeavor to make corrections to FIXTITLE if you let me know of
  112. any problems. You can contact me at the following addresses:
  113.  
  114.    Compuserve:   72050,3220
  115.    Internet:     72050.3220@compuserve.com
  116.  
  117. Please also let me know if you like the program.
  118.  
  119. Mike Prager
  120. January 11, 1995
  121.