1
manpages = {
2
# Category 1.
3
- 'git-add.txt' : 1,
4
- 'git-am.txt' : 1,
5
- 'git-annotate.txt' : 1,
6
- 'git-apply.txt' : 1,
7
- 'git-archimport.txt' : 1,
8
- 'git-archive.txt' : 1,
9
- 'git-bisect.txt' : 1,
10
- 'git-blame.txt' : 1,
11
- 'git-branch.txt' : 1,
12
- 'git-bugreport.txt' : 1,
13
- 'git-bundle.txt' : 1,
14
- 'git-cat-file.txt' : 1,
15
- 'git-check-attr.txt' : 1,
16
- 'git-check-ignore.txt' : 1,
17
- 'git-check-mailmap.txt' : 1,
18
- 'git-checkout-index.txt' : 1,
19
- 'git-checkout.txt' : 1,
20
- 'git-check-ref-format.txt' : 1,
21
- 'git-cherry-pick.txt' : 1,
22
- 'git-cherry.txt' : 1,
23
- 'git-citool.txt' : 1,
24
- 'git-clean.txt' : 1,
25
- 'git-clone.txt' : 1,
26
- 'git-column.txt' : 1,
27
- 'git-commit-graph.txt' : 1,
28
- 'git-commit-tree.txt' : 1,
29
- 'git-commit.txt' : 1,
30
- 'git-config.txt' : 1,
31
- 'git-count-objects.txt' : 1,
32
- 'git-credential-cache--daemon.txt' : 1,
33
- 'git-credential-cache.txt' : 1,
34
- 'git-credential-store.txt' : 1,
35
- 'git-credential.txt' : 1,
36
- 'git-cvsexportcommit.txt' : 1,
37
- 'git-cvsimport.txt' : 1,
38
- 'git-cvsserver.txt' : 1,
39
- 'git-daemon.txt' : 1,
40
- 'git-describe.txt' : 1,
41
- 'git-diagnose.txt' : 1,
42
- 'git-diff-files.txt' : 1,
43
- 'git-diff-index.txt' : 1,
44
- 'git-difftool.txt' : 1,
45
- 'git-diff-tree.txt' : 1,
46
- 'git-diff.txt' : 1,
47
- 'git-fast-export.txt' : 1,
48
- 'git-fast-import.txt' : 1,
49
- 'git-fetch-pack.txt' : 1,
50
- 'git-fetch.txt' : 1,
51
- 'git-filter-branch.txt' : 1,
52
- 'git-fmt-merge-msg.txt' : 1,
53
- 'git-for-each-ref.txt' : 1,
54
- 'git-for-each-repo.txt' : 1,
55
- 'git-format-patch.txt' : 1,
56
- 'git-fsck-objects.txt' : 1,
57
- 'git-fsck.txt' : 1,
58
- 'git-fsmonitor--daemon.txt' : 1,
59
- 'git-gc.txt' : 1,
60
- 'git-get-tar-commit-id.txt' : 1,
61
- 'git-grep.txt' : 1,
62
- 'git-gui.txt' : 1,
63
- 'git-hash-object.txt' : 1,
64
- 'git-help.txt' : 1,
65
- 'git-hook.txt' : 1,
66
- 'git-http-backend.txt' : 1,
67
- 'git-http-fetch.txt' : 1,
68
- 'git-http-push.txt' : 1,
69
- 'git-imap-send.txt' : 1,
70
- 'git-index-pack.txt' : 1,
71
- 'git-init-db.txt' : 1,
72
- 'git-init.txt' : 1,
73
- 'git-instaweb.txt' : 1,
74
- 'git-interpret-trailers.txt' : 1,
75
- 'git-log.txt' : 1,
76
- 'git-ls-files.txt' : 1,
77
- 'git-ls-remote.txt' : 1,
78
- 'git-ls-tree.txt' : 1,
79
- 'git-mailinfo.txt' : 1,
80
- 'git-mailsplit.txt' : 1,
81
- 'git-maintenance.txt' : 1,
82
- 'git-merge-base.txt' : 1,
83
- 'git-merge-file.txt' : 1,
84
- 'git-merge-index.txt' : 1,
85
- 'git-merge-one-file.txt' : 1,
86
- 'git-mergetool--lib.txt' : 1,
87
- 'git-mergetool.txt' : 1,
88
- 'git-merge-tree.txt' : 1,
89
- 'git-merge.txt' : 1,
90
- 'git-mktag.txt' : 1,
91
- 'git-mktree.txt' : 1,
92
- 'git-multi-pack-index.txt' : 1,
93
- 'git-mv.txt' : 1,
94
- 'git-name-rev.txt' : 1,
95
- 'git-notes.txt' : 1,
96
- 'git-p4.txt' : 1,
97
- 'git-pack-objects.txt' : 1,
98
- 'git-pack-redundant.txt' : 1,
99
- 'git-pack-refs.txt' : 1,
100
- 'git-patch-id.txt' : 1,
101
- 'git-prune-packed.txt' : 1,
102
- 'git-prune.txt' : 1,
103
- 'git-pull.txt' : 1,
104
- 'git-push.txt' : 1,
105
- 'git-quiltimport.txt' : 1,
106
- 'git-range-diff.txt' : 1,
107
- 'git-read-tree.txt' : 1,
108
- 'git-rebase.txt' : 1,
109
- 'git-receive-pack.txt' : 1,
110
- 'git-reflog.txt' : 1,
111
- 'git-refs.txt' : 1,
112
- 'git-remote-ext.txt' : 1,
113
- 'git-remote-fd.txt' : 1,
114
- 'git-remote.txt' : 1,
115
- 'git-repack.txt' : 1,
116
- 'git-replace.txt' : 1,
117
- 'git-replay.txt' : 1,
118
- 'git-request-pull.txt' : 1,
119
- 'git-rerere.txt' : 1,
120
- 'git-reset.txt' : 1,
121
- 'git-restore.txt' : 1,
122
- 'git-revert.txt' : 1,
123
- 'git-rev-list.txt' : 1,
124
- 'git-rev-parse.txt' : 1,
125
- 'git-rm.txt' : 1,
126
- 'git-send-email.txt' : 1,
127
- 'git-send-pack.txt' : 1,
128
- 'git-shell.txt' : 1,
129
- 'git-sh-i18n--envsubst.txt' : 1,
130
- 'git-sh-i18n.txt' : 1,
131
- 'git-shortlog.txt' : 1,
132
- 'git-show-branch.txt' : 1,
133
- 'git-show-index.txt' : 1,
134
- 'git-show-ref.txt' : 1,
135
- 'git-show.txt' : 1,
136
- 'git-sh-setup.txt' : 1,
137
- 'git-sparse-checkout.txt' : 1,
138
- 'git-stage.txt' : 1,
139
- 'git-stash.txt' : 1,
140
- 'git-status.txt' : 1,
141
- 'git-stripspace.txt' : 1,
142
- 'git-submodule.txt' : 1,
143
- 'git-svn.txt' : 1,
144
- 'git-switch.txt' : 1,
145
- 'git-symbolic-ref.txt' : 1,
146
- 'git-tag.txt' : 1,
147
- 'git-unpack-file.txt' : 1,
148
- 'git-unpack-objects.txt' : 1,
149
- 'git-update-index.txt' : 1,
150
- 'git-update-ref.txt' : 1,
151
- 'git-update-server-info.txt' : 1,
152
- 'git-upload-archive.txt' : 1,
153
- 'git-upload-pack.txt' : 1,
154
- 'git-var.txt' : 1,
155
- 'git-verify-commit.txt' : 1,
156
- 'git-verify-pack.txt' : 1,
157
- 'git-verify-tag.txt' : 1,
158
- 'git-version.txt' : 1,
159
- 'git-web--browse.txt' : 1,
160
- 'git-whatchanged.txt' : 1,
161
- 'git-worktree.txt' : 1,
162
- 'git-write-tree.txt' : 1,
163
- 'git.txt' : 1,
164
- 'gitk.txt' : 1,
165
- 'gitweb.txt' : 1,
166
- 'scalar.txt' : 1,
3
+ 'git-add.adoc' : 1,
4
+ 'git-am.adoc' : 1,
5
+ 'git-annotate.adoc' : 1,
6
+ 'git-apply.adoc' : 1,
7
+ 'git-archimport.adoc' : 1,
8
+ 'git-archive.adoc' : 1,
9
+ 'git-bisect.adoc' : 1,
10
+ 'git-blame.adoc' : 1,
11
+ 'git-branch.adoc' : 1,
12
+ 'git-bugreport.adoc' : 1,
13
+ 'git-bundle.adoc' : 1,
14
+ 'git-cat-file.adoc' : 1,
15
+ 'git-check-attr.adoc' : 1,
16
+ 'git-check-ignore.adoc' : 1,
17
+ 'git-check-mailmap.adoc' : 1,
18
+ 'git-checkout-index.adoc' : 1,
19
+ 'git-checkout.adoc' : 1,
20
+ 'git-check-ref-format.adoc' : 1,
21
+ 'git-cherry-pick.adoc' : 1,
22
+ 'git-cherry.adoc' : 1,
23
+ 'git-citool.adoc' : 1,
24
+ 'git-clean.adoc' : 1,
25
+ 'git-clone.adoc' : 1,
26
+ 'git-column.adoc' : 1,
27
+ 'git-commit-graph.adoc' : 1,
28
+ 'git-commit-tree.adoc' : 1,
29
+ 'git-commit.adoc' : 1,
30
+ 'git-config.adoc' : 1,
31
+ 'git-count-objects.adoc' : 1,
32
+ 'git-credential-cache--daemon.adoc' : 1,
33
+ 'git-credential-cache.adoc' : 1,
34
+ 'git-credential-store.adoc' : 1,
35
+ 'git-credential.adoc' : 1,
36
+ 'git-cvsexportcommit.adoc' : 1,
37
+ 'git-cvsimport.adoc' : 1,
38
+ 'git-cvsserver.adoc' : 1,
39
+ 'git-daemon.adoc' : 1,
40
+ 'git-describe.adoc' : 1,
41
+ 'git-diagnose.adoc' : 1,
42
+ 'git-diff-files.adoc' : 1,
43
+ 'git-diff-index.adoc' : 1,
44
+ 'git-difftool.adoc' : 1,
45
+ 'git-diff-tree.adoc' : 1,
46
+ 'git-diff.adoc' : 1,
47
+ 'git-fast-export.adoc' : 1,
48
+ 'git-fast-import.adoc' : 1,
49
+ 'git-fetch-pack.adoc' : 1,
50
+ 'git-fetch.adoc' : 1,
51
+ 'git-filter-branch.adoc' : 1,
52
+ 'git-fmt-merge-msg.adoc' : 1,
53
+ 'git-for-each-ref.adoc' : 1,
54
+ 'git-for-each-repo.adoc' : 1,
55
+ 'git-format-patch.adoc' : 1,
56
+ 'git-fsck-objects.adoc' : 1,
57
+ 'git-fsck.adoc' : 1,
58
+ 'git-fsmonitor--daemon.adoc' : 1,
59
+ 'git-gc.adoc' : 1,
60
+ 'git-get-tar-commit-id.adoc' : 1,
61
+ 'git-grep.adoc' : 1,
62
+ 'git-gui.adoc' : 1,
63
+ 'git-hash-object.adoc' : 1,
64
+ 'git-help.adoc' : 1,
65
+ 'git-hook.adoc' : 1,
66
+ 'git-http-backend.adoc' : 1,
67
+ 'git-http-fetch.adoc' : 1,
68
+ 'git-http-push.adoc' : 1,
69
+ 'git-imap-send.adoc' : 1,
70
+ 'git-index-pack.adoc' : 1,
71
+ 'git-init-db.adoc' : 1,
72
+ 'git-init.adoc' : 1,
73
+ 'git-instaweb.adoc' : 1,
74
+ 'git-interpret-trailers.adoc' : 1,
75
+ 'git-log.adoc' : 1,
76
+ 'git-ls-files.adoc' : 1,
77
+ 'git-ls-remote.adoc' : 1,
78
+ 'git-ls-tree.adoc' : 1,
79
+ 'git-mailinfo.adoc' : 1,
80
+ 'git-mailsplit.adoc' : 1,
81
+ 'git-maintenance.adoc' : 1,
82
+ 'git-merge-base.adoc' : 1,
83
+ 'git-merge-file.adoc' : 1,
84
+ 'git-merge-index.adoc' : 1,
85
+ 'git-merge-one-file.adoc' : 1,
86
+ 'git-mergetool--lib.adoc' : 1,
87
+ 'git-mergetool.adoc' : 1,
88
+ 'git-merge-tree.adoc' : 1,
89
+ 'git-merge.adoc' : 1,
90
+ 'git-mktag.adoc' : 1,
91
+ 'git-mktree.adoc' : 1,
92
+ 'git-multi-pack-index.adoc' : 1,
93
+ 'git-mv.adoc' : 1,
94
+ 'git-name-rev.adoc' : 1,
95
+ 'git-notes.adoc' : 1,
96
+ 'git-p4.adoc' : 1,
97
+ 'git-pack-objects.adoc' : 1,
98
+ 'git-pack-redundant.adoc' : 1,
99
+ 'git-pack-refs.adoc' : 1,
100
+ 'git-patch-id.adoc' : 1,
101
+ 'git-prune-packed.adoc' : 1,
102
+ 'git-prune.adoc' : 1,
103
+ 'git-pull.adoc' : 1,
104
+ 'git-push.adoc' : 1,
105
+ 'git-quiltimport.adoc' : 1,
106
+ 'git-range-diff.adoc' : 1,
107
+ 'git-read-tree.adoc' : 1,
108
+ 'git-rebase.adoc' : 1,
109
+ 'git-receive-pack.adoc' : 1,
110
+ 'git-reflog.adoc' : 1,
111
+ 'git-refs.adoc' : 1,
112
+ 'git-remote-ext.adoc' : 1,
113
+ 'git-remote-fd.adoc' : 1,
114
+ 'git-remote.adoc' : 1,
115
+ 'git-repack.adoc' : 1,
116
+ 'git-replace.adoc' : 1,
117
+ 'git-replay.adoc' : 1,
118
+ 'git-request-pull.adoc' : 1,
119
+ 'git-rerere.adoc' : 1,
120
+ 'git-reset.adoc' : 1,
121
+ 'git-restore.adoc' : 1,
122
+ 'git-revert.adoc' : 1,
123
+ 'git-rev-list.adoc' : 1,
124
+ 'git-rev-parse.adoc' : 1,
125
+ 'git-rm.adoc' : 1,
126
+ 'git-send-email.adoc' : 1,
127
+ 'git-send-pack.adoc' : 1,
128
+ 'git-shell.adoc' : 1,
129
+ 'git-sh-i18n--envsubst.adoc' : 1,
130
+ 'git-sh-i18n.adoc' : 1,
131
+ 'git-shortlog.adoc' : 1,
132
+ 'git-show-branch.adoc' : 1,
133
+ 'git-show-index.adoc' : 1,
134
+ 'git-show-ref.adoc' : 1,
135
+ 'git-show.adoc' : 1,
136
+ 'git-sh-setup.adoc' : 1,
137
+ 'git-sparse-checkout.adoc' : 1,
138
+ 'git-stage.adoc' : 1,
139
+ 'git-stash.adoc' : 1,
140
+ 'git-status.adoc' : 1,
141
+ 'git-stripspace.adoc' : 1,
142
+ 'git-submodule.adoc' : 1,
143
+ 'git-svn.adoc' : 1,
144
+ 'git-switch.adoc' : 1,
145
+ 'git-symbolic-ref.adoc' : 1,
146
+ 'git-tag.adoc' : 1,
147
+ 'git-unpack-file.adoc' : 1,
148
+ 'git-unpack-objects.adoc' : 1,
149
+ 'git-update-index.adoc' : 1,
150
+ 'git-update-ref.adoc' : 1,
151
+ 'git-update-server-info.adoc' : 1,
152
+ 'git-upload-archive.adoc' : 1,
153
+ 'git-upload-pack.adoc' : 1,
154
+ 'git-var.adoc' : 1,
155
+ 'git-verify-commit.adoc' : 1,
156
+ 'git-verify-pack.adoc' : 1,
157
+ 'git-verify-tag.adoc' : 1,
158
+ 'git-version.adoc' : 1,
159
+ 'git-web--browse.adoc' : 1,
160
+ 'git-whatchanged.adoc' : 1,
161
+ 'git-worktree.adoc' : 1,
162
+ 'git-write-tree.adoc' : 1,
163
+ 'git.adoc' : 1,
164
+ 'gitk.adoc' : 1,
165
+ 'gitweb.adoc' : 1,
166
+ 'scalar.adoc' : 1,
167
168
# Category 5.
169
- 'gitattributes.txt' : 5,
170
- 'gitformat-bundle.txt' : 5,
171
- 'gitformat-chunk.txt' : 5,
172
- 'gitformat-commit-graph.txt' : 5,
173
- 'gitformat-index.txt' : 5,
174
- 'gitformat-pack.txt' : 5,
175
- 'gitformat-signature.txt' : 5,
176
- 'githooks.txt' : 5,
177
- 'gitignore.txt' : 5,
178
- 'gitmailmap.txt' : 5,
179
- 'gitmodules.txt' : 5,
180
- 'gitprotocol-capabilities.txt' : 5,
181
- 'gitprotocol-common.txt' : 5,
182
- 'gitprotocol-http.txt' : 5,
183
- 'gitprotocol-pack.txt' : 5,
184
- 'gitprotocol-v2.txt' : 5,
185
- 'gitrepository-layout.txt' : 5,
186
- 'gitweb.conf.txt' : 5,
169
+ 'gitattributes.adoc' : 5,
170
+ 'gitformat-bundle.adoc' : 5,
171
+ 'gitformat-chunk.adoc' : 5,
172
+ 'gitformat-commit-graph.adoc' : 5,
173
+ 'gitformat-index.adoc' : 5,
174
+ 'gitformat-pack.adoc' : 5,
175
+ 'gitformat-signature.adoc' : 5,
176
+ 'githooks.adoc' : 5,
177
+ 'gitignore.adoc' : 5,
178
+ 'gitmailmap.adoc' : 5,
179
+ 'gitmodules.adoc' : 5,
180
+ 'gitprotocol-capabilities.adoc' : 5,
181
+ 'gitprotocol-common.adoc' : 5,
182
+ 'gitprotocol-http.adoc' : 5,
183
+ 'gitprotocol-pack.adoc' : 5,
184
+ 'gitprotocol-v2.adoc' : 5,
185
+ 'gitrepository-layout.adoc' : 5,
186
+ 'gitweb.conf.adoc' : 5,
187
188
# Category 7.
189
- 'gitcli.txt' : 7,
190
- 'gitcore-tutorial.txt' : 7,
191
- 'gitcredentials.txt' : 7,
192
- 'gitcvs-migration.txt' : 7,
193
- 'gitdiffcore.txt' : 7,
194
- 'giteveryday.txt' : 7,
195
- 'gitfaq.txt' : 7,
196
- 'gitglossary.txt' : 7,
197
- 'gitpacking.txt' : 7,
198
- 'gitnamespaces.txt' : 7,
199
- 'gitremote-helpers.txt' : 7,
200
- 'gitrevisions.txt' : 7,
201
- 'gitsubmodules.txt' : 7,
202
- 'gittutorial-2.txt' : 7,
203
- 'gittutorial.txt' : 7,
204
- 'gitworkflows.txt' : 7,
189
+ 'gitcli.adoc' : 7,
190
+ 'gitcore-tutorial.adoc' : 7,
191
+ 'gitcredentials.adoc' : 7,
192
+ 'gitcvs-migration.adoc' : 7,
193
+ 'gitdiffcore.adoc' : 7,
194
+ 'giteveryday.adoc' : 7,
195
+ 'gitfaq.adoc' : 7,
196
+ 'gitglossary.adoc' : 7,
197
+ 'gitpacking.adoc' : 7,
198
+ 'gitnamespaces.adoc' : 7,
199
+ 'gitremote-helpers.adoc' : 7,
200
+ 'gitrevisions.adoc' : 7,
201
+ 'gitsubmodules.adoc' : 7,
202
+ 'gittutorial-2.adoc' : 7,
203
+ 'gittutorial.adoc' : 7,
204
+ 'gitworkflows.adoc' : 7,
205
}
206
207
docs_backend = get_option('docs_backend')
287
xmlto = find_program('xmlto')
288
289
cmd_lists = [
290
- 'cmds-ancillaryinterrogators.txt',
291
- 'cmds-ancillarymanipulators.txt',
292
- 'cmds-mainporcelain.txt',
293
- 'cmds-plumbinginterrogators.txt',
294
- 'cmds-plumbingmanipulators.txt',
295
- 'cmds-synchingrepositories.txt',
296
- 'cmds-synchelpers.txt',
297
- 'cmds-guide.txt',
298
- 'cmds-developerinterfaces.txt',
299
- 'cmds-userinterfaces.txt',
300
- 'cmds-purehelpers.txt',
301
- 'cmds-foreignscminterface.txt',
290
+ 'cmds-ancillaryinterrogators.adoc',
291
+ 'cmds-ancillarymanipulators.adoc',
292
+ 'cmds-mainporcelain.adoc',
293
+ 'cmds-plumbinginterrogators.adoc',
294
+ 'cmds-plumbingmanipulators.adoc',
295
+ 'cmds-synchingrepositories.adoc',
296
+ 'cmds-synchelpers.adoc',
297
+ 'cmds-guide.adoc',
298
+ 'cmds-developerinterfaces.adoc',
299
+ 'cmds-userinterfaces.adoc',
300
+ 'cmds-purehelpers.adoc',
301
+ 'cmds-foreignscminterface.adoc',
302
]
303
304
documentation_deps += custom_target(
325
'MERGE_TOOLS_DIR=' + meson.project_source_root() / 'mergetools',
326
],
327
input: 'generate-mergetool-list.sh',
328
- output: 'mergetools-' + mode + '.txt',
328
+ output: 'mergetools-' + mode + '.adoc',
329
)
330
endforeach
331
414
'--out-file=@OUTPUT@',
415
'@INPUT@',
416
],
417
- input: 'user-manual.txt',
417
+ input: 'user-manual.adoc',
418
output: 'user-manual.xml',
419
depends: documentation_deps,
420
)
436
)
437
438
articles = [
439
- 'DecisionMaking.txt',
440
- 'MyFirstContribution.txt',
441
- 'MyFirstObjectWalk.txt',
442
- 'ReviewingGuidelines.txt',
439
+ 'DecisionMaking.adoc',
440
+ 'MyFirstContribution.adoc',
441
+ 'MyFirstObjectWalk.adoc',
442
+ 'ReviewingGuidelines.adoc',
443
'SubmittingPatches',
444
- 'ToolsForGit.txt',
445
- 'git-bisect-lk2009.txt',
446
- 'git-tools.txt',
444
+ 'ToolsForGit.adoc',
445
+ 'git-bisect-lk2009.adoc',
446
+ 'git-tools.adoc',
447
]
448
449
foreach article : articles
475
# Sanity check that we are not missing any tests present in 't/'. This check
476
# only runs once at configure time and is thus best-effort, only. Furthermore,
477
# it only verifies man pages for the sake of simplicity.
478
-configured_manpages = manpages.keys() + [ 'git-bisect-lk2009.txt', 'git-tools.txt' ]
479
-actual_manpages = run_command(shell, '-c', 'ls git*.txt scalar.txt',
478
+configured_manpages = manpages.keys() + [ 'git-bisect-lk2009.adoc', 'git-tools.adoc' ]
479
+actual_manpages = run_command(shell, '-c', 'ls git*.adoc scalar.adoc',
480
check: true,
481
env: script_environment,
482
).stdout().strip().split('\n')