2 $(filter-out $(addsuffix .txt
, $(ARTICLES
) $(SP_ARTICLES
)), \
3 $(wildcard git-
*.txt
)) \
5 MAN5_TXT
=gitattributes.txt gitignore.txt gitmodules.txt githooks.txt \
6 gitrepository-layout.txt
7 MAN7_TXT
=gitcli.txt gittutorial.txt gittutorial-2.txt \
8 gitcvs-migration.txt gitcore-tutorial.txt gitglossary.txt \
9 gitdiffcore.txt gitworkflows.txt
11 MAN_TXT
= $(MAN1_TXT
) $(MAN5_TXT
) $(MAN7_TXT
)
12 MAN_XML
=$(patsubst %.txt
,%.xml
,$(MAN_TXT
))
13 MAN_HTML
=$(patsubst %.txt
,%.html
,$(MAN_TXT
))
17 ARTICLES
= howto-index
20 # with their own formatting rules.
21 SP_ARTICLES
= howto
/revert-branch-rebase howto
/using-merge-subtree user-manual
22 API_DOCS
= $(patsubst %.txt
,%,$(filter-out technical
/api-index-skel.txt technical
/api-index.txt
, $(wildcard technical
/api-
*.txt
)))
23 SP_ARTICLES
+= $(API_DOCS
)
24 SP_ARTICLES
+= technical
/api-index
26 DOC_HTML
+= $(patsubst %,%.html
,$(ARTICLES
) $(SP_ARTICLES
))
28 DOC_MAN1
=$(patsubst %.txt
,%.1,$(MAN1_TXT
))
29 DOC_MAN5
=$(patsubst %.txt
,%.5,$(MAN5_TXT
))
30 DOC_MAN7
=$(patsubst %.txt
,%.7,$(MAN7_TXT
))
34 htmldir?
=$(prefix)/share
/doc
/git-doc
35 pdfdir?
=$(prefix)/share
/doc
/git-doc
36 mandir?
=$(prefix)/share
/man
37 man1dir=$(mandir)/man1
38 man5dir=$(mandir)/man5
39 man7dir=$(mandir)/man7
44 MANPAGE_XSL
= manpage-normal.xsl
48 HTML_REF
= origin/html
50 infodir?
=$(prefix)/share
/info
52 INSTALL_INFO
=install-info
53 DOCBOOK2X_TEXI
=docbook2x-texi
56 PERL_PATH
= /usr
/bin
/perl
59 -include ..
/config.mak.autogen
60 -include ..
/config.mak
64 # -7.1.2, no extra settings are needed.
65 # 8.0-, set ASCIIDOC8.
70 # -1.68.1, set ASCIIDOC_NO_ROFF? (based on changelog from 1.73.0)
71 # 1.69.0-1.71.1, no extra settings are needed?
72 # 1.72.0, set DOCBOOK_XSL_172.
73 # 1.73.0-, set ASCIIDOC_NO_ROFF
77 # If you had been using DOCBOOK_XSL_172 in an attempt to get rid
78 # of 'the ".ft C" problem' in your generated manpages, and you
79 # instead ended up with weird characters around callouts, try
80 # using ASCIIDOC_NO_ROFF instead (it works fine with ASCIIDOC8).
84 ASCIIDOC_EXTRA
+= -a asciidoc7compatible
87 ASCIIDOC_EXTRA
+= -a git-asciidoc-no-roff
88 MANPAGE_XSL
= manpage-1.72.xsl
90 ifdef ASCIIDOC_NO_ROFF
91 # docbook-xsl after 1.72 needs the regular XSL, but will not
92 # pass-thru raw roff codes from asciidoc.conf, so turn them off.
93 ASCIIDOC_EXTRA
+= -a git-asciidoc-no-roff
98 # Please note that there is a minor bug in asciidoc.
99 # The version after 6.0.3 _will_ include the patch found here:
100 # http://marc.theaimsgroup.com/?l=git&m=111558757202243&w=2
102 # Until that version is released you may have to apply the patch
103 # yourself - yes, all 6 characters of it!
110 $(DOC_HTML
) $(DOC_MAN1
) $(DOC_MAN5
) $(DOC_MAN7
): asciidoc.conf
117 info: git.
info gitman.
info
124 $(INSTALL
) -d
-m
755 $(DESTDIR
)$(man1dir)
125 $(INSTALL
) -d
-m
755 $(DESTDIR
)$(man5dir)
126 $(INSTALL
) -d
-m
755 $(DESTDIR
)$(man7dir)
127 $(INSTALL
) -m
644 $(DOC_MAN1
) $(DESTDIR
)$(man1dir)
128 $(INSTALL
) -m
644 $(DOC_MAN5
) $(DESTDIR
)$(man5dir)
129 $(INSTALL
) -m
644 $(DOC_MAN7
) $(DESTDIR
)$(man7dir)
132 $(INSTALL
) -d
-m
755 $(DESTDIR
)$(infodir)
133 $(INSTALL
) -m
644 git.
info gitman.
info $(DESTDIR
)$(infodir)
134 if
test -r
$(DESTDIR
)$(infodir)/dir; then \
135 $(INSTALL_INFO
) --info-dir
=$(DESTDIR
)$(infodir) git.
info ;\
136 $(INSTALL_INFO
) --info-dir
=$(DESTDIR
)$(infodir) gitman.
info ;\
138 echo
"No directory found in $(DESTDIR)$(infodir)" >&2 ; \
142 $(INSTALL
) -d
-m
755 $(DESTDIR
)$(pdfdir
)
143 $(INSTALL
) -m
644 user-manual.pdf
$(DESTDIR
)$(pdfdir
)
146 sh .
/install-webdoc.sh
$(DESTDIR
)$(htmldir
)
148 ..
/GIT-VERSION-FILE
: .FORCE-GIT-VERSION-FILE
149 $(MAKE
) -C ..
/ GIT-VERSION-FILE
151 -include ..
/GIT-VERSION-FILE
154 # Determine "include::" file references in asciidoc files.
156 doc.dep
: $(wildcard *.txt
) build-docdep.perl
158 $(PERL_PATH
) .
/build-docdep.perl
>$@
+
163 cmds_txt
= cmds-ancillaryinterrogators.txt \
164 cmds-ancillarymanipulators.txt \
165 cmds-mainporcelain.txt \
166 cmds-plumbinginterrogators.txt \
167 cmds-plumbingmanipulators.txt \
168 cmds-synchingrepositories.txt \
169 cmds-synchelpers.txt \
170 cmds-purehelpers.txt \
171 cmds-foreignscminterface.txt
173 $(cmds_txt
): cmd-list.made
175 cmd-list.made
: cmd-list.perl ..
/command-list.txt
$(MAN1_TXT
)
177 $(PERL_PATH
) .
/cmd-list.perl ..
/command-list.txt
181 $(RM
) *.xml
*.xml
+ *.html
*.html
+ *.1 *.5 *.7
182 $(RM
) *.texi
*.texi
+ git.
info gitman.
info
183 $(RM
) howto-index.txt howto
/*.html doc.dep
184 $(RM
) technical
/api-
*.html technical
/api-index.txt
185 $(RM
) $(cmds_txt
) *.made
187 $(MAN_HTML
): %.html
: %.txt
189 $(ASCIIDOC
) -b xhtml11
-d manpage
-f asciidoc.conf \
190 $(ASCIIDOC_EXTRA
) -agit_version
=$(GIT_VERSION
) -o
$@
+ $<
195 xmlto
-m
$(MANPAGE_XSL
) man
$<
199 $(ASCIIDOC
) -b docbook
-d manpage
-f asciidoc.conf \
200 $(ASCIIDOC_EXTRA
) -agit_version
=$(GIT_VERSION
) -o
$@
+ $<
203 user-manual.xml
: user-manual.txt user-manual.conf
204 $(ASCIIDOC
) -b docbook
-d book
$<
206 technical
/api-index.txt
: technical
/api-index-skel.txt \
207 technical
/api-index.sh
$(patsubst %,%.txt
,$(API_DOCS
))
208 cd technical
&& sh .
/api-index.sh
210 $(patsubst %,%.html
,$(API_DOCS
) technical
/api-index
): %.html
: %.txt
211 $(ASCIIDOC
) -b xhtml11
-f asciidoc.conf \
212 $(ASCIIDOC_EXTRA
) -agit_version
=$(GIT_VERSION
) $*.txt
215 XSLTOPTS
= --xinclude
--stringparam html.stylesheet docbook-xsl.css
217 user-manual.html
: user-manual.xml
218 xsltproc
$(XSLTOPTS
) -o
$@
$(XSLT
) $<
220 git.
info: user-manual.texi
221 $(MAKEINFO
) --no-split
-o
$@ user-manual.texi
223 user-manual.texi
: user-manual.xml
225 $(DOCBOOK2X_TEXI
) user-manual.xml
--encoding
=UTF-8
--to-stdout | \
226 $(PERL_PATH
) fix-texi.perl
>$@
+
229 user-manual.pdf
: user-manual.xml
231 $(DBLATEX
) -o
$@
+ -p
/etc
/asciidoc
/dblatex
/asciidoc-dblatex.xsl
-s
/etc
/asciidoc
/dblatex
/asciidoc-dblatex.sty
$<
234 gitman.texi
: $(MAN_XML
) cat-texi.perl
236 ($(foreach xml
,$(MAN_XML
),$(DOCBOOK2X_TEXI
) --encoding
=UTF-8 \
237 --to-stdout
$(xml
);)) |
$(PERL_PATH
) cat-texi.perl
$@
>$@
+
240 gitman.
info: gitman.texi
241 $(MAKEINFO
) --no-split
--no-validate
$*.texi
243 $(patsubst %.txt
,%.texi
,$(MAN_TXT
)): %.texi
: %.xml
245 $(DOCBOOK2X_TEXI
) --to-stdout
$*.xml
>$@
+
248 howto-index.txt
: howto-index.sh
$(wildcard howto
/*.txt
)
250 sh .
/howto-index.sh
$(wildcard howto
/*.txt
) >$@
+
253 $(patsubst %,%.html
,$(ARTICLES
)) : %.html
: %.txt
254 $(ASCIIDOC
) -b xhtml11
$*.txt
256 WEBDOC_DEST
= /pub
/software
/scm
/git
/docs
258 $(patsubst %.txt
,%.html
,$(wildcard howto
/*.txt
)): %.html
: %.txt
260 sed
-e
'1,/^$$/d' $< |
$(ASCIIDOC
) -b xhtml11
- >$@
+
263 install-webdoc
: html
264 sh .
/install-webdoc.sh
$(WEBDOC_DEST
)
266 quick-install
: quick-install-man
269 sh .
/install-doc-quick.sh
$(DOC_REF
) $(DESTDIR
)$(mandir)
272 sh .
/install-doc-quick.sh
$(HTML_REF
) $(DESTDIR
)$(htmldir
)
274 .PHONY
: .FORCE-GIT-VERSION-FILE