ref: 4d57d83de83d0083036c0838cfb8b184910900d9
parent: a834d55c1f37133b608c2b91efa4134b9a20d5e6
author: kvik <kvik@a-b.xyz>
date: Wed Nov 7 16:21:33 EST 2018
mkfile: cleanup, add release target. rename manpage
--- /dev/null
+++ b/clone.man
@@ -1,0 +1,98 @@
+.TH CLONE 1
+.SH NAME
+clone \- copy files and directories
+.SH SYNOPSYS
+.B clone
+[
+.B -gux
+]
+[
+.B -b
+.I blocksize
+]
+[
+.B -p
+.I fileprocs:blockprocs
+]
+.I from ... to
+.SH DESCRIPTION
+.I Clone
+copies files and directories.
+Similar in spirit to
+.IR fcp(1)
+it is a multi-process program which
+relies on
+.IR pread(2)
+and
+.IR pwrite(2)
+system calls to copy multiple blocks
+in parallel, speeding up the file transfer
+over high-latency links;
+in contrast to
+.IR fcp(1)
+it can copy both single files and directories,
+which may be mixed on the command line.
+.PP
+A single file is copied as expected. If
+.I to
+does not exist, it is created; otherwise, an
+existing file is overwritten; if
+.I to
+is a directory,
+.I from
+is copied into it.
+A single directory is copied into
+.I to
+if it exists; otherwise, a new directory
+.I to
+is created and the contents of
+.I from
+are copied into it.
+If multiple source files (directories) are given,
+they are copied into the
+.I to
+directory, which is created if neccessary.
+.PP
+The
+.I -x
+option sets the mode and modified time of the
+destination file (directory) to that of the source
+file (directory); the
+.I -g
+and
+.I -u
+try to set the group and user id, respectively.
+.PP
+The
+.I -b
+option determines the size of a block that
+will be transfered by a single block transfer
+process (defaults to 128k).
+.PP
+The
+.I -p
+option determines the process parallelism
+configuration, with
+.I fileprocs
+being the number of processes that handle
+simultaneous file transfers, and
+.I blockprocs
+being the number of processes that do the
+input / output (defaults to 4:16).
+.PP
+.SH SOURCE
+.B https://bitbucket.org/k-vik/clone
+.SH SEE ALSO
+.IR fcp(1),
+.IR dircp(1),
+.IR pread(2),
+.IR pwrite(2)
+.SH BUGS
+Preserving the modification time of
+directories does not work. Attributes are
+cloned at directory creation time; meaning, if
+there's files to be copied in this directory,
+this will update the parent modification
+time. Furthermore, all directories get the
+forced write permission, since not having
+one would mean no new file creation.
--- a/clone.man1
+++ /dev/null
@@ -1,98 +1,0 @@
-.TH CLONE 1
-.SH NAME
-clone \- copy files and directories
-.SH SYNOPSYS
-.B clone
-[
-.B -gux
-]
-[
-.B -b
-.I blocksize
-]
-[
-.B -p
-.I fileprocs:blockprocs
-]
-.I from ... to
-.SH DESCRIPTION
-.I Clone
-copies files and directories.
-Similar in spirit to
-.IR fcp(1)
-it is a multi-process program which
-relies on
-.IR pread(2)
-and
-.IR pwrite(2)
-system calls to copy multiple blocks
-in parallel, speeding up the file transfer
-over high-latency links;
-in contrast to
-.IR fcp(1)
-it can copy both single files and directories,
-which may be mixed on the command line.
-.PP
-A single file is copied as expected. If
-.I to
-does not exist, it is created; otherwise, an
-existing file is overwritten; if
-.I to
-is a directory,
-.I from
-is copied into it.
-A single directory is copied into
-.I to
-if it exists; otherwise, a new directory
-.I to
-is created and the contents of
-.I from
-are copied into it.
-If multiple source files (directories) are given,
-they are copied into the
-.I to
-directory, which is created if neccessary.
-.PP
-The
-.I -x
-option sets the mode and modified time of the
-destination file (directory) to that of the source
-file (directory); the
-.I -g
-and
-.I -u
-try to set the group and user id, respectively.
-.PP
-The
-.I -b
-option determines the size of a block that
-will be transfered by a single block transfer
-process (defaults to 128k).
-.PP
-The
-.I -p
-option determines the process parallelism
-configuration, with
-.I fileprocs
-being the number of processes that handle
-simultaneous file transfers, and
-.I blockprocs
-being the number of processes that do the
-input / output (defaults to 4:16).
-.PP
-.SH SOURCE
-.B https://bitbucket.org/k-vik/clone
-.SH SEE ALSO
-.IR fcp(1),
-.IR dircp(1),
-.IR pread(2),
-.IR pwrite(2)
-.SH BUGS
-Preserving the modification time of
-directories does not work. Attributes are
-cloned at directory creation time; meaning, if
-there's files to be copied in this directory,
-this will update the parent modification
-time. Furthermore, all directories get the
-forced write permission, since not having
-one would mean no new file creation.
--- a/mkfile
+++ b/mkfile
@@ -3,15 +3,21 @@
TARG=clone
OFILES=clone.$O
BIN=/$objtype/bin
+MAN=/sys/man/1
</sys/src/cmd/mkone
README:
- troff -man -N -rL1000i clone.man1 | ssam 'x/\n\n\n+/c/\n\n/' >README
+ troff -man -N -rL1000i clone.man | ssam 'x/\n\n\n+/c/\n\n/' >README
+
+all: README
-install:V:
- cp clone.man1 /sys/man/1/clone
+install:V: man
uninstall:V:
rm -f $BIN/$TARG
- rm -f /sys/man/1/clone
+ rm -f $MAN/$TARG
+
+release:V: clean
+ tag=`{hg tags|awk 'NR==2{print $1}'}+ tar c . | gzip >/tmp/$TARG.$tag.tgz