home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / checkt.zip / README.DOC < prev    next >
Text File  |  1995-01-24  |  5KB  |  117 lines
  1. CheckTitle      A visual utility to reconcile OS/2 file names and titles
  2.  
  3. P. G. Mulrane                                             January,  1995
  4.  
  5. ************************************************************************
  6. Credit where credit is due:
  7. This program is based on the excellent command-line utility FIXTITLE.CMD
  8. by Mike Prager. Without access to the source of this utility, writing
  9. CheckTitle would have been a lot harder. I have also plagiarized his
  10. readme.doc fairly extensively in order to create this file. Thanks
  11. again Mike (Sources used with permission).
  12. ************************************************************************
  13. WARNING -- READ THIS BEFORE USING CheckTitle
  14.  
  15. The program CheckTitle is provided free of charge, AS IS, and with NO
  16. WARRANTY OF ANY KIND. The author accepts NO RESPONSIBILITY for
  17. consequences of the use of this program, whether used in accordance with
  18. instructions or not. It is possible to cause SERIOUS SYSTEM DAMAGE if
  19. CheckTitle is used to rename OS/2 system files or files stored by
  20. certain backup programs. DO NOT USE CheckTitle UNLESS YOU ACCEPT THESE
  21. CONDITIONS.
  22. ************************************************************************
  23.  
  24.  
  25. Introduction
  26. ------------
  27.  
  28. CheckTitle is a VX-Rexx program to address a peculiar bug in IBM's OS/2
  29. operating system. To explain CheckTitle, it is necessary to explain a bit
  30. about OS/2's filesystems. The explanation that follows is derived from
  31. my observations about how OS/2 works, and I may have missed some
  32. subtleties; however, it is correct for the present purpose.
  33.  
  34. In OS/2 (unlike DOS), all files can have two names: the physical file
  35. name ("filename") and the longname extended attribute ("longname"). This
  36. allows files on FAT volumes to be displayed with long names by the WPS,
  37. but it can cause confusion when the two names are different. EVERY file
  38. has a filename, but not every file has a longname.
  39.  
  40. When a directory (synonymous with "folder") is displayed in OS/2's
  41. workplace shell, the title displayed under the icon is the longname if
  42. one exists; otherwise, the filename is displayed. If the icon title is
  43. edited by the user, and the file is on an HPFS volume, the new name is
  44. stored as BOTH longname and filename. This is true on a FAT volume if
  45. the new name meets the 8.3 requirement; if not, a contracted version is
  46. used for the filename.
  47.  
  48. In contrast, when files are renamed through the command line, OS/2
  49. changes ONLY the filename, and NOT the longname. This doesn't matter if
  50. the file has no longname; but if the filename has ever been changed
  51. through the WPS, the file WILL have a longname. As a result, the same
  52. file could be called "Bill" as part of a DIR listing and "Newt" when
  53. viewed as an icon. For users who use both the command line and the WPS
  54. to manage files, this situation is intolerable.
  55.  
  56. Also if one copies files from the command line with XCOPY, you can
  57. create longname chaos:
  58. CD to a dir with a longname called for "\Newt" for example and
  59. xcopy *.* to "\Bill".
  60. Now you have two dirs with the longname "Newt" in your tree and
  61. icon views! Only in details view or at the command line can you see
  62. the difference! VERY DANGEROUS!
  63.  
  64. Another source of error is in copying the contents of one file to
  65. another with copy via the command line:
  66. A text file "Newt.TXT" (with longname) is copied over a file called
  67. "Bill.TXT" so: "COPY Newt.TXT Bill.TXT". Now "Bill.TXT" has the
  68. longname "Newt.TXT" i.e. in the WPS icon view you have two files
  69. with the same name!
  70.  
  71. CheckTitle to the Rescue
  72. ----------------------
  73.  
  74. CheckTitle is a visual utility that lets the user identify files
  75. with longnames different from their filenames and and optionally change
  76. the longnames to match the filenames. To use the supplied CheckTitle,
  77. EXE file you must have VROBJ.DLL version 2.0b or greater. For
  78. people owning VX-REXX the source is included.
  79.  
  80. To install CheckTitle, copy CHECKT.EXE to a directory on your OS/2
  81. PATH. Create a program object for it if you wish.
  82. Start Check Title. Fill in the source directory entry field e.g.:
  83. "C:\*.*" or "D:\*.C", select the appropriate case and subdir options.
  84. Start the check with the "Check" button. Any files matching the search
  85. criteria having unmatched longnames will be added to the listbox in
  86. the middle of the screen. After the search has been completed (sorry
  87. guys, no interrupt option yet). You can select one or more files for
  88. "cleaning", via the left mouse button and the ctrl key.
  89. Now click on "Clean", all selected files will have their longnames
  90. corrected. Now your done!
  91.  
  92. Notes
  93. -----
  94.  
  95. 1. CheckTitle never changes a longname without your permission. This is
  96. done for reasons of safety.
  97.  
  98. 2. CheckTitle changes the longname immediately, but for some reason,
  99. the WPS does not display the new name immediately. It seems to require
  100. either opening the Settings Notebook for the file or rebooting OS/2
  101. to display the new name.
  102.  
  103. 3. You can cause SERIOUS DAMAGE to your OS/2 installation by telling
  104. CheckTitle to rename OS/2 system files (the Desktop directory for
  105. example). Don't do it!
  106.  
  107. 4. I will endeavor to make corrections to CheckTitle if you let me know of
  108. any problems. You can contact me at the following addresses:
  109.  
  110.    Compuserve:   100276,3023
  111.    Internet:     100276,3023@compuserve.com
  112.  
  113. Please also let me know if you like the program.
  114.  
  115. Philip Mulrane
  116. January 25, 1995
  117.