Documentation: make it easier to maintain enumerated documents

Instead of starting an enumeration of documents with a DOC = doc1
followed by DOC += doc2, DOC += doc3, ..., empty it with "DOC =" at
the beginning and consistently add them with "DOC += ...".

Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Junio C Hamano 2014-01-27 09:04:32 -08:00
parent 586aa78631
commit 43cc5ce9ea

View file

@ -2,6 +2,9 @@
MAN1_TXT = MAN1_TXT =
MAN5_TXT = MAN5_TXT =
MAN7_TXT = MAN7_TXT =
TECH_DOCS =
ARTICLES =
SP_ARTICLES =
MAN1_TXT += $(filter-out \ MAN1_TXT += $(filter-out \
$(addsuffix .txt, $(ARTICLES) $(SP_ARTICLES)), \ $(addsuffix .txt, $(ARTICLES) $(SP_ARTICLES)), \
@ -37,12 +40,12 @@ MAN_HTML = $(patsubst %.txt,%.html,$(MAN_TXT))
OBSOLETE_HTML = git-remote-helpers.html OBSOLETE_HTML = git-remote-helpers.html
DOC_HTML = $(MAN_HTML) $(OBSOLETE_HTML) DOC_HTML = $(MAN_HTML) $(OBSOLETE_HTML)
ARTICLES = howto-index ARTICLES += howto-index
ARTICLES += everyday ARTICLES += everyday
ARTICLES += git-tools ARTICLES += git-tools
ARTICLES += git-bisect-lk2009 ARTICLES += git-bisect-lk2009
# with their own formatting rules. # with their own formatting rules.
SP_ARTICLES = user-manual SP_ARTICLES += user-manual
SP_ARTICLES += howto/new-command SP_ARTICLES += howto/new-command
SP_ARTICLES += howto/revert-branch-rebase SP_ARTICLES += howto/revert-branch-rebase
SP_ARTICLES += howto/using-merge-subtree SP_ARTICLES += howto/using-merge-subtree
@ -60,7 +63,7 @@ SP_ARTICLES += howto/maintain-git
API_DOCS = $(patsubst %.txt,%,$(filter-out technical/api-index-skel.txt technical/api-index.txt, $(wildcard technical/api-*.txt))) API_DOCS = $(patsubst %.txt,%,$(filter-out technical/api-index-skel.txt technical/api-index.txt, $(wildcard technical/api-*.txt)))
SP_ARTICLES += $(API_DOCS) SP_ARTICLES += $(API_DOCS)
TECH_DOCS = technical/http-protocol TECH_DOCS += technical/http-protocol
TECH_DOCS += technical/index-format TECH_DOCS += technical/index-format
TECH_DOCS += technical/pack-format TECH_DOCS += technical/pack-format
TECH_DOCS += technical/pack-heuristics TECH_DOCS += technical/pack-heuristics