layman.8.txt: Adds details regarding protocol filtering

1 files changed, 27 insertions, 4 deletions

diff --git a/doc/layman.8.txt b/doc/layman.8.txt
index ed9f6d0..fcbe86f 100644
--- a/doc/layman.8.txt
+++ b/doc/layman.8.txt
@@ -149,8 +149,8 @@ List of available *layman* path options.
     Path to additional overlay.xml files.
 
 
-OUTPUT OPTIONS:
-~~~~~~~~~~~~~~~
+OUTPUT OPTIONS
+~~~~~~~~~~~~~~
 List of *layman* output options.
 
 *--debug-level* 'DEBUG_LEVEL'::
@@ -195,6 +195,12 @@ List of *layman* output options.
     is capable of detecting the available number of columns automatically.
 
 
+ADDITIONAL OPTIONS
+~~~~~~~~~~~~~~~~~~
+*--protocol_filter*::
+    Sets the protocol filter that determines which protocols will be used
+    when adding overlays or updating their source URLs.
+
 CONFIGURATION
 -------------
 *layman* reads configuration parameters from the file
@@ -281,8 +287,8 @@ git_postsync::
     These are a space separated list of commands that are run after each add, sync operation if they
     are defined.
 
-*NEW*Repo Configuration options
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+REPO CONFIGURATION OPTIONS
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 *layman* now accepts multiple repository config file options. One being the
 already standard make.conf option and the other being the repos.conf files
@@ -341,6 +347,23 @@ the corresponding variable in the *layman* configuration file.
 *layman* will also respect the *http_proxy* environment variable in case you set it.
 
 
+FILTERING PROTOCOL URLS
+~~~~~~~~~~~~~~~~~~~~~~~
+When adding an overlay or updating its source URL you can specify which
+protocols you wish to use. Examples of this include http://, git://, and
+https://.
+
+To filter these protocols on a system-wide level you may alter the
+protocol_filter variable in your *layman* configuration file.
+
+Otherwise, you may specify which protocols you would prefer to be filtered out
+on a per-run basis using the *--protocol_filter* flag.
+
+Using this filtering will ensure that no other protocols other than the ones
+specified will be used. Meaning that if an overlay does not support any of
+the specified protocols, it will not install.
+
+
 LOCAL CACHE
 ~~~~~~~~~~~
 *layman* stores a local copy of the fetched remote list.