summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2012-09-11 20:11:40 -0700
committerKaz Kylheku <kaz@kylheku.com>2012-09-11 20:11:40 -0700
commite9902c952b488adf7de5c2464d416810ce222955 (patch)
treea7f7ef52a4fb344c1854a8d646cd98263aef9f67 /txr.1
parent46f607ae233a8f71c09d40dd45aae5f2ec7056fc (diff)
downloadtxr-e9902c952b488adf7de5c2464d416810ce222955.tar.gz
txr-e9902c952b488adf7de5c2464d416810ce222955.tar.bz2
txr-e9902c952b488adf7de5c2464d416810ce222955.zip
* configure: Added test for <sys/stat.h>
* eval.c: New intrinsic functions "stat" and "prop". * stream.c: Include <sys/stat.h> if we have it. (w_stat, statf): New functions. (val dev_k, ino_k, mode_k, nlink_k, uid_k, val gid_k, rdev_k, size_k, blksize_k, blocks_k; val atime_k, mtime_k, ctime_k): New sybol variables. (stream_init): Intern new keywords symbols. * stream.h (statf): Declared. * txr.1: prop documented. Stub for stat created.
Diffstat (limited to 'txr.1')
-rw-r--r--txr.126
1 files changed, 26 insertions, 0 deletions
diff --git a/txr.1 b/txr.1
index c4ede065..23af993b 100644
--- a/txr.1
+++ b/txr.1
@@ -6947,6 +6947,30 @@ cell of the input alist. That is to say, each element of the output list
is produced as if by the copy-cons function applied to the corresponding
element of the input list.
+.SH PROPERTY LISTS
+
+.SS Function prop
+
+.TP
+Syntax:
+
+ (prop <plist> <key>)
+
+.TP
+Description:
+
+A property list a flat list of even length consisting of interleaved
+pairs of property names (usually symbols) and their values (arbitrary
+objects). An example property list is (:a 1 :b "two") which contains
+two properties, :a having value 1, and :b having value "two".
+
+The prop function searches property list <plist> for key <key>. If
+the key is found, then the value next to it is returned. Otherwise
+nil is returned.
+
+It is ambiguous whether nil is returned due to the property not being
+found, or due to the property being present with a nil value.
+
.SH LIST SORTING
.SS Function merge
@@ -9437,6 +9461,8 @@ meaningful, it does nothing.
.SH FILESYSTEM ACCESS
+.SS Function stat
+
.SS Function open-directory
.SS Functions open-file