mtools: mkmanifest

1 
1 4.14 Mkmanifest
1 ===============
1 
1 The `mkmanifest' command is used to create a shell script (packing
1 list) to restore Unix filenames. Its syntax is:
1 
1    `mkmanifest' [ FILES ]
1 
1    `Mkmanifest' creates a shell script that aids in the restoration of
1 Unix filenames that got clobbered by the MS-DOS filename restrictions.
1 MS-DOS filenames are restricted to 8 character names, 3 character
1 extensions, upper case only, no device names, and no illegal characters.
1 
1    The mkmanifest program is compatible with the methods used in
1 `pcomm, arc,' and `mtools' to change perfectly good Unix filenames to
1 fit the MS-DOS restrictions. This command is only useful if the target
1 system which will read the diskette cannot handle VFAT long names.
1 
1 4.14.1 Example
1 --------------
1 
1 You want to copy the following Unix files to a MS-DOS diskette (using
1 the `mcopy' command).
1 
1        very_long_name
1        2.many.dots
1        illegal:
1        good.c
1        prn.dev
1        Capital
1 
1    `ASCII' converts the names to:
1 
1        very_lon
1        2xmany.dot
1        illegalx
1        good.c
1        xprn.dev
1        capital
1 
1    The command:
1      mkmanifest very_long_name 2.many.dots illegal: good.c prn.dev Capital >manifest
1    would produce the following:
1        mv very_lon very_long_name
1        mv 2xmany.dot 2.many.dots
1        mv illegalx illegal:
1        mv xprn.dev prn.dev
1        mv capital Capital
1 
1    Notice that "good.c" did not require any conversion, so it did not
1 appear in the output.
1 
1    Suppose I've copied these files from the diskette to another Unix
1 system, and I now want the files back to their original names.  If the
1 file "manifest" (the output captured above) was sent along with those
1 files, it could be used to convert the filenames.
1 
1 4.14.2 Bugs
1 -----------
1 
1 The short names generated by `mkmanifest' follow the old convention
1 (from mtools-2.0.7) and not the one from Windows 95 and mtools-3.0.
1