diff options
| author | Johannes Schindelin <johannes.schindelin@gmx.de> | 2019-04-18 13:16:44 (GMT) |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2019-04-19 05:03:24 (GMT) |
| commit | faa7a096d87f188cb8bb2cc1c21f80c91817ce64 (patch) | |
| tree | 57166f0fdeaeb2b7257a91dbd20d429b785340f4 /Documentation | |
| parent | 7c3bd713b1f4872e4fc95397e6845b7f9e0b89a5 (diff) | |
| download | git-faa7a096d87f188cb8bb2cc1c21f80c91817ce64.zip git-faa7a096d87f188cb8bb2cc1c21f80c91817ce64.tar.gz git-faa7a096d87f188cb8bb2cc1c21f80c91817ce64.tar.bz2 | |
docs: exclude documentation for commands that have been excluded
When building with certain build options, some commands are excluded
from the build. For example, `git-credential-cache` is skipped when
building with `NO_UNIX_SOCKETS`.
Let's not build or package documentation for those excluded commands.
This issue was pointed out rightfully when running `make check-docs` on
Windows, where we do not yet have Unix sockets, and therefore the
`credential-cache` command is excluded (yet its documentation was built
and shipped).
Note: building the documentation via `make -C Documentation` leaves the
build system with no way to determine which commands have been
excluded. If called thusly, we gracefully fail to exclude their
documentation. Only when building the documentation via the top-level
Makefile will it get excluded properly, or after building
`Documentation/GIT-EXCLUDED-PROGRAMS` manually.
Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/.gitignore | 1 | ||||
| -rw-r--r-- | Documentation/Makefile | 3 |
2 files changed, 4 insertions, 0 deletions
diff --git a/Documentation/.gitignore b/Documentation/.gitignore index 3ef54e0..ea27148 100644 --- a/Documentation/.gitignore +++ b/Documentation/.gitignore @@ -13,3 +13,4 @@ mergetools-*.txt manpage-base-url.xsl SubmittingPatches.txt tmp-doc-diff/ +/GIT-EXCLUDED-PROGRAMS diff --git a/Documentation/Makefile b/Documentation/Makefile index af0e2cf..e22ea2f 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -7,7 +7,10 @@ ARTICLES = SP_ARTICLES = OBSOLETE_HTML = +-include GIT-EXCLUDED-PROGRAMS + MAN1_TXT += $(filter-out \ + $(patsubst %,%.txt,$(EXCLUDED_PROGRAMS)) \ $(addsuffix .txt, $(ARTICLES) $(SP_ARTICLES)), \ $(wildcard git-*.txt)) MAN1_TXT += git.txt |