From 9e9513462ff0f82854dbc9d3f8bd42cd2ed8766e Mon Sep 17 00:00:00 2001
From: Kaz Kylheku <kaz@kylheku.com>
Date: Wed, 15 Apr 2020 11:40:23 -0700
Subject: New function: touch.

* lisplib.c (copy_file_set_entries): Register autoload for
touch.

* share/txr/stdlib/copy-file.tl (touch): New function.

* txr.1: Documented.
---
 txr.1 | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

(limited to 'txr.1')

diff --git a/txr.1 b/txr.1
index 102a6a74..c02d7fb3 100644
--- a/txr.1
+++ b/txr.1
@@ -59197,6 +59197,37 @@ and
 allowing the caller to retry individual failed operations or skip the objects
 on which operations have failed.
 
+.coNP Function @ touch
+.synb
+.mets (touch < path <> [ ref-path ])
+.syne
+.desc
+The
+.code touch
+function updates the modification timestamp of the filesystem object
+named by
+.metn path .
+If the object doesn't exist, it is created as a regular file.
+
+If
+.meta ref-path
+is specified, then the modification timestamp of the object denoted by
+.meta path
+is updated to be equivalent to the modification timestamp of
+the object denoted by
+.metn ref-path .
+Otherwise
+.meta ref-path
+being absent, the modification timestamp of
+.meta path
+is set to the current time.
+
+If
+.meta path
+is a symbolic link, it is dereferenced;
+.code touch
+operates on the target of the link.
+
 .SS* Unix Filesystem Object Existence, Type and Access Tests
 
 Functions in this category perform various tests on the attributes of
-- 
cgit v1.2.3