Statistics
| Branch: | Tag: | Revision:

root / Makefile.am @ cea881e5

History | View | Annotate | Download (14.3 kB)

1
# Ganeti makefile
2
# - Indent with tabs only.
3
# - Keep files sorted; one line per file.
4
# - Directories in lib/ must have their own *dir variable (see hypervisor).
5
# - All directories must be listed DIRS.
6
# - Use autogen.sh to generate Makefile.in and configure script.
7

    
8
# Automake doesn't export these variables before version 1.10.
9
abs_top_builddir = @abs_top_builddir@
10
abs_top_srcdir = @abs_top_srcdir@
11

    
12
ACLOCAL_AMFLAGS = -I autotools
13
DOCBOOK_WRAPPER = $(top_srcdir)/autotools/docbook-wrapper
14
BUILD_BASH_COMPLETION = $(top_srcdir)/autotools/build-bash-completion
15
RUN_IN_TEMPDIR = $(top_srcdir)/autotools/run-in-tempdir
16
CHECK_PYTHON_CODE = $(top_srcdir)/autotools/check-python-code
17
CHECK_MAN = $(top_srcdir)/autotools/check-man
18
REPLACE_VARS_SED = autotools/replace_vars.sed
19

    
20
hypervisordir = $(pkgpythondir)/hypervisor
21
httpdir = $(pkgpythondir)/http
22
confddir = $(pkgpythondir)/confd
23
rapidir = $(pkgpythondir)/rapi
24
toolsdir = $(pkglibdir)/tools
25
docdir = $(datadir)/doc/$(PACKAGE)
26

    
27
# Delete output file if an error occurred while building it
28
.DELETE_ON_ERROR:
29

    
30
DIRS = \
31
	autotools \
32
	daemons \
33
	devel \
34
	doc \
35
	doc/examples \
36
	doc/examples/hooks \
37
	lib \
38
	lib/build \
39
	lib/confd \
40
	lib/http \
41
	lib/hypervisor \
42
	lib/rapi \
43
	man \
44
	qa \
45
	scripts \
46
	test \
47
	test/data \
48
	tools
49

    
50
MAINTAINERCLEANFILES = \
51
	$(docpng) \
52
	$(maninput) \
53
	doc/install-quick.rst \
54
	doc/news.rst
55

    
56
maintainer-clean-local:
57
	rm -rf doc/api doc/html doc/coverage
58

    
59
CLEANFILES = \
60
	$(addsuffix /*.py[co],$(DIRS)) \
61
	autotools/replace_vars.sed \
62
	daemons/daemon-util \
63
	daemons/ganeti-cleaner \
64
	devel/upload \
65
	doc/examples/bash_completion \
66
	doc/examples/ganeti.initd \
67
	doc/examples/ganeti.cron \
68
	doc/examples/gnt-config-backup \
69
	doc/examples/hooks/ipsec \
70
	$(man_MANS) \
71
	$(manhtml) \
72
	stamp-directories \
73
	stamp-srclinks \
74
	$(nodist_pkgpython_PYTHON)
75

    
76
BUILT_SOURCES = \
77
	ganeti \
78
	stamp-srclinks \
79
	stamp-directories \
80
	lib/_autoconf.py
81

    
82
nodist_pkgpython_PYTHON = \
83
	lib/_autoconf.py
84

    
85
noinst_PYTHON = \
86
	lib/build/__init__.py
87

    
88
pkgpython_PYTHON = \
89
	lib/__init__.py \
90
	lib/asyncnotifier.py \
91
	lib/backend.py \
92
	lib/bdev.py \
93
	lib/bootstrap.py \
94
	lib/cli.py \
95
	lib/cmdlib.py \
96
	lib/compat.py \
97
	lib/config.py \
98
	lib/constants.py \
99
	lib/daemon.py \
100
	lib/errors.py \
101
	lib/jqueue.py \
102
	lib/jstore.py \
103
	lib/locking.py \
104
	lib/luxi.py \
105
	lib/mcpu.py \
106
	lib/objects.py \
107
	lib/opcodes.py \
108
	lib/rpc.py \
109
	lib/serializer.py \
110
	lib/ssconf.py \
111
	lib/ssh.py \
112
	lib/storage.py \
113
	lib/utils.py \
114
	lib/uidpool.py \
115
	lib/workerpool.py
116

    
117
hypervisor_PYTHON = \
118
	lib/hypervisor/__init__.py \
119
	lib/hypervisor/hv_base.py \
120
	lib/hypervisor/hv_chroot.py \
121
	lib/hypervisor/hv_fake.py \
122
	lib/hypervisor/hv_kvm.py \
123
	lib/hypervisor/hv_xen.py
124

    
125
rapi_PYTHON = \
126
	lib/rapi/__init__.py \
127
	lib/rapi/baserlib.py \
128
	lib/rapi/client.py \
129
	lib/rapi/connector.py \
130
	lib/rapi/rlib2.py
131

    
132
http_PYTHON = \
133
	lib/http/__init__.py \
134
	lib/http/auth.py \
135
	lib/http/client.py \
136
	lib/http/server.py
137

    
138
confd_PYTHON = \
139
	lib/confd/__init__.py \
140
	lib/confd/client.py \
141
	lib/confd/querylib.py \
142
	lib/confd/server.py
143

    
144
docrst = \
145
	doc/admin.rst \
146
	doc/design-2.0.rst \
147
	doc/design-2.1.rst \
148
	doc/devnotes.rst \
149
	doc/glossary.rst \
150
	doc/hooks.rst \
151
	doc/iallocator.rst \
152
	doc/index.rst \
153
	doc/install-quick.rst \
154
	doc/install.rst \
155
	doc/locking.rst \
156
	doc/news.rst \
157
	doc/rapi.rst \
158
	doc/security.rst \
159
	doc/walkthrough.rst
160

    
161
doc/html/.stamp: $(docrst) $(docpng) doc/conf.py configure.ac
162
	@test -n "$(SPHINX)" || \
163
	    { echo 'sphinx-build' not found during configure; exit 1; }
164
	PYTHONPATH=. $(RUN_IN_TEMPDIR) $(SPHINX) -q -W -b html \
165
	    -d . \
166
	    -D version="$(VERSION_MAJOR).$(VERSION_MINOR)" \
167
	    -D release="$(PACKAGE_VERSION)" \
168
	    $(abs_top_srcdir)/doc $(CURDIR)/doc/html
169
	rm -f doc/html/.buildinfo doc/html/objects.inv
170
	touch $@
171

    
172
doc/html: doc/html/.stamp
173

    
174
doc/news.rst: NEWS
175
	set -e; \
176
	{ echo '.. This file is automatically updated at build time from $<.'; \
177
	  echo '.. Do not edit.'; \
178
	  echo; \
179
	  cat $<; \
180
	} > $@
181

    
182
doc/install-quick.rst: INSTALL
183
	set -e; \
184
	{ echo '.. This file is automatically updated at build time from $<.'; \
185
	  echo '.. Do not edit.'; \
186
	  echo; \
187
	  cat $<; \
188
	} > $@
189

    
190
docdot = \
191
	doc/arch-2.0.dot \
192
	doc/design-2.1-lock-acquire.dot \
193
	doc/design-2.1-lock-release.dot
194

    
195
docpng = $(patsubst %.dot,%.png,$(docdot))
196

    
197
# Things to build but not to install (add it to EXTRA_DIST if it should be
198
# distributed)
199
noinst_DATA = \
200
	devel/upload \
201
	doc/html \
202
	doc/examples/bash_completion \
203
	doc/examples/ganeti.cron \
204
	doc/examples/ganeti.initd \
205
	doc/examples/gnt-config-backup \
206
	doc/examples/hooks/ipsec \
207
	$(manhtml)
208

    
209
gnt_scripts = \
210
	scripts/gnt-backup \
211
	scripts/gnt-cluster \
212
	scripts/gnt-debug \
213
	scripts/gnt-instance \
214
	scripts/gnt-job \
215
	scripts/gnt-node \
216
	scripts/gnt-os
217

    
218
dist_sbin_SCRIPTS = \
219
	daemons/ganeti-noded \
220
	daemons/ganeti-watcher \
221
	daemons/ganeti-masterd \
222
	daemons/ganeti-confd \
223
	daemons/ganeti-rapi \
224
	$(gnt_scripts)
225

    
226
nodist_sbin_SCRIPTS = \
227
	daemons/ganeti-cleaner
228

    
229
dist_tools_SCRIPTS = \
230
	tools/burnin \
231
	tools/cfgshell \
232
	tools/cfgupgrade \
233
	tools/cfgupgrade12 \
234
	tools/cluster-merge \
235
	tools/lvmstrap \
236
	tools/sanitize-config
237

    
238
pkglib_SCRIPTS = \
239
	daemons/daemon-util
240

    
241
EXTRA_DIST = \
242
	NEWS \
243
	pylintrc \
244
	autotools/build-bash-completion \
245
	autotools/check-python-code \
246
	autotools/check-man \
247
	autotools/docbook-wrapper \
248
	autotools/gen-coverage \
249
	autotools/testrunner \
250
	$(RUN_IN_TEMPDIR) \
251
	daemons/daemon-util.in \
252
	daemons/ganeti-cleaner.in \
253
	devel/upload.in \
254
	$(docdot) \
255
	$(docpng) \
256
	$(docrst) \
257
	doc/conf.py \
258
	doc/html \
259
	doc/examples/ganeti.initd.in \
260
	doc/examples/ganeti.cron.in \
261
	doc/examples/gnt-config-backup.in \
262
	doc/examples/dumb-allocator \
263
	doc/examples/ganeti.default \
264
	doc/examples/ganeti.default-debug \
265
	doc/examples/hooks/ethers \
266
	doc/examples/hooks/ipsec.in \
267
	test/testutils.py \
268
	test/mocks.py \
269
	$(dist_TESTS) \
270
	$(TEST_FILES) \
271
	man/footer.sgml \
272
	$(mansgml) \
273
	$(maninput) \
274
	qa/ganeti-qa.py \
275
	qa/qa-sample.json \
276
	qa/qa_cluster.py \
277
	qa/qa_config.py \
278
	qa/qa_daemon.py \
279
	qa/qa_env.py \
280
	qa/qa_error.py \
281
	qa/qa_instance.py \
282
	qa/qa_node.py \
283
	qa/qa_os.py \
284
	qa/qa_rapi.py \
285
	qa/qa_tags.py \
286
	qa/qa_utils.py
287

    
288
man_MANS = \
289
	man/ganeti.7 \
290
	man/ganeti-cleaner.8 \
291
	man/ganeti-confd.8 \
292
	man/ganeti-masterd.8 \
293
	man/ganeti-noded.8 \
294
	man/ganeti-os-interface.7 \
295
	man/ganeti-rapi.8 \
296
	man/ganeti-watcher.8 \
297
	man/gnt-backup.8 \
298
	man/gnt-cluster.8 \
299
	man/gnt-debug.8 \
300
	man/gnt-instance.8 \
301
	man/gnt-job.8 \
302
	man/gnt-node.8 \
303
	man/gnt-os.8
304

    
305
mansgml = $(patsubst %.7,%.sgml,$(patsubst %.8,%.sgml,$(man_MANS)))
306
manhtml = $(patsubst %.sgml,%.html,$(mansgml))
307
maninput = \
308
	$(patsubst %.7,%.7.in,$(patsubst %.8,%.8.in,$(man_MANS))) \
309
	$(patsubst %.html,%.html.in,$(manhtml))
310

    
311
TEST_FILES = \
312
	test/data/bdev-both.txt \
313
	test/data/bdev-8.3-both.txt \
314
	test/data/bdev-disk.txt \
315
	test/data/bdev-net.txt \
316
	test/data/cert1.pem \
317
	test/data/proc_drbd8.txt \
318
	test/data/proc_drbd80-emptyline.txt \
319
	test/data/proc_drbd83.txt
320

    
321
python_tests = \
322
	test/ganeti.bdev_unittest.py \
323
	test/ganeti.cli_unittest.py \
324
	test/ganeti.cmdlib_unittest.py \
325
	test/ganeti.compat_unittest.py \
326
	test/ganeti.confd.client_unittest.py \
327
	test/ganeti.config_unittest.py \
328
	test/ganeti.constants_unittest.py \
329
	test/ganeti.errors_unittest.py \
330
	test/ganeti.hooks_unittest.py \
331
	test/ganeti.http_unittest.py \
332
	test/ganeti.locking_unittest.py \
333
	test/ganeti.mcpu_unittest.py \
334
	test/ganeti.objects_unittest.py \
335
	test/ganeti.opcodes_unittest.py \
336
	test/ganeti.rapi.client_unittest.py \
337
	test/ganeti.rapi.resources_unittest.py \
338
	test/ganeti.serializer_unittest.py \
339
	test/ganeti.ssh_unittest.py \
340
	test/ganeti.uidpool_unittest.py \
341
	test/ganeti.utils_unittest.py \
342
	test/ganeti.workerpool_unittest.py \
343
	test/docs_unittest.py \
344
	test/tempfile_fork_unittest.py
345

    
346
dist_TESTS = \
347
	test/daemon-util_unittest.bash \
348
	$(python_tests)
349

    
350
nodist_TESTS =
351

    
352
TESTS = $(dist_TESTS) $(nodist_TESTS)
353

    
354
# Environment for all tests
355
PLAIN_TESTS_ENVIRONMENT = \
356
	PYTHONPATH=. TOP_SRCDIR=$(abs_top_srcdir) PYTHON=$(PYTHON) $(RUN_IN_TEMPDIR)
357

    
358
# Environment for tests run by automake
359
TESTS_ENVIRONMENT = \
360
	$(PLAIN_TESTS_ENVIRONMENT) $(abs_top_srcdir)/autotools/testrunner
361

    
362
all_python_code = \
363
	$(dist_sbin_SCRIPTS) \
364
	$(dist_tools_SCRIPTS) \
365
	$(python_tests) \
366
	$(pkgpython_PYTHON) \
367
	$(hypervisor_PYTHON) \
368
	$(rapi_PYTHON) \
369
	$(http_PYTHON) \
370
	$(confd_PYTHON) \
371
	$(noinst_PYTHON)
372

    
373
srclink_files = \
374
	man/footer.sgml \
375
	test/daemon-util_unittest.bash \
376
	$(all_python_code)
377

    
378
check_python_code = \
379
	$(BUILD_BASH_COMPLETION) \
380
	$(all_python_code)
381

    
382
lint_python_code = \
383
	ganeti \
384
	$(dist_sbin_SCRIPTS) \
385
	$(dist_tools_SCRIPTS) \
386
	$(BUILD_BASH_COMPLETION)
387

    
388
test/daemon-util_unittest.bash: daemons/daemon-util
389

    
390
devel/upload: devel/upload.in $(REPLACE_VARS_SED)
391
	sed -f $(REPLACE_VARS_SED) < $< > $@
392
	chmod u+x $@
393

    
394
daemons/%: daemons/%.in \
395
		$(REPLACE_VARS_SED)
396
	sed -f $(REPLACE_VARS_SED) < $< > $@
397
	chmod +x $@
398

    
399
doc/examples/%: doc/examples/%.in \
400
		$(REPLACE_VARS_SED)
401
	sed -f $(REPLACE_VARS_SED) < $< > $@
402

    
403
doc/examples/hooks/%: doc/examples/hooks/%.in \
404
		$(REPLACE_VARS_SED)
405
	sed -f $(REPLACE_VARS_SED) < $< > $@
406

    
407
doc/examples/bash_completion: $(BUILD_BASH_COMPLETION) $(RUN_IN_TEMPDIR) \
408
	lib/cli.py $(gnt_scripts) tools/burnin
409
	PYTHONPATH=. $(RUN_IN_TEMPDIR) $(CURDIR)/$(BUILD_BASH_COMPLETION) > $@
410

    
411
doc/%.png: doc/%.dot
412
	@test -n "$(DOT)" || { echo 'dot' not found during configure; exit 1; }
413
	$(DOT) -Tpng -o $@ $<
414

    
415
man/%.7.in man/%.8.in: man/%.sgml man/footer.sgml $(DOCBOOK_WRAPPER)
416
	@test -n "$(DOCBOOK2MAN)" || \
417
	  { echo 'docbook2man' not found during configure; exit 1; }
418
	$(DOCBOOK_WRAPPER) "$(DOCBOOK2MAN)" $< $(notdir $(@:.in=)) $@
419
	$(CHECK_MAN) $@
420

    
421
man/%.html.in: man/%.sgml man/footer.sgml $(DOCBOOK_WRAPPER)
422
	@test -n "$(DOCBOOK2HTML)" || \
423
	  { echo 'docbook2html' not found during configure; exit 1; }
424
	$(DOCBOOK_WRAPPER) "$(DOCBOOK2HTML) --nochunks" $< $(notdir $(@:.in=)) $@
425

    
426
man/%.7: man/%.7.in $(REPLACE_VARS_SED)
427
	sed -f $(REPLACE_VARS_SED) < $< > $@
428

    
429
man/%.8: man/%.8.in $(REPLACE_VARS_SED)
430
	sed -f $(REPLACE_VARS_SED) < $< > $@
431

    
432
man/%.html: man/%.html.in $(REPLACE_VARS_SED)
433
	sed -f $(REPLACE_VARS_SED) < $< > $@
434

    
435
lib/_autoconf.py: Makefile stamp-directories
436
	set -e; \
437
	{ echo '# This file is automatically generated, do not edit!'; \
438
	  echo '#'; \
439
	  echo ''; \
440
	  echo '"""Build-time configuration for Ganeti.'; \
441
	  echo '';\
442
	  echo 'This file is autogenerated by the build process.'; \
443
	  echo 'For any changes you need to re-run ./configure (and'; \
444
	  echo 'not edit by hand).'; \
445
	  echo ''; \
446
	  echo '"""'; \
447
	  echo ''; \
448
	  echo '# pylint: disable-msg=C0301,C0324'; \
449
	  echo '# because this is autogenerated, we do not want'; \
450
	  echo '# style warnings' ; \
451
	  echo ''; \
452
	  echo "PACKAGE_VERSION = '$(PACKAGE_VERSION)'"; \
453
	  echo "VERSION_MAJOR = '$(VERSION_MAJOR)'"; \
454
	  echo "VERSION_MINOR = '$(VERSION_MINOR)'"; \
455
	  echo "VERSION_REVISION = '$(VERSION_REVISION)'"; \
456
	  echo "VERSION_SUFFIX = '$(VERSION_SUFFIX)'"; \
457
	  echo "VERSION_FULL = '$(VERSION_FULL)'"; \
458
	  echo "LOCALSTATEDIR = '$(localstatedir)'"; \
459
	  echo "SYSCONFDIR = '$(sysconfdir)'"; \
460
	  echo "SSH_CONFIG_DIR = '$(SSH_CONFIG_DIR)'"; \
461
	  echo "EXPORT_DIR = '$(EXPORT_DIR)'"; \
462
	  echo "OS_SEARCH_PATH = [$(OS_SEARCH_PATH)]"; \
463
	  echo "XEN_BOOTLOADER = '$(XEN_BOOTLOADER)'"; \
464
	  echo "XEN_KERNEL = '$(XEN_KERNEL)'"; \
465
	  echo "XEN_INITRD = '$(XEN_INITRD)'"; \
466
	  echo "FILE_STORAGE_DIR = '$(FILE_STORAGE_DIR)'"; \
467
	  echo "ENABLE_FILE_STORAGE = $(ENABLE_FILE_STORAGE)"; \
468
	  echo "IALLOCATOR_SEARCH_PATH = [$(IALLOCATOR_SEARCH_PATH)]"; \
469
	  echo "KVM_PATH = '$(KVM_PATH)'"; \
470
	  echo "SOCAT_PATH = '$(SOCAT)'"; \
471
	  echo "SOCAT_USE_ESCAPE = $(SOCAT_USE_ESCAPE)"; \
472
	  echo "LVM_STRIPECOUNT = $(LVM_STRIPECOUNT)"; \
473
	  echo "TOOLSDIR = '$(toolsdir)'"; \
474
	  echo "GNT_SCRIPTS = [$(foreach i,$(notdir $(gnt_scripts)),'$(i)',)]"; \
475
	  echo "PKGLIBDIR = '$(pkglibdir)'"; \
476
	  echo "DRBD_BARRIERS = $(DRBD_BARRIERS)"; \
477
	  echo "SYSLOG_USAGE = '$(SYSLOG_USAGE)'"; \
478
	} > $@
479

    
480
$(REPLACE_VARS_SED): Makefile
481
	set -e; \
482
	{ echo 's#@PREFIX@#$(prefix)#g'; \
483
	  echo 's#@SYSCONFDIR@#$(sysconfdir)#g'; \
484
	  echo 's#@LOCALSTATEDIR@#$(localstatedir)#g'; \
485
	  echo 's#@BINDIR@#$(bindir)#g'; \
486
	  echo 's#@SBINDIR@#$(sbindir)#g'; \
487
	  echo 's#@GANETI_VERSION@#$(PACKAGE_VERSION)#g'; \
488
	  echo 's#@CUSTOM_XEN_BOOTLOADER@#$(XEN_BOOTLOADER)#g'; \
489
	  echo 's#@CUSTOM_XEN_KERNEL@#$(XEN_KERNEL)#g'; \
490
	  echo 's#@CUSTOM_XEN_INITRD@#$(XEN_INITRD)#g'; \
491
	  echo 's#@RPL_FILE_STORAGE_DIR@#$(FILE_STORAGE_DIR)#g'; \
492
	  echo 's#@RPL_SSH_INITD_SCRIPT@#$(SSH_INITD_SCRIPT)#g'; \
493
	  echo 's#@PKGLIBDIR@#$(pkglibdir)#g'; \
494
	} > $@
495

    
496
# We need to create symlinks because "make distcheck" will not install Python
497
# files when building.
498
stamp-srclinks: Makefile stamp-directories
499
	set -e; \
500
	for i in $(srclink_files); do \
501
		if test ! -f $$i -a -f $(abs_top_srcdir)/$$i; then \
502
			$(LN_S) $(abs_top_srcdir)/$$i $$i; \
503
		fi; \
504
	done
505
	touch $@
506

    
507
.PHONY: ganeti
508
ganeti:
509
	cd $(top_builddir) && test -h "$@" || { rm -f $@ && $(LN_S) lib $@; }
510

    
511
check-local:
512
	$(CHECK_PYTHON_CODE) $(check_python_code)
513

    
514
.PHONY: lint
515
lint: ganeti $(BUILT_SOURCES)
516
	@test -n "$(PYLINT)" || { echo 'pylint' not found during configure; exit 1; }
517
	$(PYLINT) $(LINT_OPTS) $(lint_python_code)
518

    
519
# a dist hook rule for catching revision control directories
520
distcheck-hook:
521
	if find $(top_distdir) -name .svn -or -name .git | grep .; then \
522
		echo "Found revision control files in final archive." 1>&2; \
523
		exit 1; \
524
	fi
525
	if find $(top_distdir) -name '*.py[co]' | grep .; then \
526
		echo "Found Python byte code in final archive." 1>&2; \
527
		exit 1; \
528
	fi
529
	if find $(top_distdir) -name '*~' | grep .; then \
530
		echo "Found backup files in final archive." 1>&2; \
531
		exit 1; \
532
	fi
533

    
534
install-exec-local:
535
	@mkdir_p@ "$(DESTDIR)${localstatedir}/lib/ganeti" \
536
	  "$(DESTDIR)${localstatedir}/log/ganeti" \
537
	  "$(DESTDIR)${localstatedir}/run/ganeti"
538

    
539
stamp-directories: Makefile
540
	@mkdir_p@ $(DIRS)
541
	touch $@
542

    
543
.PHONY: apidoc
544
apidoc: epydoc.conf $(RUN_IN_TEMPDIR) $(BUILT_SOURCES)
545
	test -e doc/api || mkdir doc/api
546
	$(RUN_IN_TEMPDIR) epydoc -v \
547
		--conf $(CURDIR)/epydoc.conf \
548
		--output $(CURDIR)/doc/api
549

    
550
.PHONY: TAGS
551
TAGS: $(BUILT_SOURCES)
552
	rm -f TAGS
553
	find . -path './lib/*.py' -o -path 'scripts/gnt-*' -o \
554
	  -path 'daemons/ganeti-*' -o -path 'tools/*' | \
555
	  etags -
556

    
557
.PHONY: coverage
558
coverage: $(BUILT_SOURCES) $(python_tests)
559
	set -e; \
560
	mkdir -p doc/coverage; \
561
	COVERAGE_FILE=$(CURDIR)/doc/coverage/data \
562
	TEXT_COVERAGE=$(CURDIR)/doc/coverage/report.txt \
563
	HTML_COVERAGE=$(CURDIR)/doc/coverage \
564
	$(PLAIN_TESTS_ENVIRONMENT) $(abs_top_srcdir)/autotools/gen-coverage \
565
	$(python_tests)
566

    
567
commit-check: distcheck lint apidoc
568

    
569
# vim: set noet :