Skip to content

Commit 0548d3a

Browse files
committed
Move generated docs{,-prerelease}.json to $GENERATED
1 parent 7fcd7db commit 0548d3a

File tree

2 files changed

+23
-24
lines changed

2 files changed

+23
-24
lines changed

.gitignore

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,6 @@ css/cssmenu.css
3232
*.min.*
3333

3434
deleteme.*
35-
docs-prerelease.json
36-
docs.json
3735
.dub/
3836
dpl-docs/dpl-docs
3937
modlist-release.ddoc

posix.mak

Lines changed: 23 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,7 @@ PHOBOS_STABLE_DIR=${PHOBOS_DIR}-${LATEST}
4747
################################################################################
4848
# Automatically generated directories
4949
GENERATED=.generated
50+
G=$(GENERATED)
5051
PHOBOS_DIR_GENERATED=$(GENERATED)/phobos-prerelease
5152
PHOBOS_STABLE_DIR_GENERATED=$(GENERATED)/phobos-release
5253
# The assert_writeln_magic tool transforms all source files from Phobos. Hence
@@ -470,24 +471,24 @@ ${DOC_OUTPUT_DIR}/phobos-prerelease/index.verbatim : verbatim.ddoc \
470471

471472
apidocs-prerelease : ${DOC_OUTPUT_DIR}/library-prerelease/sitemap.xml ${DOC_OUTPUT_DIR}/library-prerelease/.htaccess
472473
apidocs-release : ${DOC_OUTPUT_DIR}/library/sitemap.xml ${DOC_OUTPUT_DIR}/library/.htaccess
473-
apidocs-serve : docs-prerelease.json
474+
apidocs-serve : $G/docs-prerelease.json
474475
${DPL_DOCS} serve-html --std-macros=html.ddoc --std-macros=dlang.org.ddoc --std-macros=std.ddoc --std-macros=macros.ddoc --std-macros=std-ddox.ddoc \
475476
--override-macros=std-ddox-override.ddoc --package-order=std \
476-
--git-target=master --web-file-dir=. docs-prerelease.json
477+
--git-target=master --web-file-dir=. $<
477478

478-
${DOC_OUTPUT_DIR}/library-prerelease/sitemap.xml : docs-prerelease.json
479+
${DOC_OUTPUT_DIR}/library-prerelease/sitemap.xml : $G/docs-prerelease.json
479480
@mkdir -p $(dir $@)
480481
${DPL_DOCS} generate-html --file-name-style=lowerUnderscored --std-macros=html.ddoc --std-macros=dlang.org.ddoc --std-macros=std.ddoc --std-macros=macros.ddoc --std-macros=std-ddox.ddoc \
481482
--override-macros=std-ddox-override.ddoc --package-order=std \
482483
--git-target=master $(DPL_DOCS_PATH_RUN_FLAGS) \
483-
docs-prerelease.json ${DOC_OUTPUT_DIR}/library-prerelease
484+
$< ${DOC_OUTPUT_DIR}/library-prerelease
484485

485-
${DOC_OUTPUT_DIR}/library/sitemap.xml : docs.json
486+
${DOC_OUTPUT_DIR}/library/sitemap.xml : $G/docs.json
486487
@mkdir -p $(dir $@)
487488
${DPL_DOCS} generate-html --file-name-style=lowerUnderscored --std-macros=html.ddoc --std-macros=dlang.org.ddoc --std-macros=std.ddoc --std-macros=macros.ddoc --std-macros=std-ddox.ddoc \
488489
--override-macros=std-ddox-override.ddoc --package-order=std \
489490
--git-target=v${LATEST} $(DPL_DOCS_PATH_RUN_FLAGS) \
490-
docs.json ${DOC_OUTPUT_DIR}/library
491+
$< ${DOC_OUTPUT_DIR}/library
491492

492493
${DOC_OUTPUT_DIR}/library/.htaccess : dpl_release_htaccess
493494
@mkdir -p $(dir $@)
@@ -504,40 +505,40 @@ else
504505
DMD_EXCLUDE += -e /scanmach/d -e /libmach/d
505506
endif
506507

