git

1
# Import tree-wide shared Makefile behavior and libraries
2
include ../shared.mak
3

4
# Guard against environment variables
5
MAN1_TXT =
6
MAN5_TXT =
7
MAN7_TXT =
8
HOWTO_TXT =
9
DOC_DEP_TXT =
10
TECH_DOCS =
11
ARTICLES =
12
SP_ARTICLES =
13
OBSOLETE_HTML =
14

15
-include GIT-EXCLUDED-PROGRAMS
16

17
MAN1_TXT += $(filter-out \
18
		$(patsubst %,%.txt,$(EXCLUDED_PROGRAMS)) \
19
		$(addsuffix .txt, $(ARTICLES) $(SP_ARTICLES)), \
20
		$(wildcard git-*.txt))
21
MAN1_TXT += git.txt
22
MAN1_TXT += gitk.txt
23
MAN1_TXT += gitweb.txt
24
MAN1_TXT += scalar.txt
25

26
# man5 / man7 guides (note: new guides should also be added to command-list.txt)
27
MAN5_TXT += gitattributes.txt
28
MAN5_TXT += gitformat-bundle.txt
29
MAN5_TXT += gitformat-chunk.txt
30
MAN5_TXT += gitformat-commit-graph.txt
31
MAN5_TXT += gitformat-index.txt
32
MAN5_TXT += gitformat-pack.txt
33
MAN5_TXT += gitformat-signature.txt
34
MAN5_TXT += githooks.txt
35
MAN5_TXT += gitignore.txt
36
MAN5_TXT += gitmailmap.txt
37
MAN5_TXT += gitmodules.txt
38
MAN5_TXT += gitprotocol-capabilities.txt
39
MAN5_TXT += gitprotocol-common.txt
40
MAN5_TXT += gitprotocol-http.txt
41
MAN5_TXT += gitprotocol-pack.txt
42
MAN5_TXT += gitprotocol-v2.txt
43
MAN5_TXT += gitrepository-layout.txt
44
MAN5_TXT += gitweb.conf.txt
45

46
MAN7_TXT += gitcli.txt
47
MAN7_TXT += gitcore-tutorial.txt
48
MAN7_TXT += gitcredentials.txt
49
MAN7_TXT += gitcvs-migration.txt
50
MAN7_TXT += gitdiffcore.txt
51
MAN7_TXT += giteveryday.txt
52
MAN7_TXT += gitfaq.txt
53
MAN7_TXT += gitglossary.txt
54
MAN7_TXT += gitpacking.txt
55
MAN7_TXT += gitnamespaces.txt
56
MAN7_TXT += gitremote-helpers.txt
57
MAN7_TXT += gitrevisions.txt
58
MAN7_TXT += gitsubmodules.txt
59
MAN7_TXT += gittutorial-2.txt
60
MAN7_TXT += gittutorial.txt
61
MAN7_TXT += gitworkflows.txt
62

