summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKaz Kylheku <kazkylheku@vtech.ca>2021-01-18 08:26:39 -0800
committerKaz Kylheku <kaz@kylheku.com>2021-01-18 08:26:39 -0800
commit1e081d603a1bf43b8a63d559a00aebb82a5bdb20 (patch)
tree8b2686999eefd88b0fa52f713a4c4dab521506e8
parent57f073a54a5ec99b1e5ca1dc2de8f25d05b0208a (diff)
downloadtxr-1e081d603a1bf43b8a63d559a00aebb82a5bdb20.tar.gz
txr-1e081d603a1bf43b8a63d559a00aebb82a5bdb20.tar.bz2
txr-1e081d603a1bf43b8a63d559a00aebb82a5bdb20.zip
doc: add warning to Pattern Matching section.
* txr.1: Pattern Matching is new. Though it works, the programmer-visible, documented requirements may have to be adjusted to make it better, and it would be nice to do that without caring about backward compatibility. In other words, the feature is currently in "beta": it is expected to be reliable, but the syntax and semantics are not written in stone.
-rw-r--r--txr.19
1 files changed, 9 insertions, 0 deletions
diff --git a/txr.1 b/txr.1
index 0430512e..775c5402 100644
--- a/txr.1
+++ b/txr.1
@@ -39548,6 +39548,15 @@ then there is no such binding: compound forms beginning with
do not undergo place macro expansion.
.SS* Structural Pattern Matching
+
+Warning: the following documentation describes new functionality appearing in
+\*(TX 247, which is in a "beta" state. Though the \*(TX project is committed to
+this feature, the detailed requirements documented here may change without
+maintaining backward compatibility. Programs relying on these features may
+require maintenance when upgrading to a newer version. When this situation
+changes in a future version of \*(TX, the manual for that version will no
+longer contain this notice.
+
\*(TL provides a structural pattern matching system. Structural pattern
matching is a syntax which allows for the succinct expression of code
which classifies objects according to their shape and content, and which