507-
docs.json : ${DMD} ${DMD_REL} ${DMD_STABLE_DIR} ${DRUNTIME_STABLE_DIR} \
508+
$G/docs.json : ${DMD} ${DMD_REL} ${DMD_STABLE_DIR} ${DRUNTIME_STABLE_DIR} \
508509
${PHOBOS_STABLE_FILES_GENERATED} | dpl-docs
509510
find ${DMD_STABLE_DIR}/src -name '*.d' | \
510511
sed -e /mscoff/d -e /objc_glue.d/d -e /objc.d/d ${DMD_EXCLUDE} \
511-
> .release-files.txt
512+
> $G/.release-files.txt
512513
find ${DRUNTIME_STABLE_DIR}/src -name '*.d' | \
513-
sed -e /unittest.d/d -e /gcstub/d >> .release-files.txt
514+
sed -e /unittest.d/d -e /gcstub/d >> $G/.release-files.txt
514515
find ${PHOBOS_STABLE_DIR_GENERATED} -name '*.d' | \
515-
sed -e /unittest.d/d -e /windows/d | sort >> .release-files.txt
516+
sed -e /unittest.d/d -e /windows/d | sort >> $G/.release-files.txt
516517
${DMD_REL} -J$(DMD_STABLE_DIR)/res -J$(dir $(DMD_REL)) -c -o- -version=CoreDdoc \
517-
-version=MARS -version=CoreDdoc -version=StdDdoc -Df.release-dummy.html \
518-
-Xfdocs.json -I${PHOBOS_STABLE_DIR_GENERATED} @.release-files.txt
519-
${DPL_DOCS} filter docs.json --min-protection=Protected \
518+
-version=MARS -version=CoreDdoc -version=StdDdoc -Df$G/.release-dummy.html \
519+
-Xf$@ -I${PHOBOS_STABLE_DIR_GENERATED} @$G/.release-files.txt
520+
${DPL_DOCS} filter $@ --min-protection=Protected \
520521
--only-documented $(MOD_EXCLUDES_PRERELEASE)
521-
rm .release-files.txt .release-dummy.html
522+
rm $G/.release-files.txt $G/.release-dummy.html
522523

523524
# DDox tries to generate the docs for all `.d` files. However for dmd this is tricky,
524525
# because the `{mach, elf, mscoff}` are platform dependent.
525526
# Thus the need to exclude these files (and the `objc_glue.d` file).
526-
docs-prerelease.json : ${DMD} ${DMD_DIR} ${DRUNTIME_DIR} \
527+
$G/docs-prerelease.json : ${DMD} ${DMD_DIR} ${DRUNTIME_DIR} \
527528
${PHOBOS_FILES_GENERATED} | dpl-docs
528529
find ${DMD_DIR}/src -name '*.d' | \
529530
sed -e /mscoff/d -e /objc_glue.d/d ${DMD_EXCLUDE} \
530-
> .prerelease-files.txt
531+
> $G/.prerelease-files.txt
531532
find ${DRUNTIME_DIR}/src -name '*.d' | sed -e '/gcstub/d' \
532-
-e /unittest/d >> .prerelease-files.txt
533+
-e /unittest/d >> $G/.prerelease-files.txt
533534
find ${PHOBOS_DIR_GENERATED} -name '*.d' | sed -e /unittest.d/d \
534-
-e /windows/d | sort >> .prerelease-files.txt
535+
-e /windows/d | sort >> $G/.prerelease-files.txt
535536
${DMD} -J$(DMD_DIR)/res -J$(dir $(DMD)) -c -o- -version=MARS -version=CoreDdoc \
536-
-version=StdDdoc -Df.prerelease-dummy.html \
537-
-Xfdocs-prerelease.json -I${PHOBOS_DIR_GENERATED} @.prerelease-files.txt
538-
${DPL_DOCS} filter docs-prerelease.json --min-protection=Protected \
537+
-version=StdDdoc -Df$G/.prerelease-dummy.html \
538+
-Xf$@ -I${PHOBOS_DIR_GENERATED} @$G/.prerelease-files.txt
539+
${DPL_DOCS} filter $@ --min-protection=Protected \
539540
--only-documented $(MOD_EXCLUDES_RELEASE)
540-
rm .prerelease-files.txt .prerelease-dummy.html
541+
rm $G/.prerelease-files.txt $G/.prerelease-dummy.html
541542

542543
################################################################################
543544
# binary targets for DDOX

0 commit comments

Comments
 (0)