1 files changed, 29 insertions, 4 deletions
diff --git a/libraries/skalibs/README b/libraries/skalibs/README
index 4a5597a7b3..2bb7aa0577 100644
--- a/libraries/skalibs/README
+++ b/libraries/skalibs/README
@@ -6,7 +6,32 @@ is that you won't have to download and compile big libraries, and care
 about portability issues, everytime you need to build a package: do it
 only once.
 
-skalibs can also be used as a sound basic start for C
-development. There are a lot of general-purpose libraries out there;
-but if your main goal is to produce small and secure C code with a
-focus on system programming, skalibs might be for you.
+skalibs can also be used as a sound basic start for C development.
+There are a lot of general-purpose libraries out there; but if your
+main goal is to produce small and secure C code with a focus on system
+programming, skalibs might be for you.
+
+NOTE:
+Upstream recommends building skarnet.org softwares with static libraries
+as most of skarnet.org softwares are small enough that using shared
+libraries are generally not worth using. Therefore, the SlackBuild
+script will only build the static libraries by default.
+
+If you want to also build the shared libraries, pass BUILD_SHARED=yes
+environment variable to the script like below:
+
+    BUILD_SHARED=yes ./skalibs.SlackBuild
+
+Similarly, to avoid building the static libraries, you can pass
+BUILD_STATIC=no to the script. For example, to only build the shared
+libraries and not the static ones, you can do something like
+
+    BUILD_SHARED=yes BUILD_STATIC=no ./skalibs.SlackBuild
+
+If you just want to build and use skarnet.org softwares, building only
+the static libraries should be sufficient.
+
+Also, the execvep() function from skalibs (used by all skarnet.org
+softwares) has a default executable search path that will be used if the
+PATH environment variable is undefined. The default is /usr/bin:/bin.
+Pass DEF_PATH=some:path:list to the script if you want to change it.