add strlcpy, remove estrlcat

[libcext.git] / README.md

diff --git a/README.md b/README.md
index 59cf6d6de00bd3017b5006185debb460e5ec1628..a5126fda69da03a2caf422fd3b627bee7f6e52cc 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,28 +1,61 @@
 A (WIP) collection of portable, strict C99, single-header implementations of common libc extensions.
 
+All functions are implemented as macros expanding to an internal function reference, this allows to use the headers with no meta build system - it compiles even if the extensions are already present, see _How to_ on disabling this behaviour.
+
 ### How to
 
 Include the header in every file needed as usual:
 
 ```
-#include "<ext-func-name.h>"
+#include "<ext-func-name>.h"
 ```
 
 In the file chosen for the function implementation:
 
 ```
-#define <EXT-FUNC-NAME>_IMPLEMENTATION_
+#define <EXT-FUNC-NAME>_IMPLEMENTATION
 #include "<ext-func-name.h>"
 ```
 
-By default, the header won't have any includes, change that with:
+By default, the header won't have any stdlib includes, change that with:
 
 ```
-#define <EXT-FUNC-NAME>_INCLUDE_LIBC_
+#define <EXT-FUNC-NAME>_INCLUDE_LIBC
 ```
 
-Or disable function override with:
+Or disable function, type and variable override with:
 
 ```
 #define HAVE_<EXT-FUNC-NAME>
 ```
+
+### Specifics
+
+---
+
+### asprintf
+
+includes `vasprintf()` and `asprintf()`
+
+---
+
+### getopt\_long
+
+includes `getopt()`, `getsubopt()`, `getopt_long()` and `getopt_long_only()`
+
+`getopt_long.h` has additional macros related to argument
+permuting, defining those enables it per function (GNU behaviour, can still be disabled at runtime by setting `$POSIXLY_CORRECT`):
+
+```
+#define GETOPT_PERMUTE_ARGS
+#define GETOPT_LONG_PERMUTE_ARGS
+#define GETOPT_LONG_ONLY_PERMUTE_ARGS
+```
+
+---
+
+### strlcat
+
+includes `strlcat()` and `strlcpy()`
+
+---