aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichał Łyszczek <michal.lyszczek@bofc.pl>2018-01-26 17:21:16 +0100
committerMichał Łyszczek <michal.lyszczek@bofc.pl>2018-01-26 17:21:16 +0100
commit2284d247d46df21d63342cd886050fe3a8b61a64 (patch)
tree628c53df6d43ec38272f1515a154d7283497f4be
parent829454e647f6333e02b32f19728764e7fbeea66f (diff)
downloadembedlog-2284d247d46df21d63342cd886050fe3a8b61a64.tar.gz
embedlog-2284d247d46df21d63342cd886050fe3a8b61a64.tar.bz2
embedlog-2284d247d46df21d63342cd886050fe3a8b61a64.zip
doc update
-rw-r--r--INSTALL2
-rw-r--r--readme.md71
2 files changed, 72 insertions, 1 deletions
diff --git a/INSTALL b/INSTALL
index 39be745..8c6431a 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,4 +1,4 @@
-$ autoreconf -i (if ./configure doesn't exist)
+$ ./autogen.sh (if ./configure doesn't exist)
$ ./configure
$ make
# make install
diff --git a/readme.md b/readme.md
index 0a7f585..3632ea8 100644
--- a/readme.md
+++ b/readme.md
@@ -113,6 +113,77 @@ $ cd examples
$ make
~~~
+Build time options
+==================
+
+Many features can be disabled to save space and ram. While this may not be
+neccessary to change on big operating systems such as **linux** or **freebsd**,
+it may come in handy when compiling for very small embedded systems. All options
+are passed to configure script in common way **./configure --enable-_feature_**.
+Run **./configure --help** to see help on that matter. For all **--enable**
+options it is also valid to pass **--disable**. All enabled options can be later
+disabled in runtime.
+
+--enable-out-stderr (default: enable)
+-------------------------------------
+
+When set, library will be able to print logs to standard error output. Nothing
+fancy.
+
+--enable-out-file (default: enable)
+-----------------------------------
+
+Allows to configure logger to print logs to file. Optional file rotation can be
+enabled. Number of rotation files and maximum size of rotation log file can be
+defined in runtime
+
+--enable-out-custom (default: enable)
+-------------------------------------
+
+Allows to pas own function which will receive fully constructed message to print
+as **const char \***. Usefull when there is no output facility that suits your
+needs.
+
+--enable-timestamp
+------------------
+
+When enabled, logger will be able to add timestamp to every message. Timestamp
+can be in short or long format and timer source can be configured. Check out
+[man page](http://embedlog.kurwinet.pl/manuals/el_option.3.html) to read more
+about it.
+
+--enable-realtime, --enable-monotonic (default: enable)
+-------------------------------------------------------
+
+Allows to use better precision timers - **CLOCK_REALTIME** and
+**CLOCK_MONOTONIC** but requires **POSIX**
+
+
+--enable-finfo (default: enable)
+--------------------------------
+
+When enabled, information about line and file name from where log originated
+will be added to each message.
+
+--enable-colors (default: enable)
+---------------------------------
+
+If enabled, output logs can be colored depending on their level. Good for
+quick error spotting.
+
+--enable-reentrant (default: enable)
+------------------------------------
+
+Uses reentrant functions where possible. Not available on every platform, but
+if enabled, provides thread-safety on line level - that means, lines won't
+overlap with another thread
+
+--enable-portable-snprintf (default: disable)
+---------------------------------------------
+
+When enabled, library will use internal implementation of **snprintf** even if
+**snprintf** is provided by the operating system.
+
Contact
=======