X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=Documentation%2FMakefile;h=f4cbf7e159be721bf17625b07c1d7b4f36c60f78;hb=b4a081b428c607f98c5d0a0eec8d543dc1f2abcd;hp=cc891748602e63eb133584a68370bbc1697e7b51;hpb=8d0991d7d7d7e68ef39fe8d302f43110ef2c65d1;p=git.git diff --git a/Documentation/Makefile b/Documentation/Makefile index cc891748..f4cbf7e1 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -1,21 +1,36 @@ -MAN1_TXT=$(wildcard git-*.txt) gitk.txt +MAN1_TXT= \ + $(filter-out $(addsuffix .txt, $(ARTICLES) $(SP_ARTICLES)), \ + $(wildcard git-*.txt)) \ + gitk.txt MAN7_TXT=git.txt DOC_HTML=$(patsubst %.txt,%.html,$(MAN1_TXT) $(MAN7_TXT)) -DOC_HTML += glossary.html -DOC_HTML += tutorial.html -DOC_HTML += howto-index.html + +ARTICLES = tutorial +ARTICLES += core-tutorial +ARTICLES += cvs-migration +ARTICLES += diffcore +ARTICLES += howto-index +ARTICLES += repository-layout +ARTICLES += hooks +ARTICLES += everyday +ARTICLES += git-tools +# with their own formatting rules. +SP_ARTICLES = glossary howto/revert-branch-rebase + +DOC_HTML += $(patsubst %,%.html,$(ARTICLES) $(SP_ARTICLES)) + DOC_MAN1=$(patsubst %.txt,%.1,$(MAN1_TXT)) DOC_MAN7=$(patsubst %.txt,%.7,$(MAN7_TXT)) -prefix=$(HOME) +prefix?=$(HOME) bin=$(prefix)/bin mandir=$(prefix)/man man1=$(mandir)/man1 man7=$(mandir)/man7 # DESTDIR= -INSTALL=install +INSTALL?=install # # Please note that there is a minor bug in asciidoc. @@ -35,47 +50,57 @@ man: man1 man7 man1: $(DOC_MAN1) man7: $(DOC_MAN7) -install: - $(INSTALL) -m755 -d $(DESTDIR)/$(man1) $(DESTDIR)/$(man7) +install: man + $(INSTALL) -d -m755 $(DESTDIR)/$(man1) $(DESTDIR)/$(man7) $(INSTALL) $(DOC_MAN1) $(DESTDIR)/$(man1) $(INSTALL) $(DOC_MAN7) $(DESTDIR)/$(man7) -# 'include' dependencies -git-diff-%.txt: diff-format.txt diff-options.txt - touch $@ + +# +# Determine "include::" file references in asciidoc files. +# +doc.dep : $(wildcard *.txt) build-docdep.perl + rm -f $@+ $@ + perl ./build-docdep.perl >$@+ + mv $@+ $@ + +-include doc.dep + +git.7: README + +README: ../README + cp $< $@ + clean: - rm -f *.xml *.html *.1 *.7 howto-index.txt howto/*.html + rm -f *.xml *.html *.1 *.7 howto-index.txt howto/*.html doc.dep README %.html : %.txt - asciidoc -b xhtml11 -d manpage $< + asciidoc -b xhtml11 -d manpage -f asciidoc.conf $< %.1 %.7 : %.xml xmlto man $< %.xml : %.txt - asciidoc -b docbook -d manpage $< + asciidoc -b docbook -d manpage -f asciidoc.conf $< + +git.html: git.txt README glossary.html : glossary.txt sort_glossary.pl cat $< | \ perl sort_glossary.pl | \ asciidoc -b xhtml11 - > glossary.html -tutorial.html : tutorial.txt - asciidoc -b xhtml11 tutorial.txt - howto-index.txt: howto-index.sh $(wildcard howto/*.txt) rm -f $@+ $@ sh ./howto-index.sh $(wildcard howto/*.txt) >$@+ mv $@+ $@ -howto-index.html: howto-index.txt - asciidoc -b xhtml11 howto-index.txt +$(patsubst %,%.html,$(ARTICLES)) : %.html : %.txt + asciidoc -b xhtml11 $*.txt WEBDOC_DEST = /pub/software/scm/git/docs -DOC_HTML += howto/revert-branch-rebase.html - $(patsubst %.txt,%.html,$(wildcard howto/*.txt)): %.html : %.txt rm -f $@+ $@ sed -e '1,/^$$/d' $? | asciidoc -b xhtml11 - >$@+