Re: [Patch 3/5] Create html documents for all files in Documentation/RelNotes
From: Jeff King <hidden>
Date: 2016-06-15 22:54:57
On Sat, Oct 06, 2012 at 05:55:58PM +0200, Thomas Ackermann wrote:
quoted hunk ↗ jump to hunk
- create html for all release note files [...]diff --git a/Documentation/Makefile b/Documentation/Makefile index 86594f6..80eb06d 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile@@ -24,6 +24,7 @@ SP_ARTICLES = user-manual SP_ARTICLES += howto/revert-branch-rebase SP_ARTICLES += howto/using-merge-subtree SP_ARTICLES += howto/using-signed-tag-in-pull-request +RELNOTES = $(patsubst %.txt,%,$(wildcard RelNotes/*.txt)) API_DOCS = $(patsubst %.txt,%,$(filter-out technical/api-index-skel.txt technical/api-index.txt, $(wildcard technical/api-*.txt))) API_DOCS += technical/index-format API_DOCS += technical/pack-format@@ -35,6 +36,7 @@ API_DOCS += technical/racy-git API_DOCS += technical/send-pack-pipeline API_DOCS += technical/shallow API_DOCS += technical/trivial-merge +API_DOCS += $(RELNOTES)
Yuck. This means that anyone generating the html documentation will have
to format all of the release notes, too, even though they are much less
likely to be useful[1]. If this is only useful for the fullpdf target,
can we omit it from the regular html target (and maybe add a "relnotes"
target or something for people who really want them formatted)?
-Peff
[1] I would not be surprised if they do not actually format all that
well. Though they are written in an asciidoc-ish style, they have
not traditionally been formatted, and I suspect there are many small
errors (like improper quoting of metacharacters) in them.