3 include ../../build/rules.make
6 Resources/mdoc-html-format.xsl \
7 Resources/mdoc-html-utils.xsl \
8 Resources/mdoc-sections-css.xsl \
9 Resources/mono-ecma-css.xsl
12 Resources/defaulttemplate.xsl \
13 Resources/monodoc-ecma.xsd \
14 Resources/msitomsx.xsl \
15 Resources/overview.xsl \
16 Resources/stylesheet.xsl
18 MDOC_RESOURCES_COMMAND = $(foreach file,$(MDOC_RESOURCES),/resource:../../../external/api-doc-tools/mdoc/$(file),$(notdir $(file)))
20 MONODOC_RESOURCES_COMMAND = $(foreach file,$(MONODOC_RESOURCES),/resource:../../../external/api-doc-tools/monodoc/$(file),$(notdir $(file)))
22 LIB_REFS = monodoc System System.Xml System.Core Mono.Cecil ICSharpCode.SharpZipLib System.Xml.Linq System.Web
24 LOCAL_MCS_FLAGS = $(MDOC_RESOURCES_COMMAND) $(MONODOC_RESOURCES_COMMAND)
25 PROGRAM = $(topdir)/class/lib/$(PROFILE)/mdoc.exe
26 PROGRAM_DEPS = $(topdir)/class/lib/$(PROFILE)/monodoc.dll
29 Test/CLILibraryTypes.dtd \
31 Test/DocTest-v2.patch \
32 Test/msxdoc-expected.importslashdoc.xml \
33 Test/TestEcmaDocs.xml \
34 Test/validate.check.monodocer \
35 Test/validate.check.monodocer.importslashdoc \
36 Test/validate.check.monodocer.since
38 MULTI-CLASSIC = Test/DocTest-DropNS-classic.dll Test/DocTest-DropNS-classic-multitest.dll
39 MULTI-UNIFIED = Test/DocTest-DropNS-unified.dll Test/DocTest-DropNS-unified-multitest.dll
41 $(PROGRAM): $(PROGRAM_DEPS)
43 PROGRAM_COMPILE = $(CSCOMPILE)
45 include ../../build/executable.make
48 MONO_PATH="$(topdir)/class/lib/$(PROFILE)$(PLATFORM_PATH_SEPARATOR)$$MONO_PATH" \
49 $(RUNTIME) $(RUNTIME_FLAGS)
52 DIFF_QUIET = diff --brief
53 ifeq ($(BUILD_PLATFORM), win32)
55 DIFF_QUIET = diff --brief -Z
58 dist-local: dist-default dist-tests
61 find Test/en.expected* -name '*.xml' > .files
62 find Test/html.expected* -name '*.html' >> .files
63 tar cTf .files - | (cd $(distdir); tar xf -)
66 test-local: $(PROGRAM)
71 -rm -Rf Test/en.actual Test/html.actual
72 -rm -f monodocer1.exe*
74 Test/DocTest-addNonGeneric.dll:
75 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-addNonGeneric.cs
77 Test/DocTest-addNonGeneric-v2.dll:
78 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-addNonGeneric.cs /define:V2
80 Test/DocTest-DropNS-classic-secondary.dll:
82 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-DropNS-classic-secondary.cs
84 Test/DocTest-DropNS-classic.dll:
86 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-DropNS-classic.cs
88 Test/DocTest-DropNS-unified.dll:
89 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-DropNS-unified.cs
91 Test/DocTest-DropNS-unified-multitest.dll:
93 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-DropNS-unified.cs /define:MULTITEST
95 Test/DocTest-DropNS-classic-multitest.dll:
97 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-DropNS-classic.cs /define:MULTITEST
99 Test/DocTest-DropNS-unified-deletetest.dll:
100 rm -f Test/DocTest-DropNS-unified-deletetest.dll
101 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-DropNS-unified.cs /define:DELETETEST
103 Test/DocTest-DropNS-unified-deletetest-V2.dll:
104 rm -f Test/DocTest-DropNS-unified-deletetest.dll
105 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:Test/DocTest-DropNS-unified-deletetest.dll Test/DocTest-DropNS-unified.cs /define:DELETETEST,V2
107 Test/DocTest-DropNS-classic-deletetest.dll:
108 rm -f Test/DocTest-DropNS-classic-deletetest.dll
109 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-DropNS-classic.cs /define:DELETETEST
111 Test/DocTest-DropNS-classic-deletetest-V2.dll:
112 rm -f Test/DocTest-DropNS-classic-deletetest.dll
113 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:Test/DocTest-DropNS-classic-deletetest.dll Test/DocTest-DropNS-classic.cs /define:DELETETEST,V2
116 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest.cs -r:$(topdir)/class/lib/$(PROFILE)/System.Core.dll -r:$(topdir)/class/lib/$(PROFILE)/Microsoft.CSharp.dll
118 Test/DocTest-InternalInterface.dll:
119 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-InternalInterface.cs
122 -rm -f Test/DocTest.cs
123 cp Test/DocTest-v1.cs Test/DocTest.cs
124 -rm -f Test/DocTest.dll
125 $(MAKE) TEST_CSCFLAGS=$(TEST_CSCFLAGS) Test/DocTest.dll
128 -rm -f Test/DocTest.cs
129 cp Test/DocTest-v1.cs Test/DocTest.cs
130 cd Test && patch --binary -p0 < DocTest-v2.patch
131 -rm -f Test/DocTest.dll
132 $(MAKE) TEST_CSCFLAGS=$(TEST_CSCFLAGS) Test/DocTest.dll
134 Test/DocTest-enumerations.dll:
135 $(CSCOMPILE) $(TEST_CSCFLAGS) -unsafe -target:library -out:$@ Test/DocTest-enumerations.cs
137 check-monodocer-addNonGeneric: $(PROGRAM)
138 -rm -Rf Test/en.actual
139 # first, make a docset with the generic method
140 $(MAKE) Test/DocTest-addNonGeneric.dll
141 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-addNonGeneric.dll
143 # now add a non-generic version of the method and update several times
144 $(MAKE) Test/DocTest-addNonGeneric-v2.dll
145 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-addNonGeneric-v2.dll
146 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-addNonGeneric-v2.dll
147 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-addNonGeneric-v2.dll
148 $(DIFF) Test/en.expected-addNonGeneric Test/en.actual
150 check-monodocer-dropns-classic: $(PROGRAM)
151 # tests the simplest --dropns case, a single class where the root namespace was dropped.
152 -rm -Rf Test/en.actual
153 $(MAKE) Test/DocTest-DropNS-classic.dll
154 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-DropNS-classic.dll --api-style=classic
155 $(MAKE) update-monodocer-dropns-unified
156 $(DIFF) Test/en.expected-dropns-classic-v1 Test/en.actual
158 check-monodocer-dropns-multi: $(PROGRAM)
159 -rm -Rf Test/en.actual
160 $(MAKE) Test/DocTest-DropNS-classic.dll
161 $(MAKE) Test/DocTest-DropNS-unified.dll
162 $(MAKE) Test/DocTest-DropNS-classic-multitest.dll
163 $(MAKE) Test/DocTest-DropNS-unified-multitest.dll
165 # mdoc update for both classic and unified
166 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual $(MULTI-CLASSIC) --api-style=classic
167 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual $(MULTI-UNIFIED) --api-style=unified --dropns Test/DocTest-DropNS-unified.dll=MyFramework --dropns Test/DocTest-DropNS-unified-multitest.dll=MyFramework
169 # now run it again to verify idempotency
170 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual $(MULTI-CLASSIC) --api-style=classic
171 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual $(MULTI-UNIFIED) --api-style=unified --dropns Test/DocTest-DropNS-unified.dll=MyFramework --dropns Test/DocTest-DropNS-unified-multitest.dll=MyFramework
173 $(DIFF) Test/en.expected-dropns-multi Test/en.actual
176 check-monodocer-dropns-multi-withexisting: $(PROGRAM)
177 -rm -Rf Test/en.actual
178 $(MAKE) Test/DocTest-DropNS-classic.dll
179 $(MAKE) Test/DocTest-DropNS-unified.dll
180 $(MAKE) Test/DocTest-DropNS-classic-multitest.dll
181 $(MAKE) Test/DocTest-DropNS-unified-multitest.dll
183 # mdoc update to show a pre-existing set of documents
184 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-DropNS-classic.dll --api-style=classic
185 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-DropNS-unified.dll --api-style=unified --dropns Test/DocTest-DropNS-unified.dll=MyFramework
187 # mdoc update for both classic and unified
188 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual $(MULTI-CLASSIC) --api-style=classic
189 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual $(MULTI-UNIFIED) --api-style=unified --dropns Test/DocTest-DropNS-unified.dll=MyFramework --dropns Test/DocTest-DropNS-unified-multitest.dll=MyFramework
191 $(DIFF) Test/en.expected-dropns-multi-withexisting Test/en.actual
193 check-monodocer-dropns-delete: $(PROGRAM)
194 -rm -Rf Test/en.actual
195 rm -Rf Test/DocTest-DropNS-classic-deletetest.dll
196 rm -Rf Test/DocTest-DropNS-unified-deletetest.dll
197 $(MAKE) Test/DocTest-DropNS-classic-deletetest.dll
198 $(MONO) $(PROGRAM) update --delete --exceptions=all -o Test/en.actual Test/DocTest-DropNS-classic-deletetest.dll --api-style=classic
199 $(MAKE) Test/DocTest-DropNS-unified-deletetest.dll
200 $(MONO) $(PROGRAM) update --delete --exceptions=all -o Test/en.actual Test/DocTest-DropNS-unified-deletetest.dll --api-style=unified --dropns Test/DocTest-DropNS-unified-deletetest.dll=MyFramework
201 $(MAKE) Test/DocTest-DropNS-classic-deletetest-V2.dll
202 $(MONO) $(PROGRAM) update --delete --exceptions=all -o Test/en.actual Test/DocTest-DropNS-classic-deletetest.dll --api-style=classic
203 $(MAKE) Test/DocTest-DropNS-unified-deletetest-V2.dll
204 $(MONO) $(PROGRAM) update --delete --exceptions=all -o Test/en.actual Test/DocTest-DropNS-unified-deletetest.dll --api-style=unified --dropns Test/DocTest-DropNS-unified-deletetest.dll=MyFramework
205 $(DIFF) Test/en.expected-dropns-delete Test/en.actual
207 check-monodocer-dropns-classic-withsecondary: $(PROGRAM)
208 # tests case where a secondary assembly is included with a --dropns parameter
209 -rm -Rf Test/en.actual
210 $(MAKE) Test/DocTest-DropNS-classic.dll
211 $(MAKE) Test/DocTest-DropNS-classic-secondary.dll
212 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-DropNS-classic.dll Test/DocTest-DropNS-classic-secondary.dll --api-style=classic
213 $(MAKE) update-monodocer-dropns-unified-withsecondary
214 $(DIFF) Test/en.expected-dropns-classic-withsecondary Test/en.actual
216 update-monodocer-dropns-unified: $(PROGRAM)
217 $(MAKE) Test/DocTest-DropNS-unified.dll
218 $(MONO) $(PROGRAM) update --debug --exceptions=all -o Test/en.actual Test/DocTest-DropNS-unified.dll --api-style=unified --dropns Test/DocTest-DropNS-unified.dll=MyFramework
220 update-monodocer-dropns-unified-withsecondary: $(PROGRAM)
221 $(MAKE) Test/DocTest-DropNS-unified.dll
222 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-DropNS-unified.dll Test/DocTest-DropNS-classic-secondary.dll --api-style=unified --dropns Test/DocTest-DropNS-unified.dll=MyFramework
224 update-monodocer-dropns-classic-secondary: $(PROGRAM)
225 $(MAKE) Test/DocTest-DropNS-classic-secondary.dll
226 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-DropNS-classic-secondary.dll --api-style=classic
228 check-monodocer-internal-interface: $(PROGRAM)
229 # Tests to make sure internal interfaces that are explicitly implemented are not documented
230 -rm -Rf Test/en.actual
231 $(MAKE) Test/DocTest-InternalInterface.dll
232 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-InternalInterface.dll
233 $(DIFF) Test/en.expected-internal-interface Test/en.actual
235 check-monodocer-enumerations: $(PROGRAM)
236 -rm -Rf Test/en.actual
237 $(MAKE) Test/DocTest-enumerations.dll
238 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.actual Test/DocTest-enumerations.dll
239 $(DIFF) Test/en.expected-enumerations Test/en.actual
241 check-monodocer-update: $(PROGRAM)
242 find Test/en.expected -name \*.xml -exec rm "{}" \;
243 $(MAKE) Test/DocTest.dll-v1
244 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.expected Test/DocTest.dll
246 check-monodocer: $(PROGRAM)
247 -rm -Rf Test/en.actual
248 $(MAKE) Test/DocTest.dll-v1
249 $(MONO) $(PROGRAM) update --debug --exceptions=all -o Test/en.actual Test/DocTest.dll
250 $(DIFF) Test/en.expected Test/en.actual
251 $(MONO) $(PROGRAM) update --debug --exceptions=all -o Test/en.actual Test/DocTest.dll
252 $(DIFF) Test/en.expected Test/en.actual
254 check-monodocer-since-update: $(PROGRAM)
255 find Test/en.expected.since -name \*.xml -exec rm "{}" \;
256 $(MAKE) Test/DocTest.dll-v1
257 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.expected.since Test/DocTest.dll
258 $(MAKE) Test/DocTest.dll-v2
259 $(MONO) $(PROGRAM) update --exceptions=all --since="Version 2.0" \
260 -o Test/en.expected.since Test/DocTest.dll
262 check-monodocer-since: $(PROGRAM)
263 rm -Rf Test/en.actual
264 $(MAKE) Test/DocTest.dll-v1
265 $(MONO) $(PROGRAM) --debug update --exceptions=all -o Test/en.actual Test/DocTest.dll
266 $(MAKE) Test/DocTest.dll-v2
267 $(MONO) $(PROGRAM) --debug update --exceptions=all --since="Version 2.0" \
268 -o Test/en.actual Test/DocTest.dll
269 $(DIFF) Test/en.expected.since Test/en.actual
271 check-monodocer-delete-update: $(PROGRAM)
272 find Test/en.expected.delete -type f -exec rm "{}" \;
273 $(MAKE) Test/DocTest.dll-v1
274 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.expected.delete Test/DocTest.dll
275 $(MAKE) Test/DocTest.dll-v2
276 $(MONO) $(PROGRAM) update --exceptions=all -o Test/en.expected.delete Test/DocTest.dll
277 $(MAKE) Test/DocTest.dll-v1
278 $(MONO) $(PROGRAM) update -fno-assembly-versions --delete --exceptions=all \
279 -o Test/en.expected.delete Test/DocTest.dll
281 check-monodocer-delete: $(PROGRAM)
282 rm -Rf Test/en.actual
283 $(MAKE) Test/DocTest.dll-v1
284 $(MONO) $(PROGRAM) --debug update --exceptions=all -o Test/en.actual Test/DocTest.dll
285 $(MAKE) Test/DocTest.dll-v2
286 $(MONO) $(PROGRAM) --debug update --exceptions=all -o Test/en.actual Test/DocTest.dll
287 $(MAKE) Test/DocTest.dll-v1
288 $(MONO) $(PROGRAM) --debug update -fno-assembly-versions --delete --exceptions=all -o Test/en.actual Test/DocTest.dll
289 $(DIFF) Test/en.expected.delete Test/en.actual
291 check-monodocer-importslashdoc-update: $(PROGRAM)
292 find Test/en.expected.importslashdoc -name \*.xml -exec rm "{}" \;
293 $(MAKE) Test/DocTest.dll-v1 TEST_CSCFLAGS=-doc:Test/DocTest.xml
294 $(MONO) $(PROGRAM) --debug update --exceptions=all -i Test/DocTest.xml \
295 -o Test/en.expected.importslashdoc Test/DocTest.dll
297 check-monodocer-importslashdoc: $(PROGRAM)
298 rm -Rf Test/en.actual
299 $(MAKE) Test/DocTest.dll-v1 TEST_CSCFLAGS=-doc:Test/DocTest.xml
300 $(MONO) $(PROGRAM) --debug update --exceptions=all -i Test/DocTest.xml \
301 -o Test/en.actual Test/DocTest.dll
302 $(DIFF) Test/en.expected.importslashdoc Test/en.actual
304 check-monodocer-importecmadoc-update: $(PROGRAM)
305 find Test/en.expected.importecmadoc -name \*.xml -exec rm "{}" \;
306 $(MAKE) Test/DocTest.dll-v1
307 $(MONO) $(PROGRAM) --debug update --exceptions=all -i Test/TestEcmaDocs.xml \
308 '--type=System.Action`1' --type=System.AsyncCallback \
309 --type=System.Environment --type=System.Array \
310 -o Test/en.expected.importecmadoc Test/DocTest.dll
312 check-monodocer-importecmadoc: $(PROGRAM)
313 rm -Rf Test/en.actual
314 $(MAKE) Test/DocTest.dll-v1
315 $(MONO) $(PROGRAM) --debug update --exceptions=all -i Test/TestEcmaDocs.xml \
316 '--type=System.Action`1' --type=System.AsyncCallback \
317 --type=System.Environment --type=System.Array \
318 -o Test/en.actual Test/DocTest.dll
319 $(DIFF) Test/en.expected.importecmadoc Test/en.actual
321 check-mdoc-export-html-update: $(PROGRAM)
322 find Test/html.expected -name \*.html -exec rm "{}" \;
323 $(MONO) $(PROGRAM) export-html -o Test/html.expected \
324 Test/en.expected.importslashdoc
326 check-mdoc-export-html: check-monodocer $(PROGRAM)
327 rm -Rf Test/html.actual
328 $(MONO) $(PROGRAM) export-html -o Test/html.actual \
329 Test/en.expected.importslashdoc
330 $(DIFF) Test/html.expected Test/html.actual
332 check-mdoc-export-html-with-version: $(PROGRAM)
333 rm -Rf Test/html.actual.v0 Test/html.actual.since-with-v0 .v0.txt .v2.txt
334 $(MONO) $(PROGRAM) export-html -o Test/html.actual.v0 \
336 $(MONO) $(PROGRAM) export-html -o Test/html.actual.since-with-v0 \
337 Test/en.expected.since -with-version 0.0.0.0
338 (cd Test/html.actual.v0 && find . -type f) | sort > .v0.txt
339 (cd Test/html.actual.since-with-v0 && find . -type f) | sort > .v2.txt
340 $(DIFF) .v0.txt .v2.txt # assert no types added
342 check-md-html-dir: $(PROGRAM)
343 rm -Rf Test/html.actual
344 $(MONO) $(PROGRAM) export-html -dest:Test/html.actual $(DIR)
345 $(DIFF) Test/html.expected Test/html.actual
347 check-mdoc-export-msxdoc-update:
348 $(MONO) $(PROGRAM) export-msxdoc -o - Test/en.expected.importslashdoc \
349 > Test/msxdoc-expected.importslashdoc.xml
351 check-mdoc-export-msxdoc:
352 $(MONO) $(PROGRAM) export-msxdoc -o - Test/en.expected.importslashdoc \
353 | $(DIFF_QUIET) - Test/msxdoc-expected.importslashdoc.xml
355 my_abs_top_srcdir = $(shell cd . && pwd)
357 check-mdoc-validate-update: $(PROGRAM)
358 $(MONO) $(PROGRAM) validate -f ecma Test/en.expected 2>&1 | \
359 sed 's#file://$(my_abs_top_srcdir)/##g' > \
360 Test/validate.check.monodocer
361 $(MONO) $(PROGRAM) validate -f ecma Test/en.expected.importslashdoc 2>&1 | \
362 sed 's#file://$(my_abs_top_srcdir)/##g' > \
363 Test/validate.check.monodocer.importslashdoc
364 $(MONO) $(PROGRAM) validate -f ecma Test/en.expected.since 2>&1 | \
365 sed 's#file://$(my_abs_top_srcdir)/##g' > \
366 Test/validate.check.monodocer.since
368 check-mdoc-validate: $(PROGRAM)
369 $(MONO) $(PROGRAM) validate -f ecma Test/en.expected 2>&1 | \
370 sed 's#file://$(my_abs_top_srcdir)/##g' | \
371 $(DIFF_QUIET) - Test/validate.check.monodocer
372 $(MONO) $(PROGRAM) validate -f ecma Test/en.expected.importslashdoc 2>&1 | \
373 sed 's#file://$(my_abs_top_srcdir)/##g' | \
374 $(DIFF_QUIET) - Test/validate.check.monodocer.importslashdoc
375 $(MONO) $(PROGRAM) validate -f ecma Test/en.expected.since 2>&1 | \
376 sed 's#file://$(my_abs_top_srcdir)/##g' | \
377 $(DIFF_QUIET) - Test/validate.check.monodocer.since
379 run-test-local: check-doc-tools
381 run-test-update : check-doc-tools-update
383 check-doc-tools: check-monodocer-since \
384 check-monodocer-importecmadoc \
385 check-monodocer-importslashdoc \
387 check-monodocer-delete \
388 check-mdoc-export-html \
389 check-mdoc-export-html-with-version \
390 check-mdoc-export-msxdoc \
391 check-mdoc-validate \
392 check-monodocer-dropns-classic \
393 check-monodocer-dropns-classic-withsecondary \
394 check-monodocer-dropns-delete \
395 check-monodocer-internal-interface \
396 check-monodocer-enumerations \
397 check-monodocer-dropns-multi \
398 check-monodocer-dropns-multi-withexisting
400 check-doc-tools-update: check-monodocer-since-update \
401 check-monodocer-importecmadoc-update \
402 check-monodocer-importslashdoc-update \
403 check-monodocer-update \
404 check-monodocer-delete-update \
405 check-mdoc-export-html-update \
406 check-mdoc-export-msxdoc-update \
407 check-mdoc-validate-update
409 check: check-doc-tools