1 # Guard against environment variables
10 -include GIT-EXCLUDED-PROGRAMS
12 MAN1_TXT
+= $(filter-out \
13 $(patsubst %,%.txt
,$(EXCLUDED_PROGRAMS
)) \
14 $(addsuffix .txt
, $(ARTICLES
) $(SP_ARTICLES
)), \
15 $(wildcard git-
*.txt
))
18 MAN1_TXT
+= gitweb.txt
20 # man5 / man7 guides (note: new guides should also be added to command-list.txt)
21 MAN5_TXT
+= gitattributes.txt
22 MAN5_TXT
+= githooks.txt
23 MAN5_TXT
+= gitignore.txt
24 MAN5_TXT
+= gitmodules.txt
25 MAN5_TXT
+= gitrepository-layout.txt
26 MAN5_TXT
+= gitweb.conf.txt
28 MAN7_TXT
+= gitcli.txt
29 MAN7_TXT
+= gitcore-tutorial.txt
30 MAN7_TXT
+= gitcredentials.txt
31 MAN7_TXT
+= gitcvs-migration.txt
32 MAN7_TXT
+= gitdiffcore.txt
33 MAN7_TXT
+= giteveryday.txt
34 MAN7_TXT
+= gitfaq.txt
35 MAN7_TXT
+= gitglossary.txt
36 MAN7_TXT
+= gitnamespaces.txt
37 MAN7_TXT
+= gitremote-helpers.txt
38 MAN7_TXT
+= gitrevisions.txt
39 MAN7_TXT
+= gitsubmodules.txt
40 MAN7_TXT
+= gittutorial-2.txt
41 MAN7_TXT
+= gittutorial.txt
42 MAN7_TXT
+= gitworkflows.txt
45 MAN_TXT
= $(filter $(MAN_FILTER
),$(MAN1_TXT
) $(MAN5_TXT
) $(MAN7_TXT
))
47 MAN_TXT
= $(MAN1_TXT
) $(MAN5_TXT
) $(MAN7_TXT
)
48 MAN_FILTER
= $(MAN_TXT
)
51 MAN_XML
= $(patsubst %.txt
,%.xml
,$(MAN_TXT
))
52 MAN_HTML
= $(patsubst %.txt
,%.html
,$(MAN_TXT
))
55 OBSOLETE_HTML
+= everyday.html
56 OBSOLETE_HTML
+= git-remote-helpers.html
58 ARTICLES
+= howto-index
60 ARTICLES
+= git-bisect-lk2009
61 # with their own formatting rules.
62 SP_ARTICLES
+= user-manual
63 SP_ARTICLES
+= howto
/new-command
64 SP_ARTICLES
+= howto
/revert-branch-rebase
65 SP_ARTICLES
+= howto
/using-merge-subtree
66 SP_ARTICLES
+= howto
/using-signed-tag-in-pull-request
67 SP_ARTICLES
+= howto
/use-git-daemon
68 SP_ARTICLES
+= howto
/update-hook-example
69 SP_ARTICLES
+= howto
/setup-git-server-over-http
70 SP_ARTICLES
+= howto
/separating-topic-branches
71 SP_ARTICLES
+= howto
/revert-a-faulty-merge
72 SP_ARTICLES
+= howto
/recover-corrupted-blob-object
73 SP_ARTICLES
+= howto
/recover-corrupted-object-harder
74 SP_ARTICLES
+= howto
/rebuild-from-update-hook
75 SP_ARTICLES
+= howto
/rebase-from-internal-branch
76 SP_ARTICLES
+= howto
/keep-canonical-history-correct
77 SP_ARTICLES
+= howto
/maintain-git
78 API_DOCS
= $(patsubst %.txt
,%,$(filter-out technical
/api-index-skel.txt technical
/api-index.txt
, $(wildcard technical
/api-
*.txt
)))
79 SP_ARTICLES
+= $(API_DOCS
)
81 TECH_DOCS
+= MyFirstContribution
82 TECH_DOCS
+= MyFirstObjectWalk
83 TECH_DOCS
+= SubmittingPatches
84 TECH_DOCS
+= technical
/hash-function-transition
85 TECH_DOCS
+= technical
/http-protocol
86 TECH_DOCS
+= technical
/index-format
87 TECH_DOCS
+= technical
/long-running-process-protocol
88 TECH_DOCS
+= technical
/multi-pack-index
89 TECH_DOCS
+= technical
/pack-format
90 TECH_DOCS
+= technical
/pack-heuristics
91 TECH_DOCS
+= technical
/pack-protocol
92 TECH_DOCS
+= technical
/partial-clone
93 TECH_DOCS
+= technical
/protocol-capabilities
94 TECH_DOCS
+= technical
/protocol-common
95 TECH_DOCS
+= technical
/protocol-v2
96 TECH_DOCS
+= technical
/racy-git
97 TECH_DOCS
+= technical
/reftable
98 TECH_DOCS
+= technical
/send-pack-pipeline
99 TECH_DOCS
+= technical
/shallow
100 TECH_DOCS
+= technical
/signature-format
101 TECH_DOCS
+= technical
/trivial-merge
102 SP_ARTICLES
+= $(TECH_DOCS
)
103 SP_ARTICLES
+= technical
/api-index
105 ARTICLES_HTML
+= $(patsubst %,%.html
,$(ARTICLES
) $(SP_ARTICLES
))
106 HTML_FILTER ?
= $(ARTICLES_HTML
) $(OBSOLETE_HTML
)
107 DOC_HTML
= $(MAN_HTML
) $(filter $(HTML_FILTER
),$(ARTICLES_HTML
) $(OBSOLETE_HTML
))
109 DOC_MAN1
= $(patsubst %.txt
,%.1,$(filter $(MAN_FILTER
),$(MAN1_TXT
)))
110 DOC_MAN5
= $(patsubst %.txt
,%.5,$(filter $(MAN_FILTER
),$(MAN5_TXT
)))
111 DOC_MAN7
= $(patsubst %.txt
,%.7,$(filter $(MAN_FILTER
),$(MAN7_TXT
)))
114 bindir ?
= $(prefix)/bin
115 htmldir ?
= $(prefix)/share
/doc
/git-doc
116 infodir ?
= $(prefix)/share
/info
117 pdfdir ?
= $(prefix)/share
/doc
/git-doc
118 mandir ?
= $(prefix)/share
/man
119 man1dir = $(mandir)/man1
120 man5dir = $(mandir)/man5
121 man7dir = $(mandir)/man7
126 ASCIIDOC_HTML
= xhtml11
127 ASCIIDOC_DOCBOOK
= docbook
128 ASCIIDOC_CONF
= -f asciidoc.conf
129 ASCIIDOC_COMMON
= $(ASCIIDOC
) $(ASCIIDOC_EXTRA
) $(ASCIIDOC_CONF
) \
130 -amanversion
=$(GIT_VERSION
) \
131 -amanmanual
='Git Manual' -amansource
='Git'
132 TXT_TO_HTML
= $(ASCIIDOC_COMMON
) -b
$(ASCIIDOC_HTML
)
133 TXT_TO_XML
= $(ASCIIDOC_COMMON
) -b
$(ASCIIDOC_DOCBOOK
)
134 MANPAGE_XSL
= manpage-normal.xsl
139 MAN_REPO
= ..
/..
/git-manpages
140 HTML_REPO
= ..
/..
/git-htmldocs
143 INSTALL_INFO
= install-info
144 DOCBOOK2X_TEXI
= docbook2x-texi
146 ASCIIDOC_DBLATEX_DIR
= /etc
/asciidoc
/dblatex
147 DBLATEX_COMMON
= -p
$(ASCIIDOC_DBLATEX_DIR
)/asciidoc-dblatex.xsl
-s
$(ASCIIDOC_DBLATEX_DIR
)/asciidoc-dblatex.sty
149 PERL_PATH
= /usr
/bin
/perl
152 -include ..
/config.mak.autogen
153 -include ..
/config.mak
155 ifndef NO_MAN_BOLD_LITERAL
156 XMLTO_EXTRA
+= -m manpage-bold-literal.xsl
159 # Newer DocBook stylesheet emits warning cruft in the output when
160 # this is not set, and if set it shows an absolute link. Older
161 # stylesheets simply ignore this parameter.
163 # Distros may want to use MAN_BASE_URL=file:///path/to/git/docs/
166 MAN_BASE_URL
= file
://$(htmldir
)/
168 XMLTO_EXTRA
+= -m manpage-base-url.xsl
170 # If your target system uses GNU groff, it may try to render
171 # apostrophes as a "pretty" apostrophe using unicode. This breaks
172 # cut&paste, so you should set GNU_ROFF to force them to be ASCII
173 # apostrophes. Unfortunately does not work with non-GNU roff.
175 XMLTO_EXTRA
+= -m manpage-quote-apos.xsl
178 ifdef USE_ASCIIDOCTOR
179 ASCIIDOC
= asciidoctor
181 ASCIIDOC_HTML
= xhtml5
182 ASCIIDOC_DOCBOOK
= docbook5
183 ASCIIDOC_EXTRA
+= -acompat-mode
-atabsize
=8
184 ASCIIDOC_EXTRA
+= -I.
-rasciidoctor-extensions
185 ASCIIDOC_EXTRA
+= -alitdd
='&\#x2d;&\#x2d;'
187 XMLTO_EXTRA
+= --skip-validation
188 XMLTO_EXTRA
+= -x manpage.xsl
191 SHELL_PATH ?
= $(SHELL
)
193 SHELL_PATH_SQ
= $(subst ','\'',$(SHELL_PATH))
196 DEFAULT_PAGER_SQ = $(subst ','\'',$(DEFAULT_PAGER
))
197 ASCIIDOC_EXTRA
+= -a
'git-default-pager=$(DEFAULT_PAGER_SQ)'
201 DEFAULT_EDITOR_SQ
= $(subst ','\'',$(DEFAULT_EDITOR))
202 ASCIIDOC_EXTRA += -a 'git-default-editor
=$(DEFAULT_EDITOR_SQ
)'
205 QUIET_SUBDIR0 = +$(MAKE) -C # space to separate -C and subdir
208 ifneq ($(findstring $(MAKEFLAGS),w),w)
209 PRINT_DIR = --no-print-directory
214 ifneq ($(findstring $(MAKEFLAGS),s),s)
216 QUIET_ASCIIDOC = @echo ' ' ASCIIDOC $@;
217 QUIET_XMLTO = @echo ' ' XMLTO $@;
218 QUIET_DB2TEXI = @echo ' ' DB2TEXI $@;
219 QUIET_MAKEINFO = @echo ' ' MAKEINFO $@;
220 QUIET_DBLATEX = @echo ' ' DBLATEX $@;
221 QUIET_XSLTPROC = @echo ' ' XSLTPROC $@;
222 QUIET_GEN = @echo ' ' GEN $@;
223 QUIET_LINT = @echo ' ' LINT $@;
224 QUIET_STDERR = 2> /dev/null
225 QUIET_SUBDIR0 = +@subdir=
226 QUIET_SUBDIR1 = ;$(NO_SUBDIR) echo ' ' SUBDIR $$subdir; \
227 $(MAKE) $(PRINT_DIR) -C $$subdir
241 info: git.info gitman.info
248 $(INSTALL) -d -m 755 $(DESTDIR)$(man1dir)
249 $(INSTALL) -d -m 755 $(DESTDIR)$(man5dir)
250 $(INSTALL) -d -m 755 $(DESTDIR)$(man7dir)
251 $(INSTALL) -m 644 $(DOC_MAN1) $(DESTDIR)$(man1dir)
252 $(INSTALL) -m 644 $(DOC_MAN5) $(DESTDIR)$(man5dir)
253 $(INSTALL) -m 644 $(DOC_MAN7) $(DESTDIR)$(man7dir)
256 $(INSTALL) -d -m 755 $(DESTDIR)$(infodir)
257 $(INSTALL) -m 644 git.info gitman.info $(DESTDIR)$(infodir)
258 if test -r $(DESTDIR)$(infodir)/dir; then \
259 $(INSTALL_INFO) --info-dir=$(DESTDIR)$(infodir) git.info ;\
260 $(INSTALL_INFO) --info-dir=$(DESTDIR)$(infodir) gitman.info ;\
262 echo "No directory found in $(DESTDIR)$(infodir)" >&2 ; \
266 $(INSTALL) -d -m 755 $(DESTDIR)$(pdfdir)
267 $(INSTALL) -m 644 user-manual.pdf $(DESTDIR)$(pdfdir)
270 '$(SHELL_PATH_SQ
)' ./install-webdoc.sh $(DESTDIR)$(htmldir)
272 ../GIT-VERSION-FILE: FORCE
273 $(QUIET_SUBDIR0)../ $(QUIET_SUBDIR1) GIT-VERSION-FILE
275 -include ../GIT-VERSION-FILE
278 # Determine "include::" file references in asciidoc files.
281 mergetools-list.made $(mergetools_txt) \
282 cmd-list.made $(cmds_txt)
284 doc.dep : $(docdep_prereqs) $(wildcard *.txt) $(wildcard config/*.txt) build-docdep.perl
285 $(QUIET_GEN)$(RM) $@+ $@ && \
286 $(PERL_PATH) ./build-docdep.perl >$@+ $(QUIET_STDERR) && \
291 cmds_txt = cmds-ancillaryinterrogators.txt \
292 cmds-ancillarymanipulators.txt \
293 cmds-mainporcelain.txt \
294 cmds-plumbinginterrogators.txt \
295 cmds-plumbingmanipulators.txt \
296 cmds-synchingrepositories.txt \
297 cmds-synchelpers.txt \
299 cmds-purehelpers.txt \
300 cmds-foreignscminterface.txt
302 $(cmds_txt): cmd-list.made
304 cmd-list.made: cmd-list.perl ../command-list.txt $(MAN1_TXT)
305 $(QUIET_GEN)$(RM) $@ && \
306 $(PERL_PATH) ./cmd-list.perl ../command-list.txt $(cmds_txt) $(QUIET_STDERR) && \
309 mergetools_txt = mergetools-diff.txt mergetools-merge.txt
311 $(mergetools_txt): mergetools-list.made
313 mergetools-list.made: ../git-mergetool--lib.sh $(wildcard ../mergetools/*)
314 $(QUIET_GEN)$(RM) $@ && \
315 $(SHELL_PATH) -c 'MERGE_TOOLS_DIR
=..
/mergetools
&& \
316 . ..
/git-mergetool--lib.sh
&& \
317 show_tool_names can_diff
"* " ||
:' >mergetools-diff.txt && \
318 $(SHELL_PATH) -c 'MERGE_TOOLS_DIR
=..
/mergetools
&& \
319 . ..
/git-mergetool--lib.sh
&& \
320 show_tool_names can_merge
"* " ||
:' >mergetools-merge.txt && \
323 TRACK_ASCIIDOCFLAGS = $(subst ','\'',$(ASCIIDOC_COMMON
):$(ASCIIDOC_HTML
):$(ASCIIDOC_DOCBOOK
))
325 GIT-ASCIIDOCFLAGS
: FORCE
326 @FLAGS
='$(TRACK_ASCIIDOCFLAGS)'; \
327 if
test x
"$$FLAGS" != x
"`cat GIT-ASCIIDOCFLAGS 2>/dev/null`" ; then \
328 echo
>&2 " * new asciidoc flags"; \
329 echo
"$$FLAGS" >GIT-ASCIIDOCFLAGS
; \
333 $(RM
) *.xml
*.xml
+ *.html
*.html
+ *.1 *.5 *.7
334 $(RM
) *.texi
*.texi
+ *.texi
++ git.
info gitman.
info
336 $(RM
) howto-index.txt howto
/*.html doc.dep
337 $(RM
) technical
/*.html technical
/api-index.txt
338 $(RM
) SubmittingPatches.txt
339 $(RM
) $(cmds_txt
) $(mergetools_txt
) *.made
340 $(RM
) manpage-base-url.xsl
341 $(RM
) GIT-ASCIIDOCFLAGS
343 $(MAN_HTML
): %.html
: %.txt asciidoc.conf asciidoctor-extensions.rb GIT-ASCIIDOCFLAGS
344 $(QUIET_ASCIIDOC
)$(RM
) $@
+ $@
&& \
345 $(TXT_TO_HTML
) -d manpage
-o
$@
+ $< && \
348 $(OBSOLETE_HTML
): %.html
: %.txto asciidoc.conf asciidoctor-extensions.rb GIT-ASCIIDOCFLAGS
349 $(QUIET_ASCIIDOC
)$(RM
) $@
+ $@
&& \
350 $(TXT_TO_HTML
) -o
$@
+ $< && \
353 manpage-base-url.xsl
: manpage-base-url.xsl.in
354 $(QUIET_GEN
)sed
"s|@@MAN_BASE_URL@@|$(MAN_BASE_URL)|" $< > $@
356 %.1 %.5 %.7 : %.xml manpage-base-url.xsl
$(wildcard manpage
*.xsl
)
357 $(QUIET_XMLTO
)$(RM
) $@
&& \
358 $(XMLTO
) -m
$(MANPAGE_XSL
) $(XMLTO_EXTRA
) man
$<
360 %.xml
: %.txt asciidoc.conf asciidoctor-extensions.rb GIT-ASCIIDOCFLAGS
361 $(QUIET_ASCIIDOC
)$(RM
) $@
+ $@
&& \
362 $(TXT_TO_XML
) -d manpage
-o
$@
+ $< && \
365 user-manual.xml
: user-manual.txt user-manual.conf asciidoctor-extensions.rb GIT-ASCIIDOCFLAGS
366 $(QUIET_ASCIIDOC
)$(RM
) $@
+ $@
&& \
367 $(TXT_TO_XML
) -d book
-o
$@
+ $< && \
370 technical
/api-index.txt
: technical
/api-index-skel.txt \
371 technical
/api-index.sh
$(patsubst %,%.txt
,$(API_DOCS
))
372 $(QUIET_GEN
)cd technical
&& '$(SHELL_PATH_SQ)' .
/api-index.sh
374 technical
/%.html
: ASCIIDOC_EXTRA
+= -a git-relative-html-prefix
=..
/
375 $(patsubst %,%.html
,$(API_DOCS
) technical
/api-index
$(TECH_DOCS
)): %.html
: %.txt \
376 asciidoc.conf GIT-ASCIIDOCFLAGS
377 $(QUIET_ASCIIDOC
)$(TXT_TO_HTML
) $*.txt
379 SubmittingPatches.txt
: SubmittingPatches
380 $(QUIET_GEN
) cp
$< $@
383 XSLTOPTS
= --xinclude
--stringparam html.stylesheet docbook-xsl.css
385 user-manual.html
: user-manual.xml
$(XSLT
)
386 $(QUIET_XSLTPROC
)$(RM
) $@
+ $@
&& \
387 xsltproc
$(XSLTOPTS
) -o
$@
+ $(XSLT
) $< && \
390 git.
info: user-manual.texi
391 $(QUIET_MAKEINFO
)$(MAKEINFO
) --no-split
-o
$@ user-manual.texi
393 user-manual.texi
: user-manual.xml
394 $(QUIET_DB2TEXI
)$(RM
) $@
+ $@
&& \
395 $(DOCBOOK2X_TEXI
) user-manual.xml
--encoding
=UTF-8
--to-stdout
>$@
++ && \
396 $(PERL_PATH
) fix-texi.perl
<$@
++ >$@
+ && \
400 user-manual.pdf
: user-manual.xml
401 $(QUIET_DBLATEX
)$(RM
) $@
+ $@
&& \
402 $(DBLATEX
) -o
$@
+ $(DBLATEX_COMMON
) $< && \
405 gitman.texi
: $(MAN_XML
) cat-texi.perl texi.xsl
406 $(QUIET_DB2TEXI
)$(RM
) $@
+ $@
&& \
407 ($(foreach xml
,$(sort $(MAN_XML
)),xsltproc
-o
$(xml
)+ texi.xsl
$(xml
) && \
408 $(DOCBOOK2X_TEXI
) --encoding
=UTF-8
--to-stdout
$(xml
)+ && \
409 rm $(xml
)+ &&) true
) > $@
++ && \
410 $(PERL_PATH
) cat-texi.perl
$@
<$@
++ >$@
+ && \
414 gitman.
info: gitman.texi
415 $(QUIET_MAKEINFO
)$(MAKEINFO
) --no-split
--no-validate
$*.texi
417 $(patsubst %.txt
,%.texi
,$(MAN_TXT
)): %.texi
: %.xml
418 $(QUIET_DB2TEXI
)$(RM
) $@
+ $@
&& \
419 $(DOCBOOK2X_TEXI
) --to-stdout
$*.xml
>$@
+ && \
422 howto-index.txt
: howto-index.sh
$(wildcard howto
/*.txt
)
423 $(QUIET_GEN
)$(RM
) $@
+ $@
&& \
424 '$(SHELL_PATH_SQ)' .
/howto-index.sh
$(sort $(wildcard howto
/*.txt
)) >$@
+ && \
427 $(patsubst %,%.html
,$(ARTICLES
)) : %.html
: %.txt
428 $(QUIET_ASCIIDOC
)$(TXT_TO_HTML
) $*.txt
430 WEBDOC_DEST
= /pub
/software
/scm
/git
/docs
432 howto
/%.html
: ASCIIDOC_EXTRA
+= -a git-relative-html-prefix
=..
/
433 $(patsubst %.txt
,%.html
,$(wildcard howto
/*.txt
)): %.html
: %.txt GIT-ASCIIDOCFLAGS
434 $(QUIET_ASCIIDOC
)$(RM
) $@
+ $@
&& \
435 sed
-e
'1,/^$$/d' $< | \
436 $(TXT_TO_HTML
) - >$@
+ && \
439 install-webdoc
: html
440 '$(SHELL_PATH_SQ)' .
/install-webdoc.sh
$(WEBDOC_DEST
)
442 # You must have a clone of 'git-htmldocs' and 'git-manpages' repositories
443 # next to the 'git' repository itself for the following to work.
445 quick-install
: quick-install-man
448 @if
test ! -d
$(MAN_REPO
); \
449 then echo
"git-manpages repository must exist at $(MAN_REPO)"; exit
1; fi
451 quick-install-man
: require-manrepo
452 '$(SHELL_PATH_SQ)' .
/install-doc-quick.sh
$(MAN_REPO
) $(DESTDIR
)$(mandir) $(GIT_MAN_REF
)
455 @if
test ! -d
$(HTML_REPO
); \
456 then echo
"git-htmldocs repository must exist at $(HTML_REPO)"; exit
1; fi
458 quick-install-html
: require-htmlrepo
459 '$(SHELL_PATH_SQ)' .
/install-doc-quick.sh
$(HTML_REPO
) $(DESTDIR
)$(htmldir
) $(GIT_MAN_REF
)
462 @for i in
$(MAN1_TXT
); do echo
$$i; done
465 $(QUIET_LINT
)$(PERL_PATH
) lint-gitlink.perl
467 ifeq ($(wildcard po
/Makefile
),po
/Makefile
)
468 doc-l10n install-l10n
::