ossp-pkg/shtool/sh.move 1.19 -> 1.20
--- sh.move 2004/01/01 16:54:20 1.19
+++ sh.move 2004/02/12 16:06:27 1.20
@@ -1,7 +1,6 @@
##
## move -- Move files with simultaneous substitution
## Copyright (c) 1999-2004 Ralf S. Engelschall <rse@engelschall.com>
-## Originally written for shtool
##
## This file is part of shtool and free software; you can redistribute
## it and/or modify it under the terms of the GNU General Public
@@ -113,5 +112,82 @@
break;
fi
done
+
shtool_exit $errorstatus
+##
+## manual page
+##
+
+=pod
+
+=head1 NAME
+
+B<shtool move> - B<GNU shtool> enhanced mv(1) replacement
+
+=head1 SYNOPSIS
+
+B<shtool move>
+[B<-v>|B<--verbose>]
+[B<-t>|B<--trace>]
+[B<-e>|B<--expand>]
+[B<-p>|B<--preserve>]
+I<src-file>
+I<dst-file>
+
+=head1 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.
+
+=head1 OPTIONS
+
+The following command line options are available.
+
+=over 4
+
+=item B<-v>, B<--verbose>
+
+Display some processing information.
+
+=item B<-t>, B<--trace>
+
+Enable the output of the essential shell commands which are executed.
+
+=item B<-e>, B<--expand>
+
+Expand asterisk in I<src> to be used as "C<%>I<n>" (where I<n> is
+C<1>,C<2>,...) in I<dst-file>. This is useful for renaming multiple
+files at once.
+
+=item B<-p>, B<--preserve>
+
+Detect I<src-file> and I<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.
+
+=back
+
+=head1 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
+
+=head1 HISTORY
+
+The B<GNU shtool> B<move> command was originally written by Ralf S.
+Engelschall E<lt>rse@engelschall.comE<gt> in 1999 for B<GNU shtool>.
+
+=head1 SEE ALSO
+
+shtool(1), mv(1), make(1).
+
+=cut
+
|
|
