Skip to content
This repository was archived by the owner on Mar 19, 2021. It is now read-only.

Commit 0a6beaa

Browse files
committed
[docs] Correct errors in build process
Ensure that the contents of the top-level `certs/` directory are available to the Sphinx process at build time. Correct references to recently-relocated document from a new tutorial.
1 parent 1c052be commit 0a6beaa

File tree

3 files changed

+7
-5
lines changed

3 files changed

+7
-5
lines changed

docs/Makefile

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,12 @@ help:
1313

1414
.PHONY: help Makefile
1515

16-
tools/wptserve:
16+
tools/%:
1717
mkdir -p $(shell dirname $@)
18-
ln -s ../../tools/wptserve $@
18+
test -d ../$@
19+
ln -s ../../$@ $@
1920

2021
# Catch-all target: route all unknown targets to Sphinx using the new
2122
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
22-
%: Makefile tools/wptserve
23+
%: Makefile tools/wptserve tools/certs
2324
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/make.bat

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ if errorlevel 9009 (
2828
if not exist tools\ ( mkdir tools )
2929

3030
if not exist tools\wptserve\ ( mklink /d tools\wptserve ..\..\tools\wptserve )
31+
if not exist tools\certs\ ( mklink /d tools\certs ..\..\tools\certs )
3132

3233
%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
3334
goto end

docs/writing-tests/reftest-tutorial.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ You'll need to [configure your system to use WPT's
1919
tools](../running-tests/from-local-system), but you won't need them until
2020
towards the end of this tutorial. Although it includes some very brief
2121
instructions on using git, you can find more guidance in [the tutorial for git
22-
and GitHub](../appendix/github-intro).
22+
and GitHub](../writing-tests/github-intro).
2323

2424
WPT's reftests are great for testing web-platform features that have some
2525
visual effect. [The reftests reference page](reftests) describes them in the
@@ -264,7 +264,7 @@ And now we can push the commit to our fork of WPT:
264264
The last step is to submit the test for review. WPT doesn't actually need the
265265
test we wrote in this tutorial, but if we wanted to submit it for inclusion in
266266
the repository, we would create a pull request on GitHub. [The guide on git and
267-
GitHub](../appendix/github-intro) has all the details on how to do that.
267+
GitHub](../writing-tests/github-intro) has all the details on how to do that.
268268

269269
## More practice
270270

0 commit comments

Comments
 (0)