Style cleanup
[m6w6/libmemcached] / docs / include.am
1 # vim:ft=automake
2 # included from Top Level Makefile.am
3 # All paths should be given relative to the root
4
5 # Makefile for Sphinx documentation
6 #
7
8 SPHINXOPTS = ${SPHINX_WARNINGS}
9 PAPER =
10 SPHINX_BUILDDIR = ${top_builddir}/docs
11
12 # Internal variables.
13 PAPEROPT_a4 = -D latex_paper_size=a4
14 PAPEROPT_letter = -D latex_paper_size=letter
15 ALLSPHINXOPTS = -d $(SPHINX_BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) ${top_srcdir}/docs
16
17 .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest
18
19 man_MANS+= \
20 docs/man/hashkit_clone.3 \
21 docs/man/hashkit_crc32.3 \
22 docs/man/hashkit_create.3 \
23 docs/man/hashkit_fnv1_32.3 \
24 docs/man/hashkit_fnv1_64.3 \
25 docs/man/hashkit_fnv1a_32.3 \
26 docs/man/hashkit_fnv1a_64.3 \
27 docs/man/hashkit_free.3 \
28 docs/man/hashkit_functions.3 \
29 docs/man/hashkit_hsieh.3 \
30 docs/man/hashkit_is_allocated.3 \
31 docs/man/hashkit_jenkins.3 \
32 docs/man/hashkit_md5.3 \
33 docs/man/hashkit_murmur.3 \
34 docs/man/hashkit_value.3 \
35 docs/man/libhashkit.3 \
36 docs/man/libmemcached.3 \
37 docs/man/libmemcached_examples.3 \
38 docs/man/libmemcachedutil.3 \
39 docs/man/memaslap.1 \
40 docs/man/memcached_add.3 \
41 docs/man/memcached_add_by_key.3 \
42 docs/man/memcached_analyze.3 \
43 docs/man/memcached_append.3 \
44 docs/man/memcached_append_by_key.3 \
45 docs/man/memcached_behavior_get.3 \
46 docs/man/memcached_behavior_set.3 \
47 docs/man/memcached_callback_get.3 \
48 docs/man/memcached_callback_set.3 \
49 docs/man/memcached_cas.3 \
50 docs/man/memcached_cas_by_key.3 \
51 docs/man/memcached_clone.3 \
52 docs/man/memcached_create.3 \
53 docs/man/memcached_decrement.3 \
54 docs/man/memcached_decrement_with_initial.3 \
55 docs/man/memcached_delete.3 \
56 docs/man/memcached_delete_by_key.3 \
57 docs/man/memcached_destroy_sasl_auth_data.3 \
58 docs/man/memcached_dump.3 \
59 docs/man/memcached_fetch.3 \
60 docs/man/memcached_fetch_execute.3 \
61 docs/man/memcached_fetch_result.3 \
62 docs/man/memcached_flush_buffers.3 \
63 docs/man/memcached_free.3 \
64 docs/man/memcached_generate_hash.3 \
65 docs/man/libmemcached_check_configuration.3 \
66 docs/man/libmemcached_configuration.3 \
67 docs/man/memcached.3 \
68 docs/man/memcached_generate_hash_value.3 \
69 docs/man/memcached_get.3 \
70 docs/man/memcached_get_by_key.3 \
71 docs/man/memcached_get_memory_allocators.3 \
72 docs/man/memcached_get_sasl_callbacks.3 \
73 docs/man/memcached_get_user_data.3 \
74 docs/man/memcached_increment.3 \
75 docs/man/memcached_increment_with_initial.3 \
76 docs/man/memcached_lib_version.3 \
77 docs/man/memcached_mget.3 \
78 docs/man/memcached_mget_by_key.3 \
79 docs/man/memcached_mget_execute.3 \
80 docs/man/memcached_mget_execute_by_key.3 \
81 docs/man/memcached_pool_behavior_get.3 \
82 docs/man/memcached_pool_behavior_set.3 \
83 docs/man/memcached_pool_create.3 \
84 docs/man/memcached_pool_destroy.3 \
85 docs/man/memcached_pool_pop.3 \
86 docs/man/memcached_pool_push.3 \
87 docs/man/memcached_pool_st.3 \
88 docs/man/memcached_prepend.3 \
89 docs/man/memcached_prepend_by_key.3 \
90 docs/man/memcached_quit.3 \
91 docs/man/memcached_replace.3 \
92 docs/man/memcached_replace_by_key.3 \
93 docs/man/memcached_sasl_set_auth_data.3 \
94 docs/man/memcached_server_add.3 \
95 docs/man/memcached_server_count.3 \
96 docs/man/memcached_server_cursor.3 \
97 docs/man/memcached_server_list.3 \
98 docs/man/memcached_server_list_append.3 \
99 docs/man/memcached_server_list_count.3 \
100 docs/man/memcached_server_list_free.3 \
101 docs/man/memcached_server_push.3 \
102 docs/man/memcached_servers_parse.3 \
103 docs/man/memcached_set.3 \
104 docs/man/memcached_set_by_key.3 \
105 docs/man/memcached_set_memory_allocators.3 \
106 docs/man/memcached_set_sasl_callbacks.3 \
107 docs/man/memcached_set_user_data.3 \
108 docs/man/memcached_stat.3 \
109 docs/man/memcached_stat_execute.3 \
110 docs/man/memcached_stat_get_keys.3 \
111 docs/man/memcached_stat_get_value.3 \
112 docs/man/memcached_stat_servername.3 \
113 docs/man/memcached_strerror.3 \
114 docs/man/memcached_verbosity.3 \
115 docs/man/memcached_version.3 \
116 docs/man/memcapable.1 \
117 docs/man/memcat.1 \
118 docs/man/memcp.1 \
119 docs/man/memdump.1 \
120 docs/man/memerror.1 \
121 docs/man/memflush.1 \
122 docs/man/memrm.1 \
123 docs/man/memslap.1 \
124 docs/man/memstat.1
125
126
127 if HAVE_SPHINX
128 sphinx-help:
129 @echo "Please use \`make <target>' where <target> is one of"
130 @echo " html to make standalone HTML files"
131 @echo " dirhtml to make HTML files named index.html in directories"
132 @echo " singlehtml to make a single large HTML file"
133 @echo " pickle to make pickle files"
134 @echo " json to make JSON files"
135 @echo " htmlhelp to make HTML files and a HTML help project"
136 @echo " qthelp to make HTML files and a qthelp project"
137 @echo " devhelp to make HTML files and a Devhelp project"
138 @echo " epub to make an epub"
139 @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
140 @echo " latexpdf to make LaTeX files and run them through pdflatex"
141 @echo " text to make text files"
142 @echo " man to make manual pages"
143 @echo " changes to make an overview of all changed/added/deprecated items"
144 @echo " linkcheck to check all external links for integrity"
145 @echo " doctest to run all doctests embedded in the documentation (if enabled)"
146
147 html-local: docs/conf.py changes
148 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/html
149 @echo
150 @echo "Build finished. The HTML pages are in $(SPHINX_BUILDDIR)/html."
151
152 dirhtml: docs/conf.py changes
153 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/dirhtml
154 @echo
155 @echo "Build finished. The HTML pages are in $(SPHINX_BUILDDIR)/dirhtml."
156
157 singlehtml: docs/conf.py changes
158 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/singlehtml
159 @echo
160 @echo "Build finished. The HTML page is in $(SPHINX_BUILDDIR)/singlehtml."
161
162 pickle: docs/conf.py changes
163 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/pickle
164 @echo
165 @echo "Build finished; now you can process the pickle files."
166
167 json: docs/conf.py changes
168 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/json
169 @echo
170 @echo "Build finished; now you can process the JSON files."
171
172 htmlhelp: docs/conf.py changes
173 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/htmlhelp
174 @echo
175 @echo "Build finished; now you can run HTML Help Workshop with the" \
176 ".hhp project file in $(SPHINX_BUILDDIR)/htmlhelp."
177
178 qthelp: docs/conf.py changes
179 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/qthelp
180 @echo
181 @echo "Build finished; now you can run "qcollectiongenerator" with the" \
182 ".qhcp project file in $(SPHINX_BUILDDIR)/qthelp, like this:"
183 @echo "# qcollectiongenerator $(SPHINX_BUILDDIR)/qthelp/Libmemcached.qhcp"
184 @echo "To view the help file:"
185 @echo "# assistant -collectionFile $(SPHINX_BUILDDIR)/qthelp/Libmemcached.qhc"
186
187 devhelp: docs/conf.py changes
188 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/devhelp
189 @echo
190 @echo "Build finished."
191 @echo "To view the help file:"
192 @echo "# mkdir -p $$HOME/.local/share/devhelp/Libmemcached"
193 @echo "# ln -s $(SPHINX_BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Libmemcached"
194 @echo "# devhelp"
195
196 epub: docs/conf.py changes
197 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/epub
198 @echo
199 @echo "Build finished. The epub file is in $(SPHINX_BUILDDIR)/epub."
200
201 latex: docs/conf.py changes
202 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/latex
203 @echo
204 @echo "Build finished; the LaTeX files are in $(SPHINX_BUILDDIR)/latex."
205 @echo "Run \`make' in that directory to run these through (pdf)latex" \
206 "(use \`make latexpdf' here to do that automatically)."
207
208 latexpdf: latex changes
209 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/latex
210 @echo "Running LaTeX files through pdflatex..."
211 make -C $(SPHINX_BUILDDIR)/latex all-pdf
212 @echo "pdflatex finished; the PDF files are in $(SPHINX_BUILDDIR)/latex."
213
214 text: docs/conf.py changes
215 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/text
216 @echo
217 @echo "Build finished. The text files are in $(SPHINX_BUILDDIR)/text."
218
219 man: docs/conf.py changes
220 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/man
221 @echo
222 @echo "Build finished. The manual pages are in $(SPHINX_BUILDDIR)/man."
223
224 changes: docs/conf.py linkcheck
225 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/changes
226 @echo
227 @echo "The overview file is in $(SPHINX_BUILDDIR)/changes."
228
229 linkcheck: docs/conf.py
230 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/linkcheck
231 @echo
232 @echo "Link check complete; look for any errors in the above output " \
233 "or in $(SPHINX_BUILDDIR)/linkcheck/output.txt."
234
235 doctest:
236 PYTHONPATH=${top_srcdir}/docs $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(SPHINX_BUILDDIR)/doctest
237 @echo "Testing of doctests in the sources finished, look at the " \
238 "results in $(SPHINX_BUILDDIR)/doctest/output.txt."
239
240 endif