Commit 9b35bf2d7361c8e48dae1db630d8629292f8f577

Thomas de Grivel 2024-11-09T17:08:21

write a little more in README.md

diff --git a/README.md b/README.md
index e59a33f..96cfe85 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,29 @@ pattern matching, and a semantic object system. The idea is to plug
 modules, closures, pattern matching, a graph database and
 metaprogramming into C99 with an extremely small set of dependencies.
 
+The pure C11 `libkc3` library is a full KC3 parser and interpreter.
+
+`ikc3` is the interactive interpreter (verbose).
+
+`kc3s` is the script interpreter (same as ikc3 but terse).
+
+There are several C libraries which are installed in `lib/kc3/0.1`
+using the `make lib_links` command.
+
+There is a web server in httpd : `kc3_httpd`.
+
+All binaries can be compiled for four targets :
+ - __main__ : speed optimizations from GCC/Clang -O2 and
+   debug code like `assert` is disabled.
+ - __debug__ : no optimization and debug code like `assert` is enabled
+ - __cov__ : code coverage instrumentation (breaks `dlsym` and thus
+   all `Cfn` at the moment)
+ - __asan__ : memory safety instrumentation with ASAN, an absolutely
+   awesome tool to detect all memory leaks, double free, segmentation
+   faults, invalid read, invalid write, general memory corruption
+   errors, etc., just run the __asan__ target for a full report at
+   process exit, the report being empty if all is ok.
+
 Supported operating systems (additional dependencies) :
  - BSD
  - Linux (libbsd, libmd)
@@ -25,11 +48,18 @@ Supported architectures :
 To install and test KC3 for yourself, you can follow the
 [KC3 Installation Guide](https://kc3-lang.org/doc/3_Guides/3.1_Install).
 
-There are four programs now written in KC3 :
+## Users
+
+There are now four full applications written in KC3 that we know of :
  - The KC3 Cairo demo which you can run with `make demo`
  - The KC3 SDL2 OpenGL demo which you can run with `make demo_gl`
- - The [KC3 website](https://kc3-lang.org/) which you can launch locally with `make test_httpd`
- - The [www.kmx.io website](https://www.kmx.io/) which is closed source.
+ - The [KC3 website](https://kc3-lang.org/) which you can launch
+   locally with `make test_httpd` with all the KC3 releases and
+   documentation.
+ - The [www.kmx.io website](https://www.kmx.io/) which is closed
+   source and is hosted on kmx.io servers in France using OpenBSD
+   everywhere. We donate to OpenBSD every month because a healthy
+   software ecosystem is a funded ecosystem.
 
 
 ## New in this release