NAME
imv, icp - Rename or copy a file by editing the destination name using
GNU readline.
SYNOPSIS
imv [OPTION] FILE...
icp [OPTION] FILE...
DESCRIPTION
This manual page document describes the icmd, imv, and icp commands.
imv is a program to interactively rename a single file. It does this
by allowing the file name to be edited inline with GNU readline. This
is very similar to using mv(1) and editing the filename on the shell
command-line, with one exception - the filename does not have to be
typed twice.
The imv program normally executes mv(1) to do the actual renaming.
This can however be changed with the --command option.
icp is identical to imv except that a file is copied with cp(1)
instead. Both these commands are symbolic links to the icmd command.
OPTIONS
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (‘-’).
All options except those listed below are passed to either mv, cp or
the command specified by --command.
--command=FILE
Specify command to run instead of the default ‘mv’ or ‘cp’. You
do not need to specify the directory name of FILE if FILE is
found in the current path (as set by the $PATH environment
variable).
It is assumed that the command specified accepts the same set of
long and short options that require an argument as mv or cp. If
not, you should specify those options with --arg-options (see
below). Also note that --arg-options is not needed as long as
you specify option and option value in a single word, like
‘--suffix=bak’ instead of ‘--suffix bak’ when passing extra
options to mv via imv.
--arg-options=OPTION[,OPTION...]
Specify what comma-separated options for mv, cp, or the command
specified with --command require an argument. Options may be
short (e.g. -S) as well as long (e.g. --suffix). The default
list for mv is ‘t,S,reply,suffix,target-directory’, and the list
for cp is ‘t,S,Z,no-preserve,sparse,suffix,context,target-
directory’. (These lists are complete and correct for GNU
Coreutils 5.97.)
This list is necessary because icmd needs to know what arguments
specified on the command line are files to move/copy, or option
values (following an option).
--pass-through
Run mv/cp (or the command specified with --command) if two or
more arguments are specified. This way imv/icp can be used as an
alias for mv/cp (see below).
--help Show summary of options.
--version
Output version information and exit.
EXAMPLES
Using imv as a Bash alias for mv:
alias mv=imv --pass-through -i
REPORTING BUGS
Report bugs to <oskar@osk.mine.nu>.
SEE ALSO
mv(1), cp(1)
AUTHOR
The author of renameutils and this manual page is Oskar Liljeblad
<oskar@osk.mine.nu>.
COPYRIGHT
Copyright © 2001, 2002, 2004, 2005, 2007, 2008 Oskar Liljeblad
This is free software; see the source for copying conditions. There is
NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.