shtool-move(1)

shtool-move1

Gnu shtool enhanced mv(1) replacement

Usage

shtool move [{-v | --verbose}] [{-t | --trace}] [{-e | --expand}] [{-p | --preserve}] src-file dst-file

Overview

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

Options

The following command line options are available.

-v, --verbose

Display some processing information.

-t, --trace

Enable the output of the essential shell commands which are executed.

-e, --expand

Expand asterisk in src to be used as ""%"n" (where n is 1,2,...) in dst-file. This is useful for renaming multiple files at once.

-p, --preserve

Detect src-file and dst-file having equal content and not touch existing destination files, thus perserving timestamps. This is useful for applications that monitor timestamps, i.e. suppress make(1L) repeating actions for unchanged files.

Examples

 #   shell script
 shtool move -v -e '*.txt' %1.asc
 #   Makefile
 scanner.c: scanner.l
     lex scanner.l
     shtool move -t -p lex.yy.c scanner.c

Releases

11 releases since Debian 3.1 (Sarge); the text changed 5 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0–8
  5. 9–10
  6. 11–13

History

The GNU shtool move command was originally written by Ralf S. Engelschall <[email protected]> in 1999 for GNU shtool.

From shtool 2.0.8-10 in Debian 13 (Trixie). Parsed by carta from the page's man source.