Man page - shtool-move(1)

Packages contains this manual

Manual

SHTOOL-MOVE.TMP

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
HISTORY
SEE ALSO

NAME

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

SYNOPSIS

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

DESCRIPTION

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.

EXAMPLE

# 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

HISTORY

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

SEE ALSO

shtool (1), mv (1), make (1).