63
HOWTO_TXT += $(wildcard howto/*.txt)
64

65
DOC_DEP_TXT += $(wildcard *.txt)
66
DOC_DEP_TXT += $(wildcard config/*.txt)
67
DOC_DEP_TXT += $(wildcard includes/*.txt)
68

69
ifdef MAN_FILTER
70
MAN_TXT = $(filter $(MAN_FILTER),$(MAN1_TXT) $(MAN5_TXT) $(MAN7_TXT))
71
else
72
MAN_TXT = $(MAN1_TXT) $(MAN5_TXT) $(MAN7_TXT)
73
MAN_FILTER = $(MAN_TXT)
74
endif
75

76
MAN_XML = $(patsubst %.txt,%.xml,$(MAN_TXT))
77
MAN_HTML = $(patsubst %.txt,%.html,$(MAN_TXT))
78
GIT_MAN_REF = master
79

80
OBSOLETE_HTML += everyday.html
81
OBSOLETE_HTML += git-remote-helpers.html
82

83
ARTICLES += howto-index
84
ARTICLES += git-tools
85
ARTICLES += git-bisect-lk2009
86
# with their own formatting rules.
87
SP_ARTICLES += user-manual
88
SP_ARTICLES += howto/new-command
89
SP_ARTICLES += howto/revert-branch-rebase
90
SP_ARTICLES += howto/using-merge-subtree
91
SP_ARTICLES += howto/using-signed-tag-in-pull-request
92
SP_ARTICLES += howto/use-git-daemon
93
SP_ARTICLES += howto/update-hook-example
94
SP_ARTICLES += howto/setup-git-server-over-http
95
SP_ARTICLES += howto/separating-topic-branches
96
SP_ARTICLES += howto/revert-a-faulty-merge
97
SP_ARTICLES += howto/recover-corrupted-blob-object
98
SP_ARTICLES += howto/recover-corrupted-object-harder
99
SP_ARTICLES += howto/rebuild-from-update-hook
100
SP_ARTICLES += howto/rebase-from-internal-branch
101
SP_ARTICLES += howto/keep-canonical-history-correct
102
SP_ARTICLES += howto/maintain-git
103
SP_ARTICLES += howto/coordinate-embargoed-releases
104
API_DOCS = $(patsubst %.txt,%,$(filter-out technical/api-index-skel.txt technical/api-index.txt, $(wildcard technical/api-*.txt)))
105
SP_ARTICLES += $(API_DOCS)
106

107
TECH_DOCS += DecisionMaking
108
TECH_DOCS += ReviewingGuidelines
109
TECH_DOCS += MyFirstContribution
110
TECH_DOCS += MyFirstObjectWalk
111
TECH_DOCS += SubmittingPatches
112
TECH_DOCS += ToolsForGit
113
TECH_DOCS += technical/bitmap-format
114
TECH_DOCS += technical/bundle-uri
115
TECH_DOCS += technical/hash-function-transition
116
TECH_DOCS += technical/long-running-process-protocol
117
TECH_DOCS += technical/multi-pack-index
118
TECH_DOCS += technical/pack-heuristics
119
TECH_DOCS += technical/parallel-checkout
120
TECH_DOCS += technical/partial-clone
121
TECH_DOCS += technical/platform-support
122
TECH_DOCS += technical/racy-git
123
TECH_DOCS += technical/reftable
124
TECH_DOCS += technical/scalar
125
TECH_DOCS += technical/send-pack-pipeline
126
TECH_DOCS += technical/shallow
127
TECH_DOCS += technical/trivial-merge
128
TECH_DOCS += technical/unit-tests
129
SP_ARTICLES += $(TECH_DOCS)
130
SP_ARTICLES += technical/api-index
131

132
ARTICLES_HTML += $(patsubst %,%.html,$(ARTICLES) $(SP_ARTICLES))
133
HTML_FILTER ?= $(ARTICLES_HTML) $(OBSOLETE_HTML)
134
DOC_HTML = $(MAN_HTML) $(filter $(HTML_FILTER),$(ARTICLES_HTML) $(OBSOLETE_HTML))
135

136
DOC_MAN1 = $(patsubst %.txt,%.1,$(filter $(MAN_FILTER),$(MAN1_TXT)))
137
DOC_MAN5 = $(patsubst %.txt,%.5,$(filter $(MAN_FILTER),$(MAN5_TXT)))
138
DOC_MAN7 = $(patsubst %.txt,%.7,$(filter $(MAN_FILTER),$(MAN7_TXT)))
139

140
prefix ?= $(HOME)
141
bindir ?= $(prefix)/bin
142
htmldir ?= $(prefix)/share/doc/git-doc
143
infodir ?= $(prefix)/share/info
144
pdfdir ?= $(prefix)/share/doc/git-doc
145
mandir ?= $(prefix)/share/man
146
man1dir = $(mandir)/man1
147
man5dir = $(mandir)/man5
148
man7dir = $(mandir)/man7
149
# DESTDIR =
150

151
GIT_DATE := $(shell git show --quiet --pretty='%as')
152

153
ASCIIDOC = asciidoc
154
ASCIIDOC_EXTRA =
155
ASCIIDOC_HTML = xhtml11
156
ASCIIDOC_DOCBOOK = docbook
157
ASCIIDOC_CONF = -f asciidoc.conf
158
ASCIIDOC_COMMON = $(ASCIIDOC) $(ASCIIDOC_EXTRA) $(ASCIIDOC_CONF) \
159
		-amanmanual='Git Manual' -amansource='Git $(GIT_VERSION)' \
160
		-arevdate='$(GIT_DATE)'
161
ASCIIDOC_DEPS = asciidoc.conf GIT-ASCIIDOCFLAGS
162
TXT_TO_HTML = $(ASCIIDOC_COMMON) -b $(ASCIIDOC_HTML)
163
TXT_TO_XML = $(ASCIIDOC_COMMON) -b $(ASCIIDOC_DOCBOOK)
164
MANPAGE_XSL = manpage-normal.xsl
165
XMLTO = xmlto
166
XMLTO_EXTRA =
167
INSTALL ?= install
168
RM ?= rm -f
169
MAN_REPO = ../../git-manpages
170
HTML_REPO = ../../git-htmldocs
171

172
MAKEINFO = makeinfo
173
INSTALL_INFO = install-info
174
DOCBOOK2X_TEXI = docbook2x-texi
175
DBLATEX = dblatex
176
ASCIIDOC_DBLATEX_DIR = /etc/asciidoc/dblatex
177
DBLATEX_COMMON = -p $(ASCIIDOC_DBLATEX_DIR)/asciidoc-dblatex.xsl -s $(ASCIIDOC_DBLATEX_DIR)/asciidoc-dblatex.sty
178
ifndef PERL_PATH
179
	PERL_PATH = /usr/bin/perl
180
endif
181

182
-include ../config.mak.autogen
183
-include ../config.mak
184

185
ifndef NO_MAN_BOLD_LITERAL
186
XMLTO_EXTRA += -m manpage-bold-literal.xsl
187
endif
188

189
# Newer DocBook stylesheet emits warning cruft in the output when
190
# this is not set, and if set it shows an absolute link.  Older
191
# stylesheets simply ignore this parameter.
192
#
193
# Distros may want to use MAN_BASE_URL=file:///path/to/git/docs/
194
# or similar.
195
ifndef MAN_BASE_URL
196
MAN_BASE_URL = file://$(htmldir)/
197
endif
198
XMLTO_EXTRA += --stringparam man.base.url.for.relative.links='$(MAN_BASE_URL)'
199

200
ifdef USE_ASCIIDOCTOR
201
ASCIIDOC = asciidoctor
202
ASCIIDOC_CONF =
203
ASCIIDOC_HTML = xhtml5
204
ASCIIDOC_DOCBOOK = docbook5
205
ASCIIDOC_EXTRA += -acompat-mode -atabsize=8
206
ASCIIDOC_EXTRA += -I. -rasciidoctor-extensions
207
ASCIIDOC_EXTRA += -alitdd='&\#x2d;&\#x2d;'
208
ASCIIDOC_EXTRA += -adocinfo=shared
209
ASCIIDOC_DEPS = asciidoctor-extensions.rb GIT-ASCIIDOCFLAGS
210
DBLATEX_COMMON =
211
XMLTO_EXTRA += --skip-validation
212
XMLTO_EXTRA += -x manpage.xsl
213
endif
214

215
ASCIIDOC_DEPS += docinfo.html
216

217
SHELL_PATH ?= $(SHELL)
218
# Shell quote;
219
SHELL_PATH_SQ = $(subst ','\'',$(SHELL_PATH))
220

221
ifdef DEFAULT_PAGER
222
DEFAULT_PAGER_SQ = $(subst ','\'',$(DEFAULT_PAGER))
223
ASCIIDOC_EXTRA += -a 'git-default-pager=$(DEFAULT_PAGER_SQ)'
224
endif
225

226
ifdef DEFAULT_EDITOR
227
DEFAULT_EDITOR_SQ = $(subst ','\'',$(DEFAULT_EDITOR))
228
ASCIIDOC_EXTRA += -a 'git-default-editor=$(DEFAULT_EDITOR_SQ)'
229
endif
230

231
all: html man
232

233
html: $(DOC_HTML)
234

235
man: man1 man5 man7
236
man1: $(DOC_MAN1)
237
man5: $(DOC_MAN5)
238
man7: $(DOC_MAN7)
239

240
info: git.info gitman.info
241

242
pdf: user-manual.pdf
243

244
install: install-man
245

246
install-man: man
247
	$(INSTALL) -d -m 755 $(DESTDIR)$(man1dir)
248
	$(INSTALL) -d -m 755 $(DESTDIR)$(man5dir)
249
	$(INSTALL) -d -m 755 $(DESTDIR)$(man7dir)
250
	$(INSTALL) -m 644 $(DOC_MAN1) $(DESTDIR)$(man1dir)
251
	$(INSTALL) -m 644 $(DOC_MAN5) $(DESTDIR)$(man5dir)
252
	$(INSTALL) -m 644 $(DOC_MAN7) $(DESTDIR)$(man7dir)
253

254
install-info: info
255
	$(INSTALL) -d -m 755 $(DESTDIR)$(infodir)
256
	$(INSTALL) -m 644 git.info gitman.info $(DESTDIR)$(infodir)
257
	if test -r $(DESTDIR)$(infodir)/dir; then \
258
	  $(INSTALL_INFO) --info-dir=$(DESTDIR)$(infodir) git.info ;\
259
	  $(INSTALL_INFO) --info-dir=$(DESTDIR)$(infodir) gitman.info ;\
260
	else \
261
	  echo "No directory found in $(DESTDIR)$(infodir)" >&2 ; \
262
	fi
263

264
install-pdf: pdf
265
	$(INSTALL) -d -m 755 $(DESTDIR)$(pdfdir)
266
	$(INSTALL) -m 644 user-manual.pdf $(DESTDIR)$(pdfdir)
267

268
install-html: html
269
	'$(SHELL_PATH_SQ)' ./install-webdoc.sh $(DESTDIR)$(htmldir)
270

271
../GIT-VERSION-FILE: FORCE
272
	$(QUIET_SUBDIR0)../ $(QUIET_SUBDIR1) GIT-VERSION-FILE
273

274
ifneq ($(filter-out lint-docs clean,$(MAKECMDGOALS)),)
275
-include ../GIT-VERSION-FILE
276
endif
277

278
#
279
# Determine "include::" file references in asciidoc files.
280
#
281
docdep_prereqs = \
282
	mergetools-list.made $(mergetools_txt) \
283
	cmd-list.made $(cmds_txt)
284

285
doc.dep : $(docdep_prereqs) $(DOC_DEP_TXT) build-docdep.perl
286
	$(QUIET_GEN)$(PERL_PATH) ./build-docdep.perl >$@ $(QUIET_STDERR)
287

288
ifneq ($(MAKECMDGOALS),clean)
289
-include doc.dep
290
endif
291

292
cmds_txt = cmds-ancillaryinterrogators.txt \
293
	cmds-ancillarymanipulators.txt \
294
	cmds-mainporcelain.txt \
295
	cmds-plumbinginterrogators.txt \
296
	cmds-plumbingmanipulators.txt \
297
	cmds-synchingrepositories.txt \
298
	cmds-synchelpers.txt \
299
	cmds-guide.txt \
300
	cmds-developerinterfaces.txt \
301
	cmds-userinterfaces.txt \
302
	cmds-purehelpers.txt \
303
	cmds-foreignscminterface.txt
304

305
$(cmds_txt): cmd-list.made
306

307
cmd-list.made: cmd-list.perl ../command-list.txt $(MAN1_TXT)
308
	$(QUIET_GEN)$(PERL_PATH) ./cmd-list.perl ../command-list.txt $(cmds_txt) $(QUIET_STDERR) && \
309
	date >$@
310

311
mergetools_txt = mergetools-diff.txt mergetools-merge.txt
312

313
$(mergetools_txt): mergetools-list.made
314

315
mergetools-list.made: ../git-mergetool--lib.sh $(wildcard ../mergetools/*)
316
	$(QUIET_GEN) \
317
	$(SHELL_PATH) -c 'MERGE_TOOLS_DIR=../mergetools && TOOL_MODE=diff && \
318
		. ../git-mergetool--lib.sh && \
319
		show_tool_names can_diff' | sed -e "s/\([a-z0-9]*\)/\`\1\`;;/" >mergetools-diff.txt && \
320
	$(SHELL_PATH) -c 'MERGE_TOOLS_DIR=../mergetools && TOOL_MODE=merge && \
321
		. ../git-mergetool--lib.sh && \
322
		show_tool_names can_merge' | sed -e "s/\([a-z0-9]*\)/\`\1\`;;/" >mergetools-merge.txt && \
323
	date >$@
324

325
TRACK_ASCIIDOCFLAGS = $(subst ','\'',$(ASCIIDOC_COMMON):$(ASCIIDOC_HTML):$(ASCIIDOC_DOCBOOK))
326

327
GIT-ASCIIDOCFLAGS: FORCE
328
	@FLAGS='$(TRACK_ASCIIDOCFLAGS)'; \
329
	    if test x"$$FLAGS" != x"`cat GIT-ASCIIDOCFLAGS 2>/dev/null`" ; then \
330
		echo >&2 "    * new asciidoc flags"; \
331
		echo "$$FLAGS" >GIT-ASCIIDOCFLAGS; \
332
            fi
333

334
clean:
335
	$(RM) -rf .build/
336
	$(RM) *.xml *.xml+ *.html *.html+ *.1 *.5 *.7
337
	$(RM) *.texi *.texi+ *.texi++ git.info gitman.info
338
	$(RM) *.pdf
339
	$(RM) howto-index.txt howto/*.html doc.dep
340
	$(RM) technical/*.html technical/api-index.txt
341
	$(RM) SubmittingPatches.txt
342
	$(RM) $(cmds_txt) $(mergetools_txt) *.made
343
	$(RM) GIT-ASCIIDOCFLAGS
344

345
docinfo.html: docinfo-html.in
346
	$(QUIET_GEN)$(RM) $@ && cat $< >$@
347

348
$(MAN_HTML): %.html : %.txt $(ASCIIDOC_DEPS)
349
	$(QUIET_ASCIIDOC)$(TXT_TO_HTML) -d manpage -o $@ $<
350

351
$(OBSOLETE_HTML): %.html : %.txto $(ASCIIDOC_DEPS)
352
	$(QUIET_ASCIIDOC)$(TXT_TO_HTML) -o $@ $<
353

354
manpage-prereqs := $(wildcard manpage*.xsl)
355
manpage-cmd = $(QUIET_XMLTO)$(XMLTO) -m $(MANPAGE_XSL) $(XMLTO_EXTRA) man $<
356

357
%.1 : %.xml $(manpage-prereqs)
358
	$(manpage-cmd)
359
%.5 : %.xml $(manpage-prereqs)
360
	$(manpage-cmd)
361
%.7 : %.xml $(manpage-prereqs)
362
	$(manpage-cmd)
363

364
%.xml : %.txt $(ASCIIDOC_DEPS)
365
	$(QUIET_ASCIIDOC)$(TXT_TO_XML) -d manpage -o $@ $<
366

367
user-manual.xml: user-manual.txt user-manual.conf asciidoctor-extensions.rb GIT-ASCIIDOCFLAGS
368
	$(QUIET_ASCIIDOC)$(TXT_TO_XML) -d book -o $@ $<
369

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
373

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
378

379
SubmittingPatches.txt: SubmittingPatches
380
	$(QUIET_GEN) cp $< $@
381

382
XSLT = docbook.xsl
383
XSLTOPTS =
384
XSLTOPTS += --xinclude
385
XSLTOPTS += --stringparam html.stylesheet docbook-xsl.css
386
XSLTOPTS += --param generate.consistent.ids 1
387

388
user-manual.html: user-manual.xml $(XSLT)
389
	$(QUIET_XSLTPROC)xsltproc $(XSLTOPTS) -o $@ $(XSLT) $<
390

391
git.info: user-manual.texi
392
	$(QUIET_MAKEINFO)$(MAKEINFO) --no-split -o $@ user-manual.texi
393

394
user-manual.texi: user-manual.xml
395
	$(QUIET_DB2TEXI)$(DOCBOOK2X_TEXI) user-manual.xml --encoding=UTF-8 --to-stdout >$@+ && \
396
	$(PERL_PATH) fix-texi.perl <$@+ >$@ && \
397
	$(RM) $@+
398

399
user-manual.pdf: user-manual.xml
400
	$(QUIET_DBLATEX)$(DBLATEX) -o $@ $(DBLATEX_COMMON) $<
401

402
gitman.texi: $(MAN_XML) cat-texi.perl texi.xsl
403
	$(QUIET_DB2TEXI) \
404
	($(foreach xml,$(sort $(MAN_XML)),xsltproc -o $(xml)+ texi.xsl $(xml) && \
405
		$(DOCBOOK2X_TEXI) --encoding=UTF-8 --to-stdout $(xml)+ && \
406
		$(RM) $(xml)+ &&) true) > $@+ && \
407
	$(PERL_PATH) cat-texi.perl $@ <$@+ >$@ && \
408
	$(RM) $@+
409

410
gitman.info: gitman.texi
411
	$(QUIET_MAKEINFO)$(MAKEINFO) --no-split --no-validate $<
412

413
$(patsubst %.txt,%.texi,$(MAN_TXT)): %.texi : %.xml
414
	$(QUIET_DB2TEXI)$(DOCBOOK2X_TEXI) --to-stdout $*.xml >$@
415

416
howto-index.txt: howto-index.sh $(HOWTO_TXT)
417
	$(QUIET_GEN)'$(SHELL_PATH_SQ)' ./howto-index.sh $(sort $(HOWTO_TXT)) >$@
418

419
$(patsubst %,%.html,$(ARTICLES)) : %.html : %.txt
420
	$(QUIET_ASCIIDOC)$(TXT_TO_HTML) $*.txt
421

422
WEBDOC_DEST = /pub/software/scm/git/docs
423

424
howto/%.html: ASCIIDOC_EXTRA += -a git-relative-html-prefix=../
425
$(patsubst %.txt,%.html,$(HOWTO_TXT)): %.html : %.txt GIT-ASCIIDOCFLAGS
426
	$(QUIET_ASCIIDOC) \
427
	sed -e '1,/^$$/d' $< | \
428
	$(TXT_TO_HTML) - >$@
429

430
install-webdoc : html
431
	'$(SHELL_PATH_SQ)' ./install-webdoc.sh $(WEBDOC_DEST)
432

433
# You must have a clone of 'git-htmldocs' and 'git-manpages' repositories
434
# next to the 'git' repository itself for the following to work.
435

436
quick-install: quick-install-man
437

438
require-manrepo::
439
	@if test ! -d $(MAN_REPO); \
440
	then echo "git-manpages repository must exist at $(MAN_REPO)"; exit 1; fi
441

442
quick-install-man: require-manrepo
443
	'$(SHELL_PATH_SQ)' ./install-doc-quick.sh $(MAN_REPO) $(DESTDIR)$(mandir) $(GIT_MAN_REF)
444

445
require-htmlrepo::
446
	@if test ! -d $(HTML_REPO); \
447
	then echo "git-htmldocs repository must exist at $(HTML_REPO)"; exit 1; fi
448

449
quick-install-html: require-htmlrepo
450
	'$(SHELL_PATH_SQ)' ./install-doc-quick.sh $(HTML_REPO) $(DESTDIR)$(htmldir) $(GIT_MAN_REF)
451

452
print-man1:
453
	@for i in $(MAN1_TXT); do echo $$i; done
454

455
## Lint: gitlink
456
LINT_DOCS_GITLINK = $(patsubst %.txt,.build/lint-docs/gitlink/%.ok,$(HOWTO_TXT) $(DOC_DEP_TXT))
457
$(LINT_DOCS_GITLINK): lint-gitlink.perl
458
$(LINT_DOCS_GITLINK): .build/lint-docs/gitlink/%.ok: %.txt
459
	$(call mkdir_p_parent_template)
460
	$(QUIET_LINT_GITLINK)$(PERL_PATH) lint-gitlink.perl \
461
		$< \
462
		$(HOWTO_TXT) $(DOC_DEP_TXT) \
463
		--section=1 $(MAN1_TXT) \
464
		--section=5 $(MAN5_TXT) \
465
		--section=7 $(MAN7_TXT) >$@
466
.PHONY: lint-docs-gitlink
467
lint-docs-gitlink: $(LINT_DOCS_GITLINK)
468

469
## Lint: man-end-blurb
470
LINT_DOCS_MAN_END_BLURB = $(patsubst %.txt,.build/lint-docs/man-end-blurb/%.ok,$(MAN_TXT))
471
$(LINT_DOCS_MAN_END_BLURB): lint-man-end-blurb.perl
472
$(LINT_DOCS_MAN_END_BLURB): .build/lint-docs/man-end-blurb/%.ok: %.txt
473
	$(call mkdir_p_parent_template)
474
	$(QUIET_LINT_MANEND)$(PERL_PATH) lint-man-end-blurb.perl $< >$@
475
.PHONY: lint-docs-man-end-blurb
476

477
## Lint: man-section-order
478
LINT_DOCS_MAN_SECTION_ORDER = $(patsubst %.txt,.build/lint-docs/man-section-order/%.ok,$(MAN_TXT))
479
$(LINT_DOCS_MAN_SECTION_ORDER): lint-man-section-order.perl
480
$(LINT_DOCS_MAN_SECTION_ORDER): .build/lint-docs/man-section-order/%.ok: %.txt
481
	$(call mkdir_p_parent_template)
482
	$(QUIET_LINT_MANSEC)$(PERL_PATH) lint-man-section-order.perl $< >$@
483
.PHONY: lint-docs-man-section-order
484
lint-docs-man-section-order: $(LINT_DOCS_MAN_SECTION_ORDER)
485

486
.PHONY: lint-docs-fsck-msgids
487
LINT_DOCS_FSCK_MSGIDS = .build/lint-docs/fsck-msgids.ok
488
$(LINT_DOCS_FSCK_MSGIDS): lint-fsck-msgids.perl
489
$(LINT_DOCS_FSCK_MSGIDS): ../fsck.h fsck-msgids.txt
490
	$(call mkdir_p_parent_template)
491
	$(QUIET_GEN)$(PERL_PATH) lint-fsck-msgids.perl \
492
		../fsck.h fsck-msgids.txt $@
493

494
lint-docs-fsck-msgids: $(LINT_DOCS_FSCK_MSGIDS)
495

496
lint-docs-manpages:
497
	$(QUIET_GEN)./lint-manpages.sh
498

499
## Lint: list of targets above
500
.PHONY: lint-docs
501
lint-docs: lint-docs-fsck-msgids
502
lint-docs: lint-docs-gitlink
503
lint-docs: lint-docs-man-end-blurb
504
lint-docs: lint-docs-man-section-order
505
lint-docs: lint-docs-manpages
506

507
ifeq ($(wildcard po/Makefile),po/Makefile)
508
doc-l10n install-l10n::
509
	$(MAKE) -C po $@
510
endif
511

512
.PHONY: FORCE
513