The buildbot scripts have an explicit dependency on the datarel package, which we'd like to remove from the stack. It uses datarel as the top-level product when building the cross-linked HTML documentation; lsstDoxygen's makeDocs script takes a single package, and generates the list of packages to include in the Doxygen build by finding all dependencies of that package.
So, to remove the explicit dependency on datarel, we need to either:
- find a new top-level product with a Doxygen build to pass to makeDocs (e.g. by adding a trivial Doxygen build to lsst_distrib)
- modify the argument parsing in lsstDoxygen to take a list of multiple products (it looks like the limitation to one package is only in the argument parsing), and pass it a list of top-level products in the buildbot scripts.
This is currently a blocker for
DM-2928, which itself a blocker for DM-1766, which has now been lingering for a few weeks now. I'm going to look for other ways to remove the block on the latter, but I don't have a solution yet.