--- a/README.options.md	Sun Mar 10 09:26:16 2019 +0100
+++ b/README.options.md	Sun Mar 10 09:44:42 2019 +0100
@@ -5,20 +5,19 @@
 
 Use the following predefined options before creating your own.
 
-- PULSEAUDIO: control PulseAudio support
 - BLUETOOTH: control bluetooth support
-- DEBUG: build with debug symbols
-- DOCS: control documentation (what you see in /usr/share/doc)
-- MAN: control manual pages
-- NLS: control native language support
 - DBUS: control D-Bus support
-- QT5: control Qt 5 toolkit support
+- DEBUG: build with debug symbols
 - GTK3: control Gtk 3 toolkit support
-- PKGCONFIG: control installation of pkg-config files
-- CMAKE: control installation of CMake configuration files
-- ZSH: control installation of zsh completion files
-- BASH: control installation of bash completion files
-- SSL: use SSL/TLS (implementation defined)
+- NLS: control native language support
+- PAM: support for PAM
+- PULSEAUDIO: control PulseAudio support
+- QT5: control Qt 5 toolkit support
+- SSL: use SSL/TLS, some packages offer several choices (e.g. openssl, gnutls)
+
+Those options should only change the package behaviour, for example: manual
+pages or any other resource files that are not strictly required; they must be
+installed and the user may exclude them via `vpk` instead.
 
 The following options should be available for any package that builds C or C++
 code: