summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--ChangeLog31
-rw-r--r--doc/file.n43
2 files changed, 54 insertions, 20 deletions
diff --git a/ChangeLog b/ChangeLog
index 05bded1..a551846 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,34 @@
+1999-10-28 Jeff Hobbs <hobbs@scriptics.com>
+
+ * unix/aclocal.m4: made it just include tcl.m4
+
+ * library/tcltest1.0/tcltest.tcl: updated makeFile to return
+ full pathname of file created
+
+ * generic/tclStringObj.c: fixed Tcl_AppendResultVA so it only
+ iterates once over the va_list (avoiding a memcpy of it,
+ which is not portable).
+
+ * generic/tclEnv.c: fixed possible ABR error in environ array
+
+ * tests/scan.test:
+ * generic/tclScan.c: added support for use of inline scan,
+ XPG3 currently not included
+
+ * tests/incr.test:
+ * tests/set.test:
+ * generic/tclCompCmds.c: fixed improper bytecode handling of
+ 'eval {set array($unknownvar) 5}' (also for incr)
+
+ * win/tclWinTest.c: added testvolumetype command, as atime is
+ completely ignored for Windows FAT file systems
+ * win/tclWinPort.h: added sys/utime.h to includes
+ * unix/tclUnixPort.h: added utime.h to includes
+ * doc/file.n:
+ * tests/cmdAH.test:
+ * generic/tclCmdAH.c: added time arguments to atime and mtime
+ file command methods (support 'touch' functionality)
+
1999-10-20 Jeff Hobbs <hobbs@scriptics.com>
* unix/tclUnixNotfy.c: fixed event/io threading problems by
diff --git a/doc/file.n b/doc/file.n
index 11e599b..75821eb 100644
--- a/doc/file.n
+++ b/doc/file.n
@@ -5,7 +5,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: file.n,v 1.3 1999/08/19 02:58:34 hobbs Exp $
+'\" RCS: @(#) $Id: file.n,v 1.4 1999/10/29 03:03:40 hobbs Exp $
'\"
.so man.macros
.TH file n 8.3 Tcl "Tcl Built-In Commands"
@@ -26,13 +26,14 @@ substitution is done before executing the command (see the manual entry for
file name. Any unique abbreviation for \fIoption\fR is acceptable. The
valid options are:
.TP
-\fBfile atime \fIname\fR
+\fBfile atime \fIname\fR ?\fBtime\fR?
.
-Returns a decimal string giving the time at which file \fIname\fR
-was last accessed. The time is measured in the standard POSIX
-fashion as seconds from a fixed starting time (often January 1, 1970).
-If the file doesn't exist or its access time cannot be queried then an
-error is generated.
+Returns a decimal string giving the time at which file \fIname\fR was last
+accessed. If \fItime\fR is specified, it is an access time to set
+for the file. The time is measured in the standard POSIX fashion as
+seconds from a fixed starting time (often January 1, 1970). If the file
+doesn't exist or its access time cannot be queried or set then an error is
+generated. On Windows, FAT file systems do not support access time.
.TP
\fBfile attributes \fIname\fR
.br
@@ -195,13 +196,14 @@ no action is taken and no error is returned. Trying to overwrite an existing
file with a directory will result in an error. Arguments are processed in
the order specified, halting at the first error, if any.
.TP
-\fBfile mtime \fIname\fR
+\fBfile mtime \fIname\fR ?\fItime\fR?
.
-Returns a decimal string giving the time at which file \fIname\fR was
-last modified. The time is measured in the standard POSIX fashion as
-seconds from a fixed starting time (often January 1, 1970). If the file
-doesn't exist or its modified time cannot be queried then an error is
-generated.
+Returns a decimal string giving the time at which file \fIname\fR was last
+modified. If \fItime\fR is specified, it is a modification time to set for
+the file (equivalent to Unix \fBtouch\fR). The time is measured in the
+standard POSIX fashion as seconds from a fixed starting time (often January
+1, 1970). If the file doesn't exist or its modified time cannot be queried
+or set then an error is generated.
.TP
\fBfile nativename \fIname\fR
.
@@ -310,13 +312,14 @@ Returns a string giving the type of file \fIname\fR, which will be one of
.TP
\fBfile volume\fR
.
-Returns the absolute paths to the volumes mounted on the system, as a proper
-Tcl list. On the Macintosh, this will be a list of the mounted drives,
-both local and network. N.B. if two drives have the same name, they will
-both appear on the volume list, but there is currently no way, from Tcl, to
-access any but the first of these drives. On UNIX, the command will always return
-"/", since all filesystems are locally mounted. On Windows, it will return
-a list of the available local drives (e.g. {a:/ c:/}).
+Returns the absolute paths to the volumes mounted on the system, as a
+proper Tcl list. On the Macintosh, this will be a list of the mounted
+drives, both local and network. N.B. if two drives have the same name,
+they will both appear on the volume list, but there is currently no way,
+from Tcl, to access any but the first of these drives. On UNIX, the
+command will always return "/", since all filesystems are locally mounted.
+On Windows, it will return a list of the available local drives
+(e.g. {a:/ c:/}).
.TP
\fBfile writable \fIname\fR
.