Gentoo Archives: gentoo-dev

From: Andrew Ammerlaan <andrewammerlaan@g.o>
To: gentoo-dev@l.g.o
Subject: [gentoo-dev] [PATCH 0/2] docs.eclass: allow multiple documentation builders and support initializing git
Date: Thu, 10 Nov 2022 11:29:07
Message-Id: ed565cfa-9e1a-bb00-b1be-44b056874260@gentoo.org
1 Hi all,
2
3 This first patch allows for using multiple documentation builders in one
4 ebuild. This is a use case I initially hadn't considered, but has now
5 already shown up twice (in the form of doxygen + python? ( sphinx )).
6 Simply moving where we define default values of some variables is enough
7 to make this work. Also in the patch is an example of how this can work
8 in net-libs/xrootd.
9
10 The second patch adds a helper function to initialize a git repository
11 in $S. This is sometimes required for successfully building the
12 documentation (mostly required for some mkdocs packages). Also in this
13 patch is an example of how this can work in
14 dev-python/mkdocs-git-revision-date-localized-plugin (note that here we
15 have to manually call this function if USE="test" as well).
16
17 Let me know what you think.
18
19 Best regards,
20 Andrew