[all-commits] [llvm/llvm-project] de42f4: [docs] Release man pages (#201376)

Tue Jun 9 09:59:08 PDT 2026

  Branch: refs/heads/main
  Home:   https://github.com/llvm/llvm-project
  Commit: de42f4f2130183111d4d62865177190d6e642ade
      https://github.com/llvm/llvm-project/commit/de42f4f2130183111d4d62865177190d6e642ade
  Author: Konrad Kleine <kkleine at redhat.com>
  Date:   2026-06-09 (Tue, 09 Jun 2026)

  Changed paths:
    M .github/workflows/release-documentation.yml
    M .github/workflows/release-doxygen.yml
    M .github/workflows/release-tasks.yml
    M llvm/utils/release/build-docs.sh

  Log Message:
  -----------
  [docs] Release man pages (#201376)

This adds the possibility to generate man pages from the `llvm/utils/release/build-docs.sh` script. Furthermore the `release-documentation` github workflow was modified to build and upload the man pages.

This was done to prevent dependency problems when myst-parser will become a hard dependency to build the documentation in LLVM. See https://discourse.llvm.org/t/rfc-make-myst-markdown-the-llvm-docs-format-rip-rest/90840/26?u=kwk

Additionally the `build-docs.sh` script now determines the release from the source directory if no release was given. Otherwise the generated tarballs would be missing the release entirely. To make it clear that something was generated from any git directory, a short git revision will be attached to the release (e.g. `23.0.0-gc823de88d51f58`).

The script generates a total of 67 man pages for the 22.1.7 release (see below).

`lld` has their own man page hardcoded in [`lld/docs/ld.lld.1`](https://github.com/llvm/llvm-project/blob/main/lld/docs/ld.lld.1). It gets packaged manually because of a missing cmake target. To get all projects install their man pages in the same directory to package up, we have to run the install targets rather than just the build targets (e.g. `install-docs-clang-man` instead of just `docs-clang-man`).

Here's what's in the tarball for the `22.1.7` release when you run the script from this change:

```console
$ rm -rf llvm_man_pages-* docs-build llvm-project
$ ./llvm/utils/release/build-docs.sh  -no-sphinx  -no-doxygen -release 22.1.7
```

```console
$ tar -tf llvm_man_pages-22.1.7.tar.xz 
llvm_man_pages-22.1.7/
llvm_man_pages-22.1.7/polly.1
llvm_man_pages-22.1.7/lldb.1
llvm_man_pages-22.1.7/lldb-server.1
llvm_man_pages-22.1.7/extraclangtools.1
llvm_man_pages-22.1.7/flang.1
llvm_man_pages-22.1.7/clang.1
llvm_man_pages-22.1.7/diagtool.1
llvm_man_pages-22.1.7/FileCheck.1
llvm_man_pages-22.1.7/bugpoint.1
llvm_man_pages-22.1.7/clang-tblgen.1
llvm_man_pages-22.1.7/dsymutil.1
llvm_man_pages-22.1.7/lit.1
llvm_man_pages-22.1.7/llc.1
llvm_man_pages-22.1.7/lldb-tblgen.1
llvm_man_pages-22.1.7/lli.1
llvm_man_pages-22.1.7/llvm-addr2line.1
llvm_man_pages-22.1.7/llvm-ar.1
llvm_man_pages-22.1.7/llvm-as.1
llvm_man_pages-22.1.7/llvm-bcanalyzer.1
llvm_man_pages-22.1.7/llvm-cgdata.1
llvm_man_pages-22.1.7/llvm-config.1
llvm_man_pages-22.1.7/llvm-cov.1
llvm_man_pages-22.1.7/llvm-cxxfilt.1
llvm_man_pages-22.1.7/llvm-cxxmap.1
llvm_man_pages-22.1.7/llvm-debuginfo-analyzer.1
llvm_man_pages-22.1.7/llvm-diff.1
llvm_man_pages-22.1.7/llvm-dis.1
llvm_man_pages-22.1.7/llvm-dwarfdump.1
llvm_man_pages-22.1.7/llvm-dwarfutil.1
llvm_man_pages-22.1.7/llvm-exegesis.1
llvm_man_pages-22.1.7/llvm-extract.1
llvm_man_pages-22.1.7/llvm-ifs.1
llvm_man_pages-22.1.7/llvm-install-name-tool.1
llvm_man_pages-22.1.7/llvm-ir2vec.1
llvm_man_pages-22.1.7/llvm-lib.1
llvm_man_pages-22.1.7/llvm-libtool-darwin.1
llvm_man_pages-22.1.7/llvm-link.1
llvm_man_pages-22.1.7/llvm-lipo.1
llvm_man_pages-22.1.7/llvm-locstats.1
llvm_man_pages-22.1.7/llvm-mc.1
llvm_man_pages-22.1.7/llvm-mca.1
llvm_man_pages-22.1.7/llvm-nm.1
llvm_man_pages-22.1.7/llvm-objcopy.1
llvm_man_pages-22.1.7/llvm-objdump.1
llvm_man_pages-22.1.7/llvm-offload-binary.1
llvm_man_pages-22.1.7/llvm-opt-report.1
llvm_man_pages-22.1.7/llvm-otool.1
llvm_man_pages-22.1.7/llvm-pdbutil.1
llvm_man_pages-22.1.7/llvm-profdata.1
llvm_man_pages-22.1.7/llvm-profgen.1
llvm_man_pages-22.1.7/llvm-ranlib.1
llvm_man_pages-22.1.7/llvm-readelf.1
llvm_man_pages-22.1.7/llvm-readobj.1
llvm_man_pages-22.1.7/llvm-reduce.1
llvm_man_pages-22.1.7/llvm-remarkutil.1
llvm_man_pages-22.1.7/llvm-size.1
llvm_man_pages-22.1.7/llvm-stress.1
llvm_man_pages-22.1.7/llvm-strings.1
llvm_man_pages-22.1.7/llvm-strip.1
llvm_man_pages-22.1.7/llvm-symbolizer.1
llvm_man_pages-22.1.7/llvm-tblgen.1
llvm_man_pages-22.1.7/llvm-test-mustache-spec.1
llvm_man_pages-22.1.7/llvm-tli-checker.1
llvm_man_pages-22.1.7/mlir-tblgen.1
llvm_man_pages-22.1.7/opt.1
llvm_man_pages-22.1.7/tblgen.1
llvm_man_pages-22.1.7/ld.lld.1
```

To unsubscribe from these emails, change your notification settings at https://github.com/llvm/llvm-project/settings/notifications