[all-commits] [llvm/llvm-project] 446e3d: [llvm] [docs] Do not require recommonmark for manp...

[Michał Górny via All-commits]

  Branch: refs/heads/master
  Home:   https://github.com/llvm/llvm-project
  Commit: 446e3df25483312c8a7dfb3c53eef0de0e13074a
      https://github.com/llvm/llvm-project/commit/446e3df25483312c8a7dfb3c53eef0de0e13074a
  Author: Michał Górny <mgorny at gentoo.org>
  Date:   2020-07-07 (Tue, 07 Jul 2020)

  Changed paths:
    M llvm/cmake/modules/AddSphinxTarget.cmake
    M llvm/docs/conf.py

  Log Message:
  -----------
  [llvm] [docs] Do not require recommonmark for manpage build

Do not enforce recommonmark dependency if sphinx is called to build
manpages.  In order to do this, try to import recommonmark first
and do not configure it if it's not available.  Additionally, declare
a custom tags for the selected builder via CMake, and ignore
recommonmark import failure when 'man' target is used.

This will permit us to avoid the problematic recommonmark dependency
for the majority of Gentoo users that do not need to locally build
the complete documentation but want to have tool manpages.

Differential Revision: https://reviews.llvm.org/D83161