Man Linux: Main Page and Category List

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.