Skip to content

Move DDoc files to /ddoc #2012

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
72 changes: 40 additions & 32 deletions posix.mak
Original file line number Diff line number Diff line change
Expand Up @@ -232,7 +232,7 @@ DBLOG_LATEST=
# Disable all dynamic content that could potentially have an unrelated impact
# on a diff
ifeq (1,$(DIFFABLE))
NODATETIME := nodatetime.ddoc
NODATETIME := ddoc/nodatetime.ddoc
DPL_DOCS_PATH_RUN_FLAGS := --no-exact-source-links
else
CHANGELOG_VERSION_MASTER := "v${LATEST}..upstream/master"
Expand Down Expand Up @@ -274,7 +274,7 @@ DDOC_VARS_HTML=$(DDOC_VARS) \

DDOC_VARS_VERBATIM=$(DDOC_VARS) \
DOC_OUTPUT_DIR="$W/phobos-prerelease-verbatim" \
STDDOC="$(PWD)/verbatim.ddoc"
STDDOC="$(PWD)/ddoc/verbatim.ddoc"

################################################################################
# Resources
Expand Down Expand Up @@ -311,10 +311,13 @@ STYLES=$(addsuffix .css, $(addprefix css/, \
# HTML Files
################################################################################

DDOC=$(addsuffix .ddoc, macros html dlang.org doc ${GENERATED}/${LATEST}) $(NODATETIME) $(DBLOG_LATEST)
STD_DDOC_LATEST=$(addsuffix .ddoc, macros html dlang.org ${GENERATED}/${LATEST} std std_navbar-release ${GENERATED}/modlist-${LATEST}) $(NODATETIME)
STD_DDOC_RELEASE=$(addsuffix .ddoc, macros html dlang.org ${GENERATED}/${LATEST} std std_navbar-release ${GENERATED}/modlist-release) $(NODATETIME)
STD_DDOC_PRERELEASE=$(addsuffix .ddoc, macros html dlang.org ${GENERATED}/${LATEST} std std_navbar-prerelease ${GENERATED}/modlist-prerelease) $(NODATETIME)
DDOC=$(addprefix ddoc, $(addsuffix .ddoc, macros html dlang.org doc ${GENERATED}/${LATEST}) $(NODATETIME) $(DBLOG_LATEST)
STD_DDOC_LATEST=$(addprefix ddoc, $(addsuffix .ddoc, \
macros html dlang.org ${GENERATED}/${LATEST} std std_navbar-release ${GENERATED}/modlist-${LATEST}) $(NODATETIME))
STD_DDOC_RELEASE=$(addprefix ddoc, $(addsuffix .ddoc, \
macros html dlang.org ${GENERATED}/${LATEST} std std_navbar-release ${GENERATED}/modlist-release)) $(NODATETIME)
STD_DDOC_PRERELEASE=$(addprefix ddoc, $(addsuffix .ddoc, \
macros html dlang.org ${GENERATED}/${LATEST} std std_navbar-prerelease ${GENERATED}/modlist-prerelease)) $(NODATETIME))
SPEC_DDOC=${DDOC} spec/spec.ddoc
CHANGELOG_DDOC=${DDOC} changelog/changelog.ddoc $(NODATETIME)
CHANGELOG_PRE_DDOC=${CHANGELOG_DDOC} changelog/prerelease.ddoc
Expand Down Expand Up @@ -460,16 +463,16 @@ $W/spec/%.html : spec/%.dd $(SPEC_DDOC) $(DMD)
$(DMD) -c -o- -Df$@ $(SPEC_DDOC) $<

$W/404.html : 404.dd $(DDOC) $(DMD)
$(DMD) -conf= -c -o- -Df$@ $(DDOC) errorpage.ddoc $<
$(DMD) -conf= -c -o- -Df$@ $(DDOC) ddoc/errorpage.ddoc $<

$(DOC_OUTPUT_DIR)/contributors.html: contributors.dd $G/contributors.ddoc $(DDOC) $(DMD)
$(DMD) -conf= -c -o- -Df$@ $(DDOC) $(word 2, $^) $<

$W/%.html : %.dd $(DDOC) $(DMD)
$(DMD) -conf= -c -o- -Df$@ $(DDOC) $<

$W/%.verbatim : %_pre.dd verbatim.ddoc $(DMD)
$(DMD) -c -o- -Df$@ verbatim.ddoc $<
$W/%.verbatim : %_pre.dd ddoc/verbatim.ddoc $(DMD)
$(DMD) -c -o- -Df$@ ddoc/verbatim.ddoc $<

$W/%.verbatim : %.dd verbatim.ddoc $(DMD)
$(DMD) -c -o- -Df$@ verbatim.ddoc $<
Expand All @@ -492,11 +495,11 @@ $W/% : %
@mkdir -p $(dir $@)
cp $< $@

$W/dmd-%.html : %.ddoc dcompiler.dd $(DDOC) $(DMD)
$W/dmd-%.html : ddoc/%.ddoc dcompiler.dd $(DDOC) $(DMD)
$(DMD) -conf= -c -o- -Df$@ $(DDOC) dcompiler.dd $<

$W/dmd-%.verbatim : %.ddoc dcompiler.dd verbatim.ddoc $(DMD)
$(DMD) -c -o- -Df$@ verbatim.ddoc dcompiler.dd $<
$W/dmd-%.verbatim : ddoc/%.ddoc dcompiler.dd ddoc/verbatim.ddoc $(DMD)
$(DMD) -c -o- -Df$@ ddoc/verbatim.ddoc dcompiler.dd $<

$W:
mkdir -p $@
Expand All @@ -508,8 +511,8 @@ $W:
$G/dlangspec.d : $(SPEC_DD) ${STABLE_DMD}
$(STABLE_RDMD) ../tools/catdoc.d -o$@ $(SPEC_DD)

$G/dlangspec.html : $(DDOC) ebook.ddoc $G/dlangspec.d $(DMD)
$(DMD) -conf= -Df$@ $(DDOC) ebook.ddoc $G/dlangspec.d
$G/dlangspec.html : $(DDOC) ddoc/ebook.ddoc $G/dlangspec.d $(DMD)
$(DMD) -conf= -Df$@ $(DDOC) ddoc/ebook.ddoc $G/dlangspec.d

$G/dlangspec.zip : $G/dlangspec.html ebook.css
rm -f $@
Expand All @@ -531,8 +534,8 @@ $W/dlangspec.mobi : \
$G/dlangspec-consolidated.d : $(SPEC_DD) ${STABLE_DMD}
$(STABLE_RDMD) --force ../tools/catdoc.d -o$@ $(SPEC_DD)

$G/dlangspec.tex : $G/dlangspec-consolidated.d $(DMD) $(DDOC) latex.ddoc
$(DMD) -conf= -Df$@ $(DDOC) latex.ddoc $<
$G/dlangspec.tex : $G/dlangspec-consolidated.d $(DMD) $(DDOC) ddoc/latex.ddoc
$(DMD) -conf= -Df$@ $(DDOC) ddoc/latex.ddoc $<

# Run twice to fix multipage tables and \ref uses
$W/dlangspec.pdf : $G/dlangspec.tex | $W
Expand All @@ -550,11 +553,11 @@ $W/dlangspec.html: $G/dlangspec.html | $W
# Plaintext/verbatim generation - not part of the build, demo purposes only
################################################################################

$G/dlangspec.txt : $G/dlangspec-consolidated.d $(DMD) macros.ddoc plaintext.ddoc
$(DMD) -conf= -Df$@ macros.ddoc plaintext.ddoc $<
$G/dlangspec.txt : $G/dlangspec-consolidated.d $(DMD) ddoc/macros.ddoc ddoc/plaintext.ddoc
$(DMD) -conf= -Df$@ ddoc/macros.ddoc plaintext.ddoc $<

$G/dlangspec.verbatim.txt : $G/dlangspec-consolidated.d $(DMD) verbatim.ddoc
$(DMD) -conf= -Df$@ verbatim.ddoc $<
$G/dlangspec.verbatim.txt : $G/dlangspec-consolidated.d $(DMD) ddoc/verbatim.ddoc
$(DMD) -conf= -Df$@ ddoc/verbatim.ddoc $<

################################################################################
# Fetch the latest article from the official D blog
Expand Down Expand Up @@ -603,7 +606,7 @@ dmd-prerelease : $(STD_DDOC_PRERELEASE) $(DMD_DIR) $(DMD)

dmd-prerelease-verbatim : $(STD_DDOC_PRERELEASE) $(DMD_DIR) \
$W/phobos-prerelease/mars.verbatim
$W/phobos-prerelease/mars.verbatim: verbatim.ddoc
$W/phobos-prerelease/mars.verbatim: ddoc/verbatim.ddoc
mkdir -p $(dir $@)
$(MAKE) AUTO_BOOTSTRAP=1 --directory=$(DMD_DIR) -f posix.mak html $(DDOC_VARS_VERBATIM)
$(call CHANGE_SUFFIX,html,verbatim,$W/phobos-prerelease-verbatim)
Expand Down Expand Up @@ -635,7 +638,7 @@ druntime-prerelease-verbatim : ${DRUNTIME_DIR} \
$W/phobos-prerelease/object.verbatim : $(DMD)
${MAKE} --directory=${DRUNTIME_DIR} -f posix.mak target doc $(DDOC_VARS_VERBATIM) \
DOCDIR=$W/phobos-prerelease-verbatim \
DOCFMT="`pwd`/verbatim.ddoc"
DOCFMT="`pwd`/ddoc/verbatim.ddoc"
mkdir -p $(dir $@)
$(call CHANGE_SUFFIX,html,verbatim,$W/phobos-prerelease-verbatim)
mv $W/phobos-prerelease-verbatim/* $(dir $@)
Expand All @@ -658,7 +661,7 @@ phobos-latest : ${PHOBOS_LATEST_FILES_GENERATED} $(DMD_LATEST) $(STD_DDOC_LATEST
$(MAKE) --directory=$(PHOBOS_LATEST_DIR_GENERATED) -f posix.mak html $(DDOC_VARS_LATEST_HTML)

phobos-prerelease-verbatim : ${PHOBOS_FILES_GENERATED} $W/phobos-prerelease/index.verbatim
$W/phobos-prerelease/index.verbatim : verbatim.ddoc \
$W/phobos-prerelease/index.verbatim : ddoc/verbatim.ddoc \
$W/phobos-prerelease/object.verbatim \
$W/phobos-prerelease/mars.verbatim
${MAKE} --directory=${PHOBOS_DIR_GENERATED} -f posix.mak html $(DDOC_VARS_VERBATIM) \
Expand All @@ -674,21 +677,26 @@ $W/phobos-prerelease/index.verbatim : verbatim.ddoc \
apidocs-prerelease : $W/library-prerelease/sitemap.xml $W/library-prerelease/.htaccess
apidocs-latest : $W/library/sitemap.xml $W/library/.htaccess
apidocs-serve : $G/docs-prerelease.json
${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 \
--override-macros=std-ddox-override.ddoc --package-order=std \
${DPL_DOCS} serve-html --std-macros=ddoc/html.ddoc --std-macros=ddoc/dlang.org.ddoc \
--std-macros=ddoc/std.ddoc --std-macros=ddoc/macros.ddoc --std-macros=ddoc/std-ddox.ddoc \
--override-macros=ddoc/std-ddox-override.ddoc --package-order=std
--git-target=master --web-file-dir=. $<

$W/library-prerelease/sitemap.xml : $G/docs-prerelease.json
@mkdir -p $(dir $@)
${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 \
--override-macros=std-ddox-override.ddoc --package-order=std \
${DPL_DOCS} generate-html --file-name-style=lowerUnderscored --std-macros=ddoc/html.ddoc \
--std-macros=ddoc/dlang.org.ddoc --std-macros=ddoc/std.ddoc \
--std-macros=ddoc/macros.ddoc --std-macros=ddoc/std-ddox.ddoc \
--override-macros=ddoc/std-ddox-override.ddoc --package-order=std \
--git-target=master $(DPL_DOCS_PATH_RUN_FLAGS) \
$< $W/library-prerelease

$W/library/sitemap.xml : $G/docs-latest.json
@mkdir -p $(dir $@)
${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 \
--override-macros=std-ddox-override.ddoc --package-order=std \
${DPL_DOCS} generate-html --file-name-style=lowerUnderscored --std-macros=ddoc/html.ddoc \
--std-macros=ddoc/dlang.org.ddoc --std-macros=ddoc/std.ddoc \
--std-macros=ddoc/macros.ddoc --std-macros=ddoc/std-ddox.ddoc \
--override-macros=ddoc/std-ddox-override.ddoc --package-order=std \
--git-target=v${LATEST} $(DPL_DOCS_PATH_RUN_FLAGS) \
$< $W/library

Expand Down Expand Up @@ -776,13 +784,13 @@ ${STABLE_DMD} ${STABLE_RDMD} ${DUB}: ${STABLE_DMD_ROOT}/.downloaded
################################################################################

# testing menu generation
chm-nav-latest.json : $(DDOC) std.ddoc spec/spec.ddoc ${GENERATED}/modlist-${LATEST}.ddoc changelog/changelog.ddoc chm-nav.dd $(DMD)
chm-nav-latest.json : $(DDOC) ddoc/std.ddoc spec/spec.ddoc ${GENERATED}/modlist-${LATEST}.ddoc changelog/changelog.ddoc chm-nav.dd $(DMD)
$(DMD) -conf= -c -o- -Df$@ $(filter-out $(DMD),$^)

chm-nav-release.json : $(DDOC) std.ddoc spec/spec.ddoc ${GENERATED}/modlist-release.ddoc changelog/changelog.ddoc chm-nav.dd $(DMD)
chm-nav-release.json : $(DDOC) ddoc/std.ddoc spec/spec.ddoc ${GENERATED}/modlist-release.ddoc changelog/changelog.ddoc chm-nav.dd $(DMD)
$(DMD) -conf= -c -o- -Df$@ $(filter-out $(DMD),$^)

chm-nav-prerelease.json : $(DDOC) std.ddoc spec/spec.ddoc ${GENERATED}/modlist-prerelease.ddoc changelog/changelog.ddoc chm-nav.dd $(DMD)
chm-nav-prerelease.json : $(DDOC) ddoc/std.ddoc spec/spec.ddoc ${GENERATED}/modlist-prerelease.ddoc changelog/changelog.ddoc chm-nav.dd $(DMD)
$(DMD) -conf= -c -o- -Df$@ $(filter-out $(DMD),$^)

################################################################################
Expand Down