From d1c6182fa2e288faaf1f7c0421fdae9a19e57d8d Mon Sep 17 00:00:00 2001
From: Kefu Chai <kchai@redhat.com>
Date: Sun, 18 Apr 2021 00:39:41 +0800
Subject: [PATCH] doc/_ext: render see_also field

Signed-off-by: Kefu Chai <kchai@redhat.com>
---
 doc/_ext/ceph_confval.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/_ext/ceph_confval.py b/doc/_ext/ceph_confval.py
index 8899542306482..89aa6a22f7352 100644
--- a/doc/_ext/ceph_confval.py
+++ b/doc/_ext/ceph_confval.py
@@ -50,6 +50,9 @@ TEMPLATE = '''
 {%- elif opt.max is defined %}
    :max: ``{{ opt.max }}``
 {%- endif %}
+{%- if opt.see_also %}
+   :see also: {{ opt.see_also | map('ref_confval') | join(', ') }}
+{%- endif %}
 {% if opt.note %}
    .. note::
       {{ opt.note }}
@@ -128,12 +131,17 @@ def literal(name) -> str:
         return f'<empty string>'
 
 
+def ref_confval(name) -> str:
+    return f':confval:`{name}`'
+
+
 def jinja_template() -> jinja2.Template:
     env = jinja2.Environment()
     env.filters['eval_size'] = eval_size
     env.filters['readable_duration'] = readable_duration
     env.filters['readable_num'] = readable_num
     env.filters['literal'] = literal
+    env.filters['ref_confval'] = ref_confval
     return env.from_string(TEMPLATE)
 
 
-- 
2.39.5