From 1e081d603a1bf43b8a63d559a00aebb82a5bdb20 Mon Sep 17 00:00:00 2001 From: Kaz Kylheku Date: Mon, 18 Jan 2021 08:26:39 -0800 Subject: 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. --- txr.1 | 9 +++++++++ 1 file changed, 9 insertions(+) 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 -- cgit v1.2.3