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 / mcopy.1 < prev    next >
Text File  |  1997-11-12  |  4KB  |  154 lines
  1. .TH mcopy 1 "21mar97" mtools-3.4
  2. .SH Name
  3. mcopy - copy MSDOS files to/from Unix
  4. '\" t
  5. .de TQ
  6. .br
  7. .ns
  8. .TP \\$1
  9. ..
  10.  
  11. .tr \(is'
  12. .tr \(if`
  13. .tr \(pd"
  14.  
  15. .SH Note
  16. This manpage has been automatically generated from mtools's texinfo
  17. documentation.  However, this process is only approximative, and some
  18. items, such as crossreferences, footnotes and indices are lost in this
  19. translation process.  Indeed, this items have no appropriate
  20. representation in the manpage format.  Moreover, only the items specific
  21. to each command have been translated, and the general information about
  22. mtools has been dropped in the manpage version.  Thus I strongly advise
  23. you to use the original texinfo doc.
  24. .TP
  25. * \ \ 
  26. To generate a printable copy from the texinfo doc, run the following
  27. commands:
  28.  
  29. .nf
  30. .ft 3
  31. .in +0.3i
  32.     ./configure; make dvi; dvips mtools.dvi
  33. .fi
  34. .in -0.3i
  35. .ft R
  36. .lp
  37.  
  38. \&\fR
  39. .TP
  40. * \ \ 
  41. To generate a html copy,  run:
  42.  
  43. .nf
  44. .ft 3
  45. .in +0.3i
  46.     ./configure; make html
  47. .fi
  48. .in -0.3i
  49. .ft R
  50. .lp
  51.  
  52. \&\fRA premade html can be found at:
  53. \&\fR\&\f(CW\(ifhttp://linux.wauug.org/pub/knaff/mtools\(is\fR
  54. .TP
  55. * \ \ 
  56. To generate an info copy (browsable using emacs' info mode), run:
  57.  
  58. .nf
  59. .ft 3
  60. .in +0.3i
  61.     ./configure; make info
  62. .fi
  63. .in -0.3i
  64. .ft R
  65. .lp
  66.  
  67. \&\fR
  68. .PP
  69. The texinfo doc looks most pretty when printed or as html.  Indeed, in
  70. the info version certain examples are difficult to read due to the
  71. quoting conventions used in info.
  72. .PP
  73. .SH Description
  74. .iX "p mcopy"
  75. .iX "c Reading MS-DOS files"
  76. .iX "c Writing MS-DOS files"
  77. .iX "c Copying MS-DOS files"
  78. .iX "c Concatenating MS-DOS files"
  79. .iX "c Text files"
  80. .iX "c CR/LF conversions"
  81. .PP
  82. The \fR\&\f(CWmcopy\fR command is used to copy MS-DOS files to and from
  83. Unix. It uses the following syntax:
  84. .PP
  85.  
  86. .nf
  87. .ft 3
  88. .in +0.3i
  89. \&\fR\&\f(CWmcopy [\fR\&\f(CW-tnvmoOsSrRA] \fIsourcefile\fR\&\f(CW \fItargetfile\fR\&\f(CW
  90. \&\fR\&\f(CWmcopy [\fR\&\f(CW-tnvmoOsSrRA] \fIsourcefile\fR\&\f(CW [ \fIsourcefiles\fR\&\f(CW\&... ] \fItargetdirectory\fR\&\f(CW
  91. \&\fR\&\f(CWmcopy [\fR\&\f(CW-tnvm] \fIMSDOSsourcefile\fR\&\f(CW
  92. .fi
  93. .in -0.3i
  94. .ft R
  95. .lp
  96.  
  97. \&\fR
  98. .PP
  99. \&\fR\&\f(CWMcopy\fR copies the specified file to the named file, or copies
  100. multiple files to the named directory.  The source and target can be
  101. either MS-DOS or Unix files.
  102. .PP
  103. The use of a drive letter designation on the MS-DOS files, 'a:' for
  104. example, determines the direction of the transfer.  A missing drive
  105. designation implies a Unix file whose path starts in the current
  106. directory.  If a source drive letter is specified with no attached file
  107. name (e.g. \fR\&\f(CWmcopy a: .\fR), all files are copied from that drive.
  108. .PP
  109. If only a single, MS-DOS source parameter is provided (e.g. "mcopy
  110. a:foo.exe"), an implied destination of the current directory
  111. (`\fR\&\f(CW.\fR') is assumed.
  112. .PP
  113. A filename of `\fR\&\f(CW-\fR' means standard input or standard output, depending
  114. on its position on the command line.
  115. .PP
  116. \&\fR\&\f(CWMcopy\fR accepts the following command line options:
  117. .TP
  118. \&\fR\&\f(CWQ\fR\ 
  119. When mcopying multiple files, quits as soon as one copy fails (for
  120. example due to lacking storage space on the target disk)
  121. .TP
  122. \&\fR\&\f(CWt\fR\ 
  123. Text file transfer.  \fR\&\f(CWMcopy\fR translates incoming carriage
  124. return/line feeds to line feeds.
  125. .TP
  126. \&\fR\&\f(CWn\fR\ 
  127. No confirmation when overwriting Unix files.  \fR\&\f(CWMcopy\fR doesn't warn
  128. the user when overwriting an existing Unix file.  In order to switch off
  129. confirmation for DOS files, use \fR\&\f(CW-o\fR.
  130. .TP
  131. \&\fR\&\f(CWm\fR\ 
  132. Preserve the file modification time. If the target file already exists,
  133. and the \fR\&\f(CW-n\fR option is not in effect, \fR\&\f(CWmcopy\fR asks whether to
  134. overwrite the file or to rename the new file (\(ifname clashes\(is) for
  135. details).
  136. .PP
  137. .SH Bugs
  138. Unlike MS-DOS, the '+' operator (append) from MS-DOS is not
  139. supported. However, you may use \fR\&\f(CWmtype\fR to produce the same effect:
  140.  
  141. .nf
  142. .ft 3
  143. .in +0.3i
  144. mtype a:file1 a:file2 a:file3 >unixfile
  145. mtype a:file1 a:file2 a:file3 | mcopy - a:msdosfile
  146. .fi
  147. .in -0.3i
  148. .ft R
  149. .lp
  150.  
  151. \&\fR
  152. .SH See Also
  153. Mtools' texinfo doc
  154.