allpy: a1307c0bb030 docs/Makefile

allpy

view docs/Makefile @ 642:a1307c0bb030

Added necessary hooks for monomer pickling [closes #35] Current implementation is lazy and does not store all monomer classes explicitly in some module. They are still generated on the fly. Some monomer classes have the same name as per PDB database. In order to avoid name clashes, we add underscores to classes, if same name class already exists. WARNING. This may and WILL cause trouble, if such clashes occur between different types of monomers, in which case different names will be generated for the same class depending on the order of loading modules. The only example of such clash in the current database is dna monomer "0AV" and rna "A2M", which both have name "2'-O-METHYLADENOSINE 5'-(DIHYDROGEN PHOSPHATE)"

author	Daniil Alexeyevsky <dendik@kodomo.fbb.msu.ru>
date	Fri, 03 Jun 2011 16:49:44 +0400
parents
children

line source

1 # Makefile for Sphinx documentation

2 #

4 # You can set these variables from the command line.

5 SPHINXOPTS =

6 SPHINXBUILD = sphinx-build

7 PAPER =

8 BUILDDIR = build

10 # Internal variables.

11 PAPEROPT_a4 = -D latex_paper_size=a4

12 PAPEROPT_letter = -D latex_paper_size=letter

13 ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source

15 .PHONY: help clean html dirhtml pickle json htmlhelp qthelp latex changes linkcheck doctest

17 help:

18 @echo "Please use \`make <target>' where <target> is one of"

19 @echo " html to make standalone HTML files"

20 @echo " dirhtml to make HTML files named index.html in directories"

21 @echo " pickle to make pickle files"

22 @echo " json to make JSON files"

23 @echo " htmlhelp to make HTML files and a HTML help project"

24 @echo " qthelp to make HTML files and a qthelp project"

25 @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"

26 @echo " changes to make an overview of all changed/added/deprecated items"

27 @echo " linkcheck to check all external links for integrity"

28 @echo " doctest to run all doctests embedded in the documentation (if enabled)"

30 clean:

31 -rm -rf $(BUILDDIR)/*

33 html:

34 $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html

35 @echo

36 @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."

38 dirhtml:

39 $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml

40 @echo

41 @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."

43 pickle:

44 $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle

45 @echo

46 @echo "Build finished; now you can process the pickle files."

48 json:

49 $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json

50 @echo

51 @echo "Build finished; now you can process the JSON files."

53 htmlhelp:

54 $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp

55 @echo

56 @echo "Build finished; now you can run HTML Help Workshop with the" \

57 ".hhp project file in $(BUILDDIR)/htmlhelp."

59 qthelp:

60 $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp

61 @echo

62 @echo "Build finished; now you can run "qcollectiongenerator" with the" \

63 ".qhcp project file in $(BUILDDIR)/qthelp, like this:"

64 @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/allpy.qhcp"

65 @echo "To view the help file:"

66 @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/allpy.qhc"

68 latex:

69 $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex

70 @echo

71 @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."

72 @echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \

73 "run these through (pdf)latex."

75 changes:

76 $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes

77 @echo

78 @echo "The overview file is in $(BUILDDIR)/changes."

80 linkcheck:

81 $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck

82 @echo

83 @echo "Link check complete; look for any errors in the above output " \

84 "or in $(BUILDDIR)/linkcheck/output.txt."

86 doctest:

87 $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest

88 @echo "Testing of doctests in the sources finished, look at the " \

89 "results in $(BUILDDIR)/doctest/output.txt."