This is an archive of the discontinued LLVM Phabricator instance.

Differential D91116

Add flang docs to SphinxDocsBuilder.
ClosedPublic

Authored by andreil99 on Nov 9 2020, 8:11 PM.

Details

Reviewers
gkistanova
jdoerfert
sscalpone
Commits
rZORG1d80d949d0da: Add flang docs to SphinxDocsBuilder.
Summary

Since flang Sphinx docs are buildable, we can expand SphinxDocsBuilder to build and publish.

Require
sphinx==1.8.5
sphinx-markdown-tables==0.0.14
recommonmark==0.6.0

Diff Detail

Event Timeline

andreil99 created this revision.Nov 9 2020, 8:11 PM
Herald added a reviewer: sscalpone. · View Herald TranscriptNov 9 2020, 8:11 PM
andreil99 requested review of this revision.Nov 9 2020, 8:11 PM
gkistanova accepted this revision.Nov 9 2020, 9:18 PM

LGTM

This revision is now accepted and ready to land.Nov 9 2020, 9:18 PM
andreil99 updated this revision to Diff 304376.Nov 10 2020, 7:00 PM
Closed by commit rZORG1d80d949d0da: Add flang docs to SphinxDocsBuilder. (authored by andreil99). · Explain WhyNov 10 2020, 7:10 PM
This revision was automatically updated to reflect the committed changes.
andreil99 added a commit: rZORG1d80d949d0da: Add flang docs to SphinxDocsBuilder..

Revision Contents

PathSize
zorg/
buildbot/
builders/
2 lines

Diff 304381

zorg/buildbot/builders/SphinxDocsBuilder.py

Show All 9 Linesllvm_docs = OrderedDict([
# Project Build target Local path Remote path # Project Build target Local path Remote path
("llvm", ("docs-llvm-html", "docs/html/", "llvm")), ("llvm", ("docs-llvm-html", "docs/html/", "llvm")),
("clang", ("docs-clang-html", "tools/clang/docs/html/", "cfe")), ("clang", ("docs-clang-html", "tools/clang/docs/html/", "cfe")),
("clang-tools-extra", ("docs-clang-tools-html", "tools/clang/tools/extra/docs/html/", "clang-tools-extra")), ("clang-tools-extra", ("docs-clang-tools-html", "tools/clang/tools/extra/docs/html/", "clang-tools-extra")),
("libcxx", ("docs-libcxx-html", "projects/libcxx/docs/html/", "libcxx")), ("libcxx", ("docs-libcxx-html", "projects/libcxx/docs/html/", "libcxx")),
("libunwind", ("docs-libunwind-html", "projects/libunwind/docs/html/", "libunwind")), ("libunwind", ("docs-libunwind-html", "projects/libunwind/docs/html/", "libunwind")),
("lld", ("docs-lld-html", "tools/lld/docs/html/", "lld")), ("lld", ("docs-lld-html", "tools/lld/docs/html/", "lld")),
("lldb", ("docs-lldb-html", "tools/lldb/docs/html/", "lldb")), ("lldb", ("docs-lldb-html", "tools/lldb/docs/html/", "lldb")),
('flang', ("docs-flang-html", "tools/flang/docs/html/", "flang")),
("openmp", ("docs-openmp-html", "projects/openmp/docs/html/", "openmp")), ("openmp", ("docs-openmp-html", "projects/openmp/docs/html/", "openmp")),
("polly", ("docs-polly-html", "tools/polly/docs/html/", "polly")), ("polly", ("docs-polly-html", "tools/polly/docs/html/", "polly")),
]) ])
def getSphinxDocsBuildFactory( def getSphinxDocsBuildFactory(
llvm_html = False, # Build LLVM HTML documentation llvm_html = False, # Build LLVM HTML documentation
llvm_man = False, # Build LLVM man pages llvm_man = False, # Build LLVM man pages
▲ Show 20 Lines • Show All 127 Lines • ▼ Show 20 Lines if depends_on_projects is None:
"llvm", "llvm",
"clang", "clang",
"clang-tools-extra", "clang-tools-extra",
"libcxx", "libcxx",
"libcxxabi", "libcxxabi",
"libunwind", "libunwind",
"lld", "lld",
"lldb", "lldb",
"flang",
"openmp", "openmp",
"polly", "polly",
] ]
else: else:
# Make a local copy of depends_on_projects, as we are going to modify # Make a local copy of depends_on_projects, as we are going to modify
# that. # that.
_depends_on_projects=depends_on_projects[:] _depends_on_projects=depends_on_projects[:]
# Some projects are interdependent for the purpose of documentation. # Some projects are interdependent for the purpose of documentation.
▲ Show 20 Lines • Show All 80 Lines • Show Last 20 Lines