[doc] Change description of skip_if_unavailable option (#1358)

rpm-software-management · May 15, 2019 · 1d97351 · 1d97351
1 parent 30fa505
commit 1d97351
Show file tree

Hide file tree

Showing 3 changed files with 19 additions and 8 deletions.
diff --git a/doc/api_conf.rst b/doc/api_conf.rst
@@ -182,6 +182,12 @@ Configurable settings of the :class:`dnf.Base` object are stored into a :class:`
 
     Number of times any attempt to retrieve a file should retry before returning an error. Setting this to `0` makes it try forever. Defaults to `10`.
 
+  .. attribute:: skip_if_unavailable
+
+    If enabled, DNF will continue running and disable the repository that couldn't be synchronized
+    for any reason. This option doesn't affect skipping of unavailable packages after dependency
+    resolution. The default is ``False``.
+
   .. attribute:: sslcacert
 
     Path to the directory or file containing the certificate authorities to verify SSL certificates.

diff --git a/doc/api_repos.rst b/doc/api_repos.rst
@@ -164,7 +164,9 @@ Repository Configuration
 
   .. attribute:: skip_if_unavailable
 
-    If enabled, DNF will continue running and disable the repository that couldn't be contacted for any reason when downloading metadata. This option doesn't affect skipping of unavailable packages after dependency resolution. The default is ``True``.
+    If enabled, DNF will continue running and disable the repository that couldn't be synchronized
+    for any reason. This option doesn't affect skipping of unavailable packages after dependency
+    resolution. The default is inherited from :attr:`dnf.conf.Conf.skip_if_unavailable`.
 
   .. attribute:: sslcacert
 

diff --git a/doc/conf_ref.rst b/doc/conf_ref.rst
@@ -364,13 +364,6 @@ or :ref:`mirrorlist <mirrorlist-label>` option definition.
 
     Overrides the retries option from the [main] section for this repository.
 
-.. _skip_if_unavailable-label:
-
-``skip_if_unavailable``
-    :ref:`boolean <boolean-label>`
-
-    If enabled, DNF will continue running and disable the repository that couldn't be contacted for any reason when downloading metadata. This option doesn't affect skipping of unavailable packages after dependency resolution. To check inaccessibility of repository use it in combination with :ref:`refresh command line option <refresh_command-label>`. The default is True.
-
 .. _strict-label:
 
 ``strict``
@@ -551,6 +544,16 @@ configuration.
 
     Set the number of times any attempt to retrieve a file should retry before returning an error. Setting this to `0` makes dnf try forever. Default is `10`.
 
+.. _skip_if_unavailable-label:
+
+``skip_if_unavailable``
+    :ref:`boolean <boolean-label>`
+
+    If enabled, DNF will continue running and disable the repository that couldn't be synchronized
+    for any reason. This option doesn't affect skipping of unavailable packages after dependency
+    resolution. To check inaccessibility of repository use it in combination with
+    :ref:`refresh command line option <refresh_command-label>`. The default is ``False``.
+
 .. _sslcacert-label:
 
 ``sslcacert``