commit: c026339af5fa6506714bf7533171bdd41478bedb
Author: Devan Franchini <twitch153 <AT> gentoo <DOT> org>
AuthorDate: Fri Mar 27 23:39:42 2015 +0000
Commit: Devan Franchini <twitch153 <AT> gentoo <DOT> org>
CommitDate: Fri Mar 27 23:41:24 2015 +0000
URL: https://gitweb.gentoo.org/proj/layman.git/commit/?id=c026339a
layman.8.txt: Adds details regarding protocol filtering
doc/layman.8.txt | 31 +++++++++++++++++++++++++++----
1 file 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.
