summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2008-02-01 15:50:15 (GMT)
committerGeorg Brandl <georg@python.org>2008-02-01 15:50:15 (GMT)
commitcd235278ba5561e48140e1d677eef36ef504c500 (patch)
tree72d61651e467cfa03aae0dfd934e72f785852e6f /Doc
parent2a5d1c3493baaec824547bf1eaf27a456817712b (diff)
downloadcpython-cd235278ba5561e48140e1d677eef36ef504c500.zip
cpython-cd235278ba5561e48140e1d677eef36ef504c500.tar.gz
cpython-cd235278ba5561e48140e1d677eef36ef504c500.tar.bz2
Add link checker builder, written for GHOP by Thomas Lamb.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Makefile16
-rw-r--r--Doc/README.txt4
2 files changed, 15 insertions, 5 deletions
diff --git a/Doc/Makefile b/Doc/Makefile
index 04cca4e7..c3f3a2d 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -16,11 +16,12 @@ ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees -D latex_paper_size=$(PAPER) \
help:
@echo "Please use \`make <target>' where <target> is one of"
- @echo " html to make standalone HTML files"
- @echo " web to make file usable by Sphinx.web"
- @echo " htmlhelp to make HTML files and a HTML help project"
- @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
- @echo " changes to make an overview over all changed/added/deprecated items"
+ @echo " html to make standalone HTML files"
+ @echo " web to make file usable by Sphinx.web"
+ @echo " htmlhelp to make HTML files and a HTML help project"
+ @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+ @echo " changes to make an overview over all changed/added/deprecated items"
+ @echo " linkcheck to check all external links for integrity"
checkout:
@if [ ! -d tools/sphinx ]; then \
@@ -71,6 +72,11 @@ changes: BUILDER = changes
changes: build
@echo "The overview file is in build/changes."
+linkcheck: BUILDER = linkcheck
+linkcheck: build
+ @echo "Link check complete; look for any errors in the above or in" \
+ "build/$(BUILDER)/output.txt"
+
clean:
-rm -rf build/*
-rm -rf tools/sphinx
diff --git a/Doc/README.txt b/Doc/README.txt
index b6cadd3..c719cda 100644
--- a/Doc/README.txt
+++ b/Doc/README.txt
@@ -50,6 +50,10 @@ Available make targets are:
* "latex", which builds LaTeX source files that can be run with "pdflatex"
to produce PDF documents.
+
+ * "linkcheck", which checks all external references to see whether they are
+ broken, redirected or malformed, and outputs this information to stdout
+ as well as a plain-text (.txt) file.
* "changes", which builds an overview over all versionadded/versionchanged/
deprecated items in the current version. This is meant as a help for the