Rev | Author | # | Line |
---|---|---|---|
1 | perry | 1 | mkmanifest |
2 | !!!mkmanifest | ||
3 | Name | ||
4 | Note of warning | ||
5 | Description | ||
6 | Example | ||
7 | Bugs | ||
8 | See Also | ||
9 | Viewing the texi doc | ||
10 | ---- | ||
11 | !!Name | ||
12 | |||
13 | |||
14 | mkmanifest - makes list of file names and their DOS 8+3 equivalent | ||
15 | !!Note of warning | ||
16 | |||
17 | |||
18 | This manpage has been automatically generated from mtools's | ||
19 | texinfo documentation, and may not be entirely accurate or | ||
20 | complete. See the end of this man page for | ||
21 | details. | ||
22 | !!Description | ||
23 | |||
24 | |||
25 | The mkmanifest command is used to create a shell | ||
26 | script (packing list) to restore Unix filenames. Its syntax | ||
27 | is: | ||
28 | |||
29 | |||
30 | mkmanifest [[ ''files'' ] | ||
31 | |||
32 | |||
33 | Mkmanifest creates a shell script that aids in the | ||
34 | restoration of Unix filenames that got clobbered by the | ||
35 | MS-DOS filename restrictions. MS-DOS filenames are | ||
36 | restricted to 8 character names, 3 character extensions, | ||
37 | upper case only, no device names, and no illegal | ||
38 | characters. | ||
39 | |||
40 | |||
41 | The mkmanifest program is compatible with the methods used | ||
42 | in pcomm, arc, and mtools to change | ||
43 | perfectly good Unix filenames to fit the MS-DOS | ||
44 | restrictions. This command is only useful if the target | ||
45 | system which will read the diskette cannot handle vfat long | ||
46 | names. | ||
47 | !!Example | ||
48 | |||
49 | |||
50 | You want to copy the following Unix files to a MS-DOS | ||
51 | diskette (using the mcopy command). | ||
52 | |||
53 | |||
54 | __ very_long_name | ||
55 | 2.many.dots | ||
56 | illegal: | ||
57 | good.c | ||
58 | prn.dev | ||
59 | Capital | ||
60 | __ | ||
61 | |||
62 | |||
63 | Mcopy converts the names to: | ||
64 | |||
65 | |||
66 | __ very_lon | ||
67 | 2xmany.dot | ||
68 | illegalx | ||
69 | good.c | ||
70 | xprn.dev | ||
71 | capital | ||
72 | __ | ||
73 | |||
74 | |||
75 | The command: | ||
76 | |||
77 | |||
78 | __ mkmanifest very_long_name 2.many.dots illegal: good.c prn.dev Capital | ||
79 | __would produce the following: | ||
80 | |||
81 | |||
82 | __ mv very_lon very_long_name | ||
83 | mv 2xmany.dot 2.many.dots | ||
84 | mv illegalx illegal: | ||
85 | mv xprn.dev prn.dev | ||
86 | mv capital Capital | ||
87 | __ | ||
88 | |||
89 | |||
90 | Notice that | ||
91 | |||
92 | |||
93 | Suppose I've copied these files from the diskette to another | ||
94 | Unix system, and I now want the files back to their original | ||
95 | names. If the file | ||
96 | !!Bugs | ||
97 | |||
98 | |||
99 | The short names generated by mkmanifest follow the | ||
100 | old convention (from mtools-2.0.7) and not the one from | ||
101 | Windows 95 and mtools-3.0. | ||
102 | !!See Also | ||
103 | |||
104 | |||
105 | Mtools' texinfo doc | ||
106 | !!Viewing the texi doc | ||
107 | |||
108 | |||
109 | This manpage has been automatically generated from mtools's | ||
110 | texinfo documentation. However, this process is only | ||
111 | approximative, and some items, such as crossreferences, | ||
112 | footnotes and indices are lost in this translation process. | ||
113 | Indeed, these items have no appropriate representation in | ||
114 | the manpage format. Moreover, not all information has been | ||
115 | translated into the manpage version. Thus I strongly advise | ||
116 | you to use the original texinfo doc. See the end of this | ||
117 | manpage for instructions how to view the texinfo | ||
118 | doc. | ||
119 | |||
120 | |||
121 | * | ||
122 | |||
123 | |||
124 | To generate a printable copy from the texinfo doc, run the | ||
125 | following commands: | ||
126 | |||
127 | |||
128 | __ ./configure; make dvi; dvips mtools.dvi | ||
129 | __ | ||
130 | |||
131 | |||
132 | * | ||
133 | |||
134 | |||
135 | To generate a html copy, run: | ||
136 | |||
137 | |||
138 | __ ./configure; make html | ||
139 | __A premade html can be found at: `http://mtools.linux.lu' and also at: `http://www.tux.org/pub/knaff/mtools' | ||
140 | |||
141 | |||
142 | * | ||
143 | |||
144 | |||
145 | To generate an info copy (browsable using emacs' info mode), | ||
146 | run: | ||
147 | |||
148 | |||
149 | __ ./configure; make info | ||
150 | __ | ||
151 | |||
152 | |||
153 | The texinfo doc looks most pretty when printed or as html. | ||
154 | Indeed, in the info version certain examples are difficult | ||
155 | to read due to the quoting conventions used in | ||
156 | info. | ||
157 | ---- |