← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to doc/Makefile

  • Committer: William Grant
  • Date: 2009-02-23 23:47:02 UTC
  • mfrom: (1099.1.211 new-dispatch)
  • Revision ID: grantw@unimelb.edu.au-20090223234702-db4b1llly46ignwo
Merge from lp:~ivle-dev/ivle/new-dispatch.

Pretty much everything changes. Reread the setup docs. Backup your databases.
Every file is now in a different installed location, the configuration system
is rewritten, the dispatch system is rewritten, URLs are different, the
database is different, worksheets and exercises are no longer on the
filesystem, we use a templating engine, jail service protocols are rewritten,
we don't repeat ourselves, we have authorization rewritten, phpBB is gone,
and probably lots of other things that I cannot remember.

This is certainly the biggest commit I have ever made, and hopefully
the largest I ever will.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/Makefile
1
 
# Makefile for Sphinx documentation
2
 
#
3
 
 
4
 
# You can set these variables from the command line.
5
 
SPHINXOPTS    =
6
 
SPHINXBUILD   = sphinx-build
7
 
PAPER         =
8
 
 
9
 
# Internal variables.
10
 
PAPEROPT_a4     = -D latex_paper_size=a4
11
 
PAPEROPT_letter = -D latex_paper_size=letter
12
 
ALLSPHINXOPTS   = -d build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
13
 
 
14
 
.PHONY: help clean html web pickle htmlhelp latex changes linkcheck
15
 
 
16
 
help:
17
 
        @echo "Please use \`make <target>' where <target> is one of"
18
 
        @echo "  html      to make standalone HTML files"
19
 
        @echo "  pickle    to make pickle files (usable by e.g. sphinx-web)"
20
 
        @echo "  htmlhelp  to make HTML files and a HTML help project"
21
 
        @echo "  latex     to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
22
 
        @echo "  changes   to make an overview over all changed/added/deprecated items"
23
 
        @echo "  linkcheck to check all external links for integrity"
24
 
 
25
 
clean:
26
 
        -rm -rf build/*
27
 
 
28
 
html:
29
 
        mkdir -p build/html build/doctrees
30
 
        $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) build/html
31
 
        @echo
32
 
        @echo "Build finished. The HTML pages are in build/html."
33
 
 
34
 
pickle:
35
 
        mkdir -p build/pickle build/doctrees
36
 
        $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) build/pickle
37
 
        @echo
38
 
        @echo "Build finished; now you can process the pickle files or run"
39
 
        @echo "  sphinx-web build/pickle"
40
 
        @echo "to start the sphinx-web server."
41
 
 
42
 
web: pickle
43
 
 
44
 
htmlhelp:
45
 
        mkdir -p build/htmlhelp build/doctrees
46
 
        $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) build/htmlhelp
47
 
        @echo
48
 
        @echo "Build finished; now you can run HTML Help Workshop with the" \
49
 
              ".hhp project file in build/htmlhelp."
50
 
 
51
 
latex:
52
 
        mkdir -p build/latex build/doctrees
53
 
        $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) build/latex
54
 
        @echo
55
 
        @echo "Build finished; the LaTeX files are in build/latex."
56
 
        @echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
57
 
              "run these through (pdf)latex."
58
 
 
59
 
changes:
60
 
        mkdir -p build/changes build/doctrees
61
 
        $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) build/changes
62
 
        @echo
63
 
        @echo "The overview file is in build/changes."
64
 
 
65
 
linkcheck:
66
 
        mkdir -p build/linkcheck build/doctrees
67
 
        $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) build/linkcheck
68
 
        @echo
69
 
        @echo "Link check complete; look for any errors in the above output " \
70
 
              "or in build/linkcheck/output.txt."