aboutsummaryrefslogtreecommitdiff
path: root/devel/sfsexp/pkg-descr
diff options
context:
space:
mode:
authorJoseph Mingrone <jrm@FreeBSD.org>2021-10-24 00:42:15 +0000
committerJoseph Mingrone <jrm@FreeBSD.org>2021-10-24 02:49:00 +0000
commit32784eda79bb2dceb4ae74f6ac2acc9b6ae46935 (patch)
treea9b3605c412f970f65d91a79cabae103aa7e9a53 /devel/sfsexp/pkg-descr
parent58a766e89fa983048907cbfa02aebcd4a0fa2251 (diff)
downloadports-32784eda79bb2dceb4ae74f6ac2acc9b6ae46935.tar.gz
ports-32784eda79bb2dceb4ae74f6ac2acc9b6ae46935.zip
devel/sfsexp: New port: Small Fast S-Expression Library
Diffstat (limited to 'devel/sfsexp/pkg-descr')
-rw-r--r--devel/sfsexp/pkg-descr23
1 files changed, 23 insertions, 0 deletions
diff --git a/devel/sfsexp/pkg-descr b/devel/sfsexp/pkg-descr
new file mode 100644
index 000000000000..f5a802a81115
--- /dev/null
+++ b/devel/sfsexp/pkg-descr
@@ -0,0 +1,23 @@
+The sfsexp library is intended for developers who wish to manipulate
+(read, parse, modify, and create) symbolic expressions from C or C++
+programs. A symbolic expression, or s-expression, is essentially a
+LISP-like expression such as (a (b c)). S-expressions are able to
+represent complex, structured data without requiring additional
+meta-data describing the structure. They are recursively defined: an
+s-expression is a list of either atoms or s-expressions. In the example
+above, the expression contains an atom "a" and an s-expression, which in
+turn contains two atoms, "b" and "c". They are simple, useful, and well
+understood.
+
+This library is designed to provide a minimal set of functions and data
+structures for the four functions listed above: reading s-expressions
+(I/O), parsing strings containing them into an AST equivalent, modifying
+the AST representation, and converting the AST back into a well
+formatted string. The primary goals are efficiency and simplicity. This
+library forms the basis of the data representation and transmission
+protocol for the Supermon high-speed cluster monitoring system from the
+LANL Advanced Computing Laboratory. The usefulness and lack of choice in
+available, open source s-expression libraries around 2003 motivated the
+independent (from supermon) release of this library.
+
+WWW: https://github.com/mjsottile/sfsexp