diff options
Diffstat (limited to 'man/mv.1')
| -rw-r--r-- | man/mv.1 | 128 |
1 files changed, 128 insertions, 0 deletions
diff --git a/man/mv.1 b/man/mv.1 new file mode 100644 index 0000000..53bf0cf --- /dev/null +++ b/man/mv.1 @@ -0,0 +1,128 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH MV "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +mv \- move (rename) files +.SH SYNOPSIS +.B mv +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR +.br +.B mv +[\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR +.br +.B mv +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\fR... +.SH DESCRIPTION +.\" This page is derived from GNU Coreutils documentation. +This page documents BNU, an independent Bun implementation compatible with +GNU Coreutils 9.11. +.PP +Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--backup'\fB\-\-backup[=CONTROL]\fP\X'tty: link' +make a backup of each existing destination file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-b'\fB\-b\fP\X'tty: link' +like \fB\-\-backup\fR but does not accept an argument +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--debug'\fB\-\-debug\fP\X'tty: link' +explain how a file is copied. Implies \fB\-v\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--exchange'\fB\-\-exchange\fP\X'tty: link' +exchange source and destination +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-f'\fB\-f, \-\-force\fP\X'tty: link' +do not prompt before overwriting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-i'\fB\-i, \-\-interactive\fP\X'tty: link' +prompt before overwrite +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-n'\fB\-n, \-\-no\-clobber\fP\X'tty: link' +do not overwrite an existing file +.PP +If you specify more than one of \fB\-i\fR, \fB\-f\fR, \fB\-n\fR, only the final one takes effect. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--no-copy'\fB\-\-no\-copy\fP\X'tty: link' +do not copy if renaming fails +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--strip-trailing-slashes'\fB\-\-strip\-trailing\-slashes\fP\X'tty: link' +remove any trailing slashes from each SOURCE argument +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-S'\fB\-S, \-\-suffix=\,SUFFIX\fP\X'tty: link'\/\fR +override the usual backup suffix +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-t'\fB\-t, \-\-target\-directory=\,DIRECTORY\fP\X'tty: link'\/\fR +move all SOURCE arguments into DIRECTORY +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-T'\fB\-T, \-\-no\-target\-directory\fP\X'tty: link' +treat DEST as a normal file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv--update'\fB\-\-update[=UPDATE]\fP\X'tty: link' +control which existing files are updated; +UPDATE={all,none,none\-fail,older(default)} +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-u'\fB\-u\fP\X'tty: link' +equivalent to \fB\-\-update\fR[=\fI\,older\/\fR]. See below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-v'\fB\-v, \-\-verbose\fP\X'tty: link' +explain what is being done +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#mv-Z'\fB\-Z, \-\-context\fP\X'tty: link' +set SELinux security context of destination file to default type +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mv#mv--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/mv#mv--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +UPDATE controls which existing files in the destination are replaced. +\&'all' is the default operation when an \fB\-\-update\fR option is not specified, +and results in all existing files in the destination being replaced. +\&'none' is like the \fB\-\-no\-clobber\fR option, in that no files in the +destination are replaced, and skipped files do not induce a failure. +\&'none\-fail' also ensures no files are replaced in the destination, +but any skipped files are diagnosed and induce a failure. +\&'older' is the default operation when \fB\-\-update\fR is specified, and results +in files being replaced if they're older than the corresponding source file. +.PP +The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX. +The version control method may be selected via the \fB\-\-backup\fR option or through +the VERSION_CONTROL environment variable. Here are the values: +.TP +none, off +never make backups (even if \fB\-\-backup\fR is given) +.TP +numbered, t +make numbered backups +.TP +existing, nil +numbered if numbered backups exist, simple otherwise +.TP +simple, never +always make simple backups +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Mike Parker, David MacKenzie, and Jim Meyering. +.br +Adapted for BNU; the BNU implementation is independent. +.SH "REPORTING BUGS" +Report BNU bugs at <https://github.com/Soccera1/bnu/issues>. +.br +For upstream GNU Coreutils, see <https://www.gnu.org/software/coreutils/>. +.SH COPYRIGHT +Copyright \(co 2026 Free Software Foundation, Inc. +.br +This manual page was adapted for BNU in 2026. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBrename\fP(2) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/mv> +.br +BNU documentation is available locally via: info \(aq(bnu) mv invocation\(aq |
