1ICMD(1)                     General Commands Manual                    ICMD(1)
2
3
4

NAME

6       imv,  icp - Rename or copy a file by editing the destination name using
7       GNU readline.
8

SYNOPSIS

10       imv [OPTION] FILE...
11
12       icp [OPTION] FILE...
13

DESCRIPTION

15       This manual page document describes the icmd, imv, and icp commands.
16
17       imv is a program to interactively rename a single file.  It  does  this
18       by  allowing  the file name to be edited inline with GNU readline. This
19       is very similar to using mv(1) and editing the filename  on  the  shell
20       command-line,  with  one  exception  - the filename does not have to be
21       typed twice.
22
23       The imv program normally executes mv(1)  to  do  the  actual  renaming.
24       This can however be changed with the --command option.
25
26       icp  is  identical  to  imv  except  that  a  file is copied with cp(1)
27       instead. Both these commands are symbolic links to the icmd command.
28
29

OPTIONS

31       These programs follow the usual GNU  command  line  syntax,  with  long
32       options starting with two dashes (`-').
33
34       All  options  except  those listed below are passed to either mv, cp or
35       the command specified by --command.
36
37       --command=FILE
38              Specify command to run instead of the default `mv' or `cp'.  You
39              do  not  need  to  specify the directory name of FILE if FILE is
40              found in the current path (as set by the $PATH environment vari‐
41              able).
42
43              It is assumed that the command specified accepts the same set of
44              long and short options that require an argument as mv or cp.  If
45              not,  you  should  specify those options with --arg-options (see
46              below). Also note that --arg-options is not needed  as  long  as
47              you  specify  option  and  option  value  in a single word, like
48              `--suffix=bak' instead of  `--suffix  bak'  when  passing  extra
49              options to mv via imv.
50
51
52       --arg-options=OPTION[,OPTION...]
53              Specify  what comma-separated options for mv, cp, or the command
54              specified with --command require an  argument.  Options  may  be
55              short  (e.g.  -S)  as well as long (e.g. --suffix).  The default
56              list for mv is `t,S,reply,suffix,target-directory', and the list
57              for cp is `t,S,Z,no-preserve,sparse,suffix,context,target-direc‐
58              tory'.  (These lists are complete and correct for GNU  Coreutils
59              5.97.)
60
61              This list is necessary because icmd needs to know what arguments
62              specified on the command line are files to move/copy, or  option
63              values (following an option).
64
65       --pass-through
66              Run  mv/cp  (or  the command specified with --command) if two or
67              more arguments are specified. This way imv/icp can be used as an
68              alias for mv/cp (see below).
69
70       --help Show summary of options.
71
72       --version
73              Output version information and exit.
74

EXAMPLES

76       Using imv as a Bash alias for mv:
77            alias mv=imv --pass-through -i
78

REPORTING BUGS

80       Report bugs to <oskar@osk.mine.nu>.
81

SEE ALSO

83       mv(1), cp(1)
84

AUTHOR

86       The  author  of  renameutils  and  this  manual page is Oskar Liljeblad
87       <oskar@osk.mine.nu>.
88

90       Copyright © 2001, 2002, 2004, 2005, 2007, 2008 Oskar Liljeblad
91
92       This is free software; see the source for copying conditions.  There is
93       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
94       PURPOSE.
95
96
97
98icmd (renameutils)             December 1, 2007                        ICMD(1)
Impressum