diff options
| author | Sami Kerola | 2011-06-11 23:42:45 +0200 |
|---|---|---|
| committer | Sami Kerola | 2011-06-25 13:45:27 +0200 |
| commit | 03b3d715ded40c44c074300b704be430aafbc1ae (patch) | |
| tree | df6639f4c6c0177357845075104dbb7f43f3b729 /misc-utils/rename.1 | |
| parent | rename: verbose option & maintenance fixes (diff) | |
| download | kernel-qcow2-util-linux-03b3d715ded40c44c074300b704be430aafbc1ae.tar.gz kernel-qcow2-util-linux-03b3d715ded40c44c074300b704be430aafbc1ae.tar.xz kernel-qcow2-util-linux-03b3d715ded40c44c074300b704be430aafbc1ae.zip | |
docs: rename.1 verbose, long options and warning
Add new verbose and long options to manual page. I also added
warning section which hopefully gets read by people who run the
command first time.
It might be good idea to make the rename such that it would not
overwrite by default, and have a --force option if an use wants
that. In current state the rename is somewhat dangerous.
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
Diffstat (limited to 'misc-utils/rename.1')
| -rw-r--r-- | misc-utils/rename.1 | 36 |
1 files changed, 22 insertions, 14 deletions
diff --git a/misc-utils/rename.1 b/misc-utils/rename.1 index bd676a8dd..d2c3d1421 100644 --- a/misc-utils/rename.1 +++ b/misc-utils/rename.1 @@ -1,49 +1,57 @@ .\" Written by Andries E. Brouwer (aeb@cwi.nl) .\" Placed in the public domain .\" -.TH RENAME 1 "1 January 2000" "" "Linux Programmer's Manual" +.TH RENAME "1" "June 2011" "util-linux" "User Commands" .SH NAME rename \- rename files .SH SYNOPSIS .B rename -.IR "from to file" ... -.br -.B rename -V +[\fIoptions\fR] \fIexpression replacement file\fR... .SH DESCRIPTION .B rename will rename the specified files by replacing the first occurrence of -.I from +.I expression in their name by -.IR to . - +.IR replacement . +.SH OPTIONS .TP -.BR \-V , " \-\-version" +\fB\-v\fR, \fB\-\-verbose\fR +Give visual feedback which files where renamed, if any. +.TP +\fB\-V\fR, \fB\-\-version\fR Display version information and exit. - +.TP +\fB\-h\fR, \fB\-\-help\fR +Display help screen and exit. .SH EXAMPLES Given the files .IR foo1 ", ..., " foo9 ", " foo10 ", ..., " foo278 , the commands - .RS +.PP .nf rename foo foo0 foo? rename foo foo0 foo?? .fi +.PP .RE - will turn them into .IR foo001 ", ..., " foo009 ", " foo010 ", ..., " foo278 . - And .RS +.PP .nf rename .htm .html *.htm .fi +.PP .RE - will fix the extension of your html files. - +.SH WARNING +The rename has no safeguards. If user has permission to rewrite file names +the command will perform the action without any questions. For example +result can be quite drastic when the command is ran as root in /lib +directory. Make always a backup before running the command, unless you truly +know what you are doing. .SH "SEE ALSO" .BR mmv (1), .BR mv (1) |