mren.1

   1 .TH mren 1 "03Nov09" mtools-4.0.12
   2 .SH Name
   3 mren - rename an existing MSDOS file
   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\ of\ warning
  16 This manpage has been automatically generated from mtools's texinfo
  17 documentation, and may not be entirely accurate or complete.  See the
  18 end of this man page for details.
  19 .PP
  20 .SH Description
  21 .iX "p mren"
  22 .iX "c Renaming files (mren)"
  23 .iX "c Moving files (mren)"
  24 .PP
  25 The \fR\&\f(CWmren\fR command is used to rename or move an existing MS-DOS
  26 file or subdirectory. Its syntax is:
  27 .PP
  28 .ft I
  29 .nf
  30 \&\fR\&\f(CWmren\fR [\fR\&\f(CW-voOsSrRA\fR] \fIsourcefile\fR \fItargetfile\fR
  31 .fi
  32 .ft R
  33
  34 .PP
  35 \&\fR\&\f(CWMren\fR
  36 renames an existing file on an MS-DOS filesystem.
  37 .PP
  38 In verbose mode, \fR\&\f(CWMren\fR displays the new filename if the name
  39 supplied is invalid.
  40 .PP
  41 If the first syntax is used (only one sourcefile), and if the target
  42 name doesn't contain any slashes or colons, the file (or subdirectory)
  43 is renamed in the same directory, instead of being moved to the current
  44 \&\fR\&\f(CWmcd\fR directory as would be the case with \fR\&\f(CWmmove\fR. Unlike the
  45 MS-DOS version of \fR\&\f(CWREN\fR, \fR\&\f(CWmren\fR can be used to rename
  46 directories.
  47 .PP
  48 .SH See\ Also
  49 Mtools' texinfo doc
  50 .SH Viewing\ the\ texi\ doc
  51 This manpage has been automatically generated from mtools's texinfo
  52 documentation. However, this process is only approximative, and some
  53 items, such as crossreferences, footnotes and indices are lost in this
  54 translation process.  Indeed, these items have no appropriate
  55 representation in the manpage format.  Moreover, not all information has
  56 been translated into the manpage version.  Thus I strongly advise you to
  57 use the original texinfo doc.  See the end of this manpage for
  58 instructions how to view the texinfo doc.
  59 .TP
  60 * \ \
  61 To generate a printable copy from the texinfo doc, run the following
  62 commands:
  63
  64 .nf
  65 .ft 3
  66 .in +0.3i
  67     ./configure; make dvi; dvips mtools.dvi
  68 .fi
  69 .in -0.3i
  70 .ft R
  71 .lp
  72
  73 \&\fR
  74 .TP
  75 * \ \
  76 To generate a html copy,  run:
  77
  78 .nf
  79 .ft 3
  80 .in +0.3i
  81     ./configure; make html
  82 .fi
  83 .in -0.3i
  84 .ft R
  85 .lp
  86
  87 \&\fRA premade html can be found at
  88 \&\fR\&\f(CW\(ifhttp://www.gnu.org/software/mtools/manual/mtools.html\(is\fR
  89 .TP
  90 * \ \
  91 To generate an info copy (browsable using emacs' info mode), run:
  92
  93 .nf
  94 .ft 3
  95 .in +0.3i
  96     ./configure; make info
  97 .fi
  98 .in -0.3i
  99 .ft R
 100 .lp
 101
 102 \&\fR
 103 .PP
 104 The texinfo doc looks most pretty when printed or as html.  Indeed, in
 105 the info version certain examples are difficult to read due to the
 106 quoting conventions used in info.
 107 .PP