From 852e0fd4eb86d4ca4fbd72ef22951955c70c7e9c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fran=C3=A7ois=20Bissey?= <frp.bissey@gmail.com>
Date: Wed, 27 Dec 2023 14:21:00 +1300
Subject: [PATCH] sage-git.eclass: Document git-r3 variables used.

---
 eclass/sage-git.eclass | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/eclass/sage-git.eclass b/eclass/sage-git.eclass
index 034bf3e3c..1f28224b3 100644
--- a/eclass/sage-git.eclass
+++ b/eclass/sage-git.eclass
@@ -24,11 +24,24 @@ BDEPEND="
 	dev-python/build[${PYTHON_USEDEP}]
 "
 
-# Standard sage git repo definition. This can be overriden the usual way.
+# Standard git-r3 variables for ebuild using sage-git
+
+# @VARIABLE: EGIT_REPO_URI
+# @REQUIRED
+# @DESCRIPTION:
+# This variable is from git-r3 eclass, we set to the default
+# git repo for sagemath. It can be overriden the usual git-r3
+# way, to test a PR branch for example.
 EGIT_REPO_URI="https://github.com/sagemath/sage.git"
+
+# @VARIABLE: EGIT_BRANCH
+# @REQUIRED
+# @DESCRIPTION:
+# This variable is from git-r3 eclass, we set to the default
+# develop git branch used for sagemath. It can be overriden
+# the usual git-r3 way, to test a PR branch for example.
 EGIT_BRANCH=develop
 
-# Standard variables for ebuild using sage-git
 # @VARIABLE: EGIT_CHECKOUT_DIR
 # @REQUIRED
 # @DESCRIPTION: