From 03eac4f0b87bb9393e1662af76c433c996c702ab Mon Sep 17 00:00:00 2001
From: Marek Blaha <mblaha@redhat.com>
Date: Tue, 14 Jul 2020 08:37:28 +0200
Subject: [PATCH] [doc] Enhance repo variables documentation
 (RhBug:1848161,1848615)

- clarify DNF_VAR_XXX variables usage
- mention numeric variables

https://bugzilla.redhat.com/show_bug.cgi?id=1848615
https://bugzilla.redhat.com/show_bug.cgi?id=1848161
---
 doc/conf_ref.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/conf_ref.rst b/doc/conf_ref.rst
index fdb44a657d..a0362d0779 100644
--- a/doc/conf_ref.rst
+++ b/doc/conf_ref.rst
@@ -629,6 +629,21 @@ In addition to these hard coded variables, user-defined ones can also be used. T
 
     $ DNF_VAR_MY_VARIABLE=value
 
+To use such variable in your repository configuration remove the prefix. E.g.::
+
+    [myrepo]
+    baseurl=https://example.site/pub/fedora/$MY_VARIABLE/releases/$releasever
+
+Note that it is not possible to override the ``arch`` and ``basearch`` variables using either variable files or environmental variables.
+
+Although users are encouraged to use named variables, the numbered environmental variables ``DNF0`` - ``DNF9`` are still supported::
+
+    $ DNF1=value
+
+    [myrepo]
+    baseurl=https://example.site/pub/fedora/$DNF1/releases/$releasever
+
+
 .. _conf_main_and_repo_options-label:
 
 ==================================