1SHTOOL-MOVE.TMP(1)          GNU Portable Shell Tool         SHTOOL-MOVE.TMP(1)
2
3
4

NAME

6       shtool move - GNU shtool enhanced mv(1) replacement
7

SYNOPSIS

9       shtool move [-v|--verbose] [-t|--trace] [-e|--expand] [-p|--preserve]
10       src-file dst-file
11

DESCRIPTION

13       This is a mv(1) style command enhanced with the ability to rename
14       multiple files in a single operation and the ability to detect and not
15       touch existing equal destinations files, thus preserving timestamps.
16

OPTIONS

18       The following command line options are available.
19
20       -v, --verbose
21           Display some processing information.
22
23       -t, --trace
24           Enable the output of the essential shell commands which are
25           executed.
26
27       -e, --expand
28           Expand asterisk in src to be used as ""%"n" (where n is 1,2,...) in
29           dst-file. This is useful for renaming multiple files at once.
30
31       -p, --preserve
32           Detect src-file and dst-file having equal content and not touch
33           existing destination files, thus perserving timestamps. This is
34           useful for applications that monitor timestamps, i.e. suppress
35           make(1L) repeating actions for unchanged files.
36

EXAMPLE

38        #   shell script
39        shtool move -v -e '*.txt' %1.asc
40
41        #   Makefile
42        scanner.c: scanner.l
43            lex scanner.l
44            shtool move -t -p lex.yy.c scanner.c
45

HISTORY

47       The GNU shtool move command was originally written by Ralf S.
48       Engelschall <rse@engelschall.com> in 1999 for GNU shtool.
49

SEE ALSO

51       shtool(1), mv(1), make(1).
52
53
54
5518-Jul-2008                      shtool 2.0.8               SHTOOL-MOVE.TMP(1)