Commit f7aa2bc2f189ee523828e625fe2e1ad222051bc9
Committed by
Sergio Oliveira
1 parent
e027d93b
Exists in
master
and in
90 other branches
architecture: placeholder image
Showing
4 changed files
with
49 additions
and
29 deletions
Show diff stats
... | ... | @@ -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
... | ... | @@ -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) | ... | ... |