allpy: 88c246f20918 docs/Makefile

allpy

view docs/Makefile @ 645:88c246f20918

Fixed monomer pickling to avoid name clashes. This breaks pickle backwards-compatiblity! [see #35] Previosly all monomer classes were stored a single namespace, allpy.data.monomers. This caused a few name clashes, which were mostly resolved, and one name clash, that was not. (This caused one class to be named differently depending on the order in which modules were loaded). Now, instead of one allpy.data.monomers module we have allpy.data.monomers package with modules dna, rna, protein. This ensures that all name clashes are resolved uniformly upon any sequence of modules loading. This may also help in future to keep backward-compatibility longer in case we replace dynaminc monomer class creation with storing the classes in the module - if we want to retain independent loading of dna/rna/protein parts.

author	Daniil Alexeyevsky <dendik@kodomo.fbb.msu.ru>
date	Wed, 08 Jun 2011 21:31:02 +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."