author | Todd Zullinger <tmz@pobox.com> | 2010-09-06 13:31:22 (UTC) |
---|---|---|
committer | Lars Hjemli <hjemli@gmail.com> | 2010-09-19 17:11:45 (UTC) |
commit | 679f7ef4f3f31dca8c8ac5536c3e18a5188e051a (patch) (unidiff) | |
tree | 2f0085a1858cbf4f7f3534d6af0f0f7c6f604ce5 | |
parent | a9d6e6e695da6c6ed7f4bb32630ab2f3d9314806 (diff) | |
download | cgit-679f7ef4f3f31dca8c8ac5536c3e18a5188e051a.zip cgit-679f7ef4f3f31dca8c8ac5536c3e18a5188e051a.tar.gz cgit-679f7ef4f3f31dca8c8ac5536c3e18a5188e051a.tar.bz2 |
Generalize doc generation
This borrows from the git Documentation/Makefile. The goal is to make
it easier to add new man pages and other documentation as well as to
prevent make from re-generating the documentation needlessly.
Signed-off-by: Todd Zullinger <tmz@pobox.com>
Signed-off-by: Lars Hjemli <hjemli@gmail.com>
-rw-r--r-- | Makefile | 23 |
1 files changed, 16 insertions, 7 deletions
@@ -5,12 +5,17 @@ CGIT_DATA_PATH = $(CGIT_SCRIPT_PATH) | |||
5 | CGIT_CONFIG = /etc/cgitrc | 5 | CGIT_CONFIG = /etc/cgitrc |
6 | CACHE_ROOT = /var/cache/cgit | 6 | CACHE_ROOT = /var/cache/cgit |
7 | SHA1_HEADER = <openssl/sha.h> | 7 | SHA1_HEADER = <openssl/sha.h> |
8 | GIT_VER = 1.7.3 | 8 | GIT_VER = 1.7.3 |
9 | GIT_URL = http://www.kernel.org/pub/software/scm/git/git-$(GIT_VER).tar.bz2 | 9 | GIT_URL = http://www.kernel.org/pub/software/scm/git/git-$(GIT_VER).tar.bz2 |
10 | INSTALL = install | 10 | INSTALL = install |
11 | MAN5_TXT = $(wildcard *.5.txt) | ||
12 | MAN_TXT = $(MAN5_TXT) | ||
13 | DOC_MAN5 = $(patsubst %.txt,%,$(MAN5_TXT)) | ||
14 | DOC_HTML = $(patsubst %.txt,%.html,$(MAN_TXT)) | ||
15 | DOC_PDF = $(patsubst %.txt,%.pdf,$(MAN_TXT)) | ||
11 | 16 | ||
12 | # Define NO_STRCASESTR if you don't have strcasestr. | 17 | # Define NO_STRCASESTR if you don't have strcasestr. |
13 | # | 18 | # |
14 | # Define NO_OPENSSL to disable linking with OpenSSL and use bundled SHA1 | 19 | # Define NO_OPENSSL to disable linking with OpenSSL and use bundled SHA1 |
15 | # implementation (slower). | 20 | # implementation (slower). |
16 | # | 21 | # |
@@ -107,13 +112,13 @@ OBJECTS += ui-tree.o | |||
107 | ifdef NEEDS_LIBICONV | 112 | ifdef NEEDS_LIBICONV |
108 | EXTLIBS += -liconv | 113 | EXTLIBS += -liconv |
109 | endif | 114 | endif |
110 | 115 | ||
111 | 116 | ||
112 | .PHONY: all libgit test install uninstall clean force-version get-git \ | 117 | .PHONY: all libgit test install uninstall clean force-version get-git \ |
113 | doc man-doc html-doc clean-doc | 118 | doc clean-doc |
114 | 119 | ||
115 | all: cgit | 120 | all: cgit |
116 | 121 | ||
117 | VERSION: force-version | 122 | VERSION: force-version |
118 | @./gen-version.sh "$(CGIT_VERSION)" | 123 | @./gen-version.sh "$(CGIT_VERSION)" |
119 | -include VERSION | 124 | -include VERSION |
@@ -167,21 +172,25 @@ install: all | |||
167 | 172 | ||
168 | uninstall: | 173 | uninstall: |
169 | rm -f $(CGIT_SCRIPT_PATH)/$(CGIT_SCRIPT_NAME) | 174 | rm -f $(CGIT_SCRIPT_PATH)/$(CGIT_SCRIPT_NAME) |
170 | rm -f $(CGIT_DATA_PATH)/cgit.css | 175 | rm -f $(CGIT_DATA_PATH)/cgit.css |
171 | rm -f $(CGIT_DATA_PATH)/cgit.png | 176 | rm -f $(CGIT_DATA_PATH)/cgit.png |
172 | 177 | ||
173 | doc: man-doc html-doc pdf-doc | 178 | doc: doc-man doc-html doc-pdf |
179 | doc-man: doc-man5 | ||
180 | doc-man5: $(DOC_MAN5) | ||
181 | doc-html: $(DOC_HTML) | ||
182 | doc-pdf: $(DOC_PDF) | ||
174 | 183 | ||
175 | man-doc: cgitrc.5.txt | 184 | %.5 : %.5.txt |
176 | a2x -f manpage cgitrc.5.txt | 185 | a2x -f manpage $< |
177 | 186 | ||
178 | html-doc: cgitrc.5.txt | 187 | $(DOC_HTML): %.html : %.txt |
179 | a2x -f xhtml --stylesheet=cgit-doc.css cgitrc.5.txt | 188 | a2x -f xhtml --stylesheet=cgit-doc.css $< |
180 | 189 | ||
181 | pdf-doc: cgitrc.5.txt | 190 | $(DOC_PDF): %.pdf : %.txt |
182 | a2x -f pdf cgitrc.5.txt | 191 | a2x -f pdf cgitrc.5.txt |
183 | 192 | ||
184 | clean: clean-doc | 193 | clean: clean-doc |
185 | rm -f cgit VERSION *.o *.d | 194 | rm -f cgit VERSION *.o *.d |
186 | 195 | ||
187 | clean-doc: | 196 | clean-doc: |