~ubuntu-branches/ubuntu/utopic/coreutils/utopic-proposed

« back to all changes in this revision

Viewing changes to man/mv.1

  • Committer: Colin Watson
  • Date: 2013-10-30 15:48:33 UTC
  • mfrom: (8.3.5 sid)
  • Revision ID: cjwatson@canonical.com-20131030154833-xdt6e1yfffqom1c4
merge from Debian 8.21-1

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
2
 
.TH MV "1" "October 2012" "GNU coreutils 8.20" "User Commands"
3
 
.SH NAME
4
 
mv \- move (rename) files
5
 
.SH SYNOPSIS
6
 
.B mv
7
 
[\fIOPTION\fR]... [\fI-T\fR] \fISOURCE DEST\fR
8
 
.br
9
 
.B mv
10
 
[\fIOPTION\fR]... \fISOURCE\fR... \fIDIRECTORY\fR
11
 
.br
12
 
.B mv
13
 
[\fIOPTION\fR]... \fI-t DIRECTORY SOURCE\fR...
14
 
.SH DESCRIPTION
15
 
.\" Add any additional description here
16
 
.PP
17
 
Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.
18
 
.PP
19
 
Mandatory arguments to long options are mandatory for short options too.
20
 
.TP
21
 
\fB\-\-backup\fR[=\fICONTROL\fR]
22
 
make a backup of each existing destination file
23
 
.TP
24
 
\fB\-b\fR
25
 
like \fB\-\-backup\fR but does not accept an argument
26
 
.TP
27
 
\fB\-f\fR, \fB\-\-force\fR
28
 
do not prompt before overwriting
29
 
.TP
30
 
\fB\-i\fR, \fB\-\-interactive\fR
31
 
prompt before overwrite
32
 
.TP
33
 
\fB\-n\fR, \fB\-\-no\-clobber\fR
34
 
do not overwrite an existing file
35
 
.PP
36
 
If you specify more than one of \fB\-i\fR, \fB\-f\fR, \fB\-n\fR, only the final one takes effect.
37
 
.TP
38
 
\fB\-\-strip\-trailing\-slashes\fR
39
 
remove any trailing slashes from each SOURCE
40
 
argument
41
 
.TP
42
 
\fB\-S\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
43
 
override the usual backup suffix
44
 
.TP
45
 
\fB\-t\fR, \fB\-\-target\-directory\fR=\fIDIRECTORY\fR
46
 
move all SOURCE arguments into DIRECTORY
47
 
.TP
48
 
\fB\-T\fR, \fB\-\-no\-target\-directory\fR
49
 
treat DEST as a normal file
50
 
.TP
51
 
\fB\-u\fR, \fB\-\-update\fR
52
 
move only when the SOURCE file is newer
53
 
than the destination file or when the
54
 
destination file is missing
55
 
.TP
56
 
\fB\-v\fR, \fB\-\-verbose\fR
57
 
explain what is being done
58
 
.TP
59
 
\fB\-\-help\fR
60
 
display this help and exit
61
 
.TP
62
 
\fB\-\-version\fR
63
 
output version information and exit
64
 
.PP
65
 
The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
66
 
The version control method may be selected via the \fB\-\-backup\fR option or through
67
 
the VERSION_CONTROL environment variable.  Here are the values:
68
 
.TP
69
 
none, off
70
 
never make backups (even if \fB\-\-backup\fR is given)
71
 
.TP
72
 
numbered, t
73
 
make numbered backups
74
 
.TP
75
 
existing, nil
76
 
numbered if numbered backups exist, simple otherwise
77
 
.TP
78
 
simple, never
79
 
always make simple backups
80
 
.SH AUTHOR
81
 
Written by Mike Parker, David MacKenzie, and Jim Meyering.
82
 
.SH "REPORTING BUGS"
83
 
Report mv bugs to bug\-coreutils@gnu.org
84
 
.br
85
 
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
86
 
.br
87
 
General help using GNU software: <http://www.gnu.org/gethelp/>
88
 
.br
89
 
Report mv translation bugs to <http://translationproject.org/team/>
90
 
.SH COPYRIGHT
91
 
Copyright \(co 2012 Free Software Foundation, Inc.
92
 
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
93
 
.br
94
 
This is free software: you are free to change and redistribute it.
95
 
There is NO WARRANTY, to the extent permitted by law.
96
 
.SH "SEE ALSO"
97
 
rename(2)
98
 
.PP
99
 
The full documentation for
100
 
.B mv
101
 
is maintained as a Texinfo manual.  If the
102
 
.B info
103
 
and
104
 
.B mv
105
 
programs are properly installed at your site, the command
106
 
.IP
107
 
.B info coreutils \(aqmv invocation\(aq
108
 
.PP
109
 
should give you access to the complete manual.