home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / CMDS / mtools_3.6.docs.lzh / MTOOLS_3.6 / DOCS / mkmanifest.1 < prev    next >
Text File  |  1997-11-12  |  4KB  |  175 lines
  1. .TH mkmanifest 1 "21mar97" mtools-3.4
  2. .SH Name
  3. '\" t
  4. .de TQ
  5. .br
  6. .ns
  7. .TP \\$1
  8. ..
  9.  
  10. .tr \(is'
  11. .tr \(if`
  12. .tr \(pd"
  13.  
  14. .SH Note
  15. This manpage has been automatically generated from mtools's texinfo
  16. documentation.  However, this process is only approximative, and some
  17. items, such as crossreferences, footnotes and indices are lost in this
  18. translation process.  Indeed, this items have no appropriate
  19. representation in the manpage format.  Moreover, only the items specific
  20. to each command have been translated, and the general information about
  21. mtools has been dropped in the manpage version.  Thus I strongly advise
  22. you to use the original texinfo doc.
  23. .TP
  24. * \ \ 
  25. To generate a printable copy from the texinfo doc, run the following
  26. commands:
  27.  
  28. .nf
  29. .ft 3
  30. .in +0.3i
  31.     ./configure; make dvi; dvips mtools.dvi
  32. .fi
  33. .in -0.3i
  34. .ft R
  35. .lp
  36.  
  37. \&\fR
  38. .TP
  39. * \ \ 
  40. To generate a html copy,  run:
  41.  
  42. .nf
  43. .ft 3
  44. .in +0.3i
  45.     ./configure; make html
  46. .fi
  47. .in -0.3i
  48. .ft R
  49. .lp
  50.  
  51. \&\fRA premade html can be found at:
  52. \&\fR\&\f(CW\(ifhttp://linux.wauug.org/pub/knaff/mtools\(is\fR
  53. .TP
  54. * \ \ 
  55. To generate an info copy (browsable using emacs' info mode), run:
  56.  
  57. .nf
  58. .ft 3
  59. .in +0.3i
  60.     ./configure; make info
  61. .fi
  62. .in -0.3i
  63. .ft R
  64. .lp
  65.  
  66. \&\fR
  67. .PP
  68. The texinfo doc looks most pretty when printed or as html.  Indeed, in
  69. the info version certain examples are difficult to read due to the
  70. quoting conventions used in info.
  71. .PP
  72. .SH Description
  73. .iX "p mkmanifest"
  74. .iX "c packing list"
  75. .PP
  76. The \fR\&\f(CWmkmanifest\fR command is used to create a shell script (packing
  77. list) to restore Unix filenames. Its syntax is:
  78. .PP
  79. \&\fR\&\f(CWmkmanifest\fR [ \fIfiles\fR ]
  80. .PP
  81. \&\fR\&\f(CWMkmanifest\fR creates a shell script that aids in the restoration of
  82. Unix filenames that got clobbered by the MS-DOS filename restrictions.
  83. MS-DOS filenames are restricted to 8 character names, 3 character
  84. extensions, upper case only, no device names, and no illegal characters.
  85. .PP
  86. The mkmanifest program is compatible with the methods used in
  87. \&\fR\&\f(CWpcomm, arc,\fR and \fR\&\f(CWmtools\fR to change perfectly good Unix
  88. filenames to fit the MS-DOS restrictions. This command is only useful if
  89. the target system which will read the diskette cannot handle vfat long
  90. names.
  91. .PP
  92. .SH Example
  93. You want to copy the following Unix files to a MS-DOS diskette (using the
  94. \&\fR\&\f(CWmcopy\fR command).
  95. .PP
  96.  
  97. .nf
  98. .ft 3
  99. .in +0.3i
  100.   very_long_name
  101.   2.many.dots
  102.   illegal:
  103.   good.c
  104.   prn.dev
  105.   Capital
  106. .fi
  107. .in -0.3i
  108. .ft R
  109. .lp
  110.  
  111. \&\fR
  112. .PP
  113. \&\fR\&\f(CWMcopy\fR
  114. converts the names to:
  115. .PP
  116.  
  117. .nf
  118. .ft 3
  119. .in +0.3i
  120.   very_lon
  121.   2xmany.dot
  122.   illegalx
  123.   good.c
  124.   xprn.dev
  125.   capital
  126. .fi
  127. .in -0.3i
  128. .ft R
  129. .lp
  130.  
  131. \&\fR
  132. .PP
  133. The command:
  134.  
  135. .nf
  136. .ft 3
  137. .in +0.3i
  138. mkmanifest very_long_name 2.many.dots illegal: good.c prn.dev Capital >manifest
  139. .fi
  140. .in -0.3i
  141. .ft R
  142. .lp
  143.  
  144. \&\fRwould produce the following:
  145.  
  146. .nf
  147. .ft 3
  148. .in +0.3i
  149.   mv very_lon very_long_name
  150.   mv 2xmany.dot 2.many.dots
  151.   mv illegalx illegal:
  152.   mv xprn.dev prn.dev
  153.   mv capital Capital
  154. .fi
  155. .in -0.3i
  156. .ft R
  157. .lp
  158.  
  159. \&\fR
  160. .PP
  161. Notice that "good.c" did not require any conversion, so it did not
  162. appear in the output.
  163. .PP
  164. Suppose I've copied these files from the diskette to another Unix
  165. system, and I now want the files back to their original names.  If the
  166. file "manifest" (the output captured above) was sent along with those
  167. files, it could be used to convert the filenames.
  168. .PP
  169. .SH Bugs
  170. .PP
  171. The short names generated by \fR\&\f(CWmkmanifest\fR follow the old convention
  172. (from mtools-2.0.7) and not the one from Windows 95 and mtools-3.0.
  173. .SH See Also
  174. Mtools' texinfo doc
  175.