Commit f7aa2bc2f189ee523828e625fe2e1ad222051bc9

Authored by Antonio Terceiro
Committed by Sergio Oliveira
1 parent e027d93b

architecture: placeholder image

docs/.gitignore 0 → 100644
... ... @@ -0,0 +1 @@
  1 +architecture.png
... ...
docs/Makefile
... ... @@ -46,136 +46,135 @@ help:
46 46 @echo " linkcheck to check all external links for integrity"
47 47 @echo " doctest to run all doctests embedded in the documentation (if enabled)"
48 48  
  49 +include local.mk
  50 +
49 51 clean:
50 52 rm -rf $(BUILDDIR)/*
51   - rm -f dns.rst
52   -
53   -dns.rst: ../test/dns_test.sh
54   - (cd .. && sh test/dns_test.sh --doc) > $@
  53 + rm -rf $(CLEAN_FILES)
55 54  
56   -html: dns.rst
  55 +html: $(BUILT)
57 56 $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
58 57 @echo
59 58 @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
60 59  
61   -dirhtml: dns.rst
  60 +dirhtml: $(BUILT)
62 61 $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
63 62 @echo
64 63 @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
65 64  
66   -singlehtml: dns.rst
  65 +singlehtml: $(BUILT)
67 66 $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
68 67 @echo
69 68 @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
70 69  
71   -pickle: dns.rst
  70 +pickle: $(BUILT)
72 71 $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
73 72 @echo
74 73 @echo "Build finished; now you can process the pickle files."
75 74  
76   -json: dns.rst
  75 +json: $(BUILT)
77 76 $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
78 77 @echo
79 78 @echo "Build finished; now you can process the JSON files."
80 79  
81   -htmlhelp: dns.rst
  80 +htmlhelp: $(BUILT)
82 81 $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
83 82 @echo
84 83 @echo "Build finished; now you can run HTML Help Workshop with the" \
85 84 ".hhp project file in $(BUILDDIR)/htmlhelp."
86 85  
87   -qthelp: dns.rst
  86 +qthelp: $(BUILT)
88 87 $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
89 88 @echo
90 89 @echo "Build finished; now you can run "qcollectiongenerator" with the" \
91   - ".qhcp project file in $(BUILDDIR)/qthelp, like this: dns.rst"
  90 + ".qhcp project file in $(BUILDDIR)/qthelp, like this: $(BUILT)"
92 91 @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/softwarepublico.qhcp"
93   - @echo "To view the help file: dns.rst"
  92 + @echo "To view the help file: $(BUILT)"
94 93 @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/softwarepublico.qhc"
95 94  
96   -devhelp: dns.rst
  95 +devhelp: $(BUILT)
97 96 $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
98 97 @echo
99 98 @echo "Build finished."
100   - @echo "To view the help file: dns.rst"
  99 + @echo "To view the help file: $(BUILT)"
101 100 @echo "# mkdir -p $$HOME/.local/share/devhelp/softwarepublico"
102 101 @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/softwarepublico"
103 102 @echo "# devhelp"
104 103  
105   -epub: dns.rst
  104 +epub: $(BUILT)
106 105 $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
107 106 @echo
108 107 @echo "Build finished. The epub file is in $(BUILDDIR)/epub."
109 108  
110   -latex: dns.rst
  109 +latex: $(BUILT)
111 110 $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
112 111 @echo
113 112 @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
114 113 @echo "Run \`make' in that directory to run these through (pdf)latex" \
115 114 "(use \`make latexpdf' here to do that automatically)."
116 115  
117   -latexpdf: dns.rst
  116 +latexpdf: $(BUILT)
118 117 $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
119 118 @echo "Running LaTeX files through pdflatex..."
120 119 $(MAKE) -C $(BUILDDIR)/latex all-pdf
121 120 @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
122 121  
123   -latexpdfja: dns.rst
  122 +latexpdfja: $(BUILT)
124 123 $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
125 124 @echo "Running LaTeX files through platex and dvipdfmx..."
126 125 $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
127 126 @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
128 127  
129   -text: dns.rst
  128 +text: $(BUILT)
130 129 $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
131 130 @echo
132 131 @echo "Build finished. The text files are in $(BUILDDIR)/text."
133 132  
134   -man: dns.rst
  133 +man: $(BUILT)
135 134 $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
136 135 @echo
137 136 @echo "Build finished. The manual pages are in $(BUILDDIR)/man."
138 137  
139   -texinfo: dns.rst
  138 +texinfo: $(BUILT)
140 139 $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
141 140 @echo
142 141 @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
143 142 @echo "Run \`make' in that directory to run these through makeinfo" \
144 143 "(use \`make info' here to do that automatically)."
145 144  
146   -info: dns.rst
  145 +info: $(BUILT)
147 146 $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
148 147 @echo "Running Texinfo files through makeinfo..."
149 148 make -C $(BUILDDIR)/texinfo info
150 149 @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
151 150  
152   -gettext: dns.rst
  151 +gettext: $(BUILT)
153 152 $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
154 153 @echo
155 154 @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
156 155  
157   -changes: dns.rst
  156 +changes: $(BUILT)
158 157 $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
159 158 @echo
160 159 @echo "The overview file is in $(BUILDDIR)/changes."
161 160  
162   -linkcheck: dns.rst
  161 +linkcheck: $(BUILT)
163 162 $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
164 163 @echo
165 164 @echo "Link check complete; look for any errors in the above output " \
166 165 "or in $(BUILDDIR)/linkcheck/output.txt."
167 166  
168   -doctest: dns.rst
  167 +doctest: $(BUILT)
169 168 $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
170 169 @echo "Testing of doctests in the sources finished, look at the " \
171 170 "results in $(BUILDDIR)/doctest/output.txt."
172 171  
173   -xml: dns.rst
  172 +xml: $(BUILT)
174 173 $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
175 174 @echo
176 175 @echo "Build finished. The XML files are in $(BUILDDIR)/xml."
177 176  
178   -pseudoxml: dns.rst
  177 +pseudoxml: $(BUILT)
179 178 $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
180 179 @echo
181 180 @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
... ...
docs/arquitetura.rst
1 1 Arquitetura
2 2 ===========
  3 +
  4 +A figura a seguir representa a arquitetura do SPB.
  5 +
  6 +.. TODO incluir uma figura feita manualmente, a gente deve ter isso de
  7 +.. apresentações anterires
  8 +.. image:: architecture.png
... ...
docs/local.mk 0 → 100644
... ... @@ -0,0 +1,14 @@
  1 +# autogenerated DNS documentation
  2 +
  3 +BUILT += dns.rst
  4 +
  5 +dns.rst: ../test/dns_test.sh
  6 + (cd .. && sh test/dns_test.sh --doc) > $@
  7 +
  8 +BUILT += architecture.png
  9 +
  10 +architecture.png: architecture.dot
  11 + dot -Tpng -o $@ $<
  12 +
  13 +
  14 +CLEAN_FILES += $(BUILT)
... ...