home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / sosutl11.zip / chname.man < prev    next >
Text File  |  1993-08-21  |  2KB  |  61 lines
  1. ChName
  2.  
  3. Description
  4.  
  5.     Change long HPFS file names to FAT format  and  vice  versa.  Useful
  6.     when copying files to or from diskettes.
  7.  
  8. Usage
  9.  
  10.     [D:\] chname FILE ... [ /f /h /q ]
  11.  
  12.     /f  HPFS to FAT (default)
  13.     /h  FAT to HPFS (ie. reverse what was done with /f)
  14.     /q  Quiet mode
  15.  
  16.     ChName changes HPFS file names to FAT format or vice versa.
  17.  
  18.     When  changing  HPFS names to FAT, the program first tries simply to
  19.     truncate the name to the `????????.???'  mask.  Spaces are converted
  20.     to underlines, and the first and the last dot-separated part are put
  21.     together. For example,
  22.  
  23.         "What really happened to Baby Jane.txt.Z" -> WHAT_REA.Z
  24.  
  25.     If there already is a file with the same name, a part of the result-
  26.     ing  name  is  substituted with a number, eg. `WHAT_RE0.Z'.  Only as
  27.     many letters are substituted as necessary--first one number is tried
  28.     (0..9),  then two numbers  (00..99)  and so on.  Eventually a unique
  29.     file name is very probably found.
  30.  
  31.     The long HPFS file name is saved to the `.LONGNAME' extended attrib-
  32.     ute so that the name can later be restored with the `/h' switch, eg.
  33.  
  34.         WHAT_REA.Z -> "What really happened to Baby Jane.txt.Z"
  35.  
  36. Known Bugs
  37.  
  38.     Spaces in file names cannot be handled from the command line, so the
  39.     above example doesn't work like this:
  40.  
  41.         [D:\] chname "What really happened to Baby Jane.txt.Z"
  42.  
  43.     Because OS/2 seems to strip the quotes before the reach REXX, ChName
  44.     gives a list of silly messages about files not found:
  45.  
  46.         ChName v1.0: File 'What' not found
  47.         ChName v1.0: File 'really' not found
  48.         ...
  49.  
  50.     But spaces are still allowed in file names: you can, of course, use
  51.  
  52.         [D:\] chname *.txt.Z
  53.  
  54.     and change the names of ALL the `.txt.Z' files.
  55.  
  56. Version and Copyrights
  57.  
  58.     ChName v1.0
  59.     (C) SuperOscar Softwares, Tommi Nieminen
  60.  
  61.