Code

Imported upstream version 1.4.8
[pkg-rrdtool.git] / doc / rrdbuild.1
1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings.  \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 .    ds -- \(*W-
28 .    ds PI pi
29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
31 .    ds L" ""
32 .    ds R" ""
33 .    ds C` ""
34 .    ds C' ""
35 'br\}
36 .el\{\
37 .    ds -- \|\(em\|
38 .    ds PI \(*p
39 .    ds L" ``
40 .    ds R" ''
41 'br\}
42 .\"
43 .\" Escape single quotes in literal strings from groff's Unicode transform.
44 .ie \n(.g .ds Aq \(aq
45 .el       .ds Aq '
46 .\"
47 .\" If the F register is turned on, we'll generate index entries on stderr for
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49 .\" entries marked with X<> in POD.  Of course, you'll have to process the
50 .\" output yourself in some meaningful fashion.
51 .ie \nF \{\
52 .    de IX
53 .    tm Index:\\$1\t\\n%\t"\\$2"
54 ..
55 .    nr % 0
56 .    rr F
57 .\}
58 .el \{\
59 .    de IX
60 ..
61 .\}
62 .\"
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
65 .    \" fudge factors for nroff and troff
66 .if n \{\
67 .    ds #H 0
68 .    ds #V .8m
69 .    ds #F .3m
70 .    ds #[ \f1
71 .    ds #] \fP
72 .\}
73 .if t \{\
74 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
75 .    ds #V .6m
76 .    ds #F 0
77 .    ds #[ \&
78 .    ds #] \&
79 .\}
80 .    \" simple accents for nroff and troff
81 .if n \{\
82 .    ds ' \&
83 .    ds ` \&
84 .    ds ^ \&
85 .    ds , \&
86 .    ds ~ ~
87 .    ds /
88 .\}
89 .if t \{\
90 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
91 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
92 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
93 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
94 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
95 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
96 .\}
97 .    \" troff and (daisy-wheel) nroff accents
98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
105 .ds ae a\h'-(\w'a'u*4/10)'e
106 .ds Ae A\h'-(\w'A'u*4/10)'E
107 .    \" corrections for vroff
108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
110 .    \" for low resolution devices (crt and lpr)
111 .if \n(.H>23 .if \n(.V>19 \
112 \{\
113 .    ds : e
114 .    ds 8 ss
115 .    ds o a
116 .    ds d- d\h'-1'\(ga
117 .    ds D- D\h'-1'\(hy
118 .    ds th \o'bp'
119 .    ds Th \o'LP'
120 .    ds ae ae
121 .    ds Ae AE
122 .\}
123 .rm #[ #] #H #V #F C
124 .\" ========================================================================
125 .\"
126 .IX Title "RRDBUILD 1"
127 .TH RRDBUILD 1 "2013-05-23" "1.4.8" "rrdtool"
128 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
129 .\" way too many mistakes in technical documents.
130 .if n .ad l
131 .nh
132 .SH "NAME"
133 rrdbuild \- Instructions for building RRDtool
134 .SH "OVERVIEW"
135 .IX Header "OVERVIEW"
136 If you downloaded the source of RRDtool you have to compile it. This
137 document will give some information on how this is done.
138 .PP
139 RRDtool relies on services of third part libraries. Some of these libraries
140 may already be installed on your system. You have to compile copies of the other
141 ones before you can build RRDtool.
142 .PP
143 This document will tell you about all the necessary steps to get going.
144 .PP
145 These instructions assume you are using a \fBbash\fR shell. If you use csh/tcsh,
146 then you can either type \fIbash\fR to switch to bash for the compilation or if
147 you know what you are doing just replace the export bits with
148 setenv.
149 .PP
150 We further assume that your copies of \fBtar\fR and \fBmake\fR are actually \fB\s-1GNU\s0
151 tar\fR and \fB\s-1GNU\s0 make\fR respectively. It could be that they are installed as
152 \&\fBgtar\fR and \fBgmake\fR on your system.
153 .SH "OPTIMISTIC BUILD"
154 .IX Header "OPTIMISTIC BUILD"
155 Before you start to build RRDtool, you have to decide two things:
156 .IP "1." 4
157 In which directory you want to build the software.
158 .IP "2." 4
159 Where you want to install the software.
160 .PP
161 Once you have decided. Save the two locations into environment variables.
162 .PP
163 .Vb 2
164 \& BUILD_DIR=/tmp/rrdbuild
165 \& INSTALL_DIR=/opt/rrdtool\-1.4.8
166 .Ve
167 .PP
168 If your \fI/tmp\fR is mounted with the option noexec (\s-1RHEL\s0 seems todo that) you have to choose
169 a different directory!
170 .PP
171 Now make sure the \s-1BUILD_DIR\s0 exists and go there:
172 .PP
173 .Vb 2
174 \& mkdir \-p $BUILD_DIR
175 \& cd $BUILD_DIR
176 .Ve
177 .PP
178 Lets first assume you already have all the necessary libraries
179 pre-installed.
180 .PP
181 .Vb 4
182 \& wget http://oss.oetiker.ch/rrdtool/pub/rrdtool\-1.4.8.tar.gz
183 \& gunzip \-c rrdtool\-1.4.8.tar.gz | tar xf \-
184 \& cd rrdtool\-1.4.8
185 \& ./configure \-\-prefix=$INSTALL_DIR && make && make install
186 .Ve
187 .PP
188 Ok, this was very optimistic. This try will probably have ended with
189 \&\fBconfigure\fR complaining about several missing libraries.
190 .SH "INSTALLING DEPENDENCIES"
191 .IX Header "INSTALLING DEPENDENCIES"
192 If your \s-1OS\s0 lets you install additional packages from a software repository,
193 you may get away with installing the missing packages. When the packages are
194 installed, run configure again and try to compile again. Below you find some
195 hints on getting your \s-1OS\s0 ready for compiling RRDtool.
196 .PP
197 Additions to this list are welcome. In general RRDtool should work with the
198 latest versions of the libraries. The versions listed here are just what was
199 current when I tested this.
200 .SS "OpenSolaris 2008.05"
201 .IX Subsection "OpenSolaris 2008.05"
202 Just add a compiler and the gnome development package:
203 .PP
204 .Vb 2
205 \& pkg install sunstudioexpress
206 \& pkg install SUNWgnome\-common\-devel
207 .Ve
208 .PP
209 There is a problem with \fIcairo.pc\fR on OpenSolaris. It suggests that
210 xrender is required for compilation with cairo. This is not true and also
211 bad since OpenSolaris does not include an \fIxrender.pc\fR file. Use Perl to
212 fix this:
213 .PP
214 .Vb 1
215 \& perl \-i~ \-p \-e \*(Aqs/(Requires.*?)\es*xrender.*/$1/\*(Aq /usr/lib/pkgconfig/cairo.pc
216 .Ve
217 .PP
218 Make sure the RRDtool build system finds your new compiler
219 .PP
220 .Vb 1
221 \& export PATH=/opt/SunStudioExpress/bin
222 .Ve
223 .SS "Debian / Ubuntu"
224 .IX Subsection "Debian / Ubuntu"
225 Use apt-get to make sure you have all that is required. A number
226 of packages will get added through dependencies.
227 .PP
228 .Vb 1
229 \& apt\-get install libpango1.0\-dev libxml2\-dev
230 .Ve
231 .SS "Gentoo"
232 .IX Subsection "Gentoo"
233 In Gentoo installing RRDtool is really simple you just need to \fBemerge
234 rrdtool\fR. All dependencies will be handled automatically by the portage
235 system. The only thing you should care about are \s-1USE\s0 flags, which allow you
236 fine tune features RRDtool will be built with. Currently the following \s-1USE\s0
237 flags are available:
238 .PP
239 .Vb 7
240 \& doc    \- install .html and .txt documentation
241 \&          into /usr/share/doc/rrdtool\-1.x.xx/
242 \& perl   \- build and install perl language bindings
243 \& python \- build and install python language bindings
244 \& ruby   \- build and install ruby language bindings
245 \& tcl    \- build and install tcl language bindings
246 \& rrdcgi \- build and install rrdcgi
247 .Ve
248 .PP
249 After you've decided which \s-1USE\s0 flags you need, set them either in
250 \&\fImake.conf\fR or \fI/etc/portage/package.use\fR and finally run:
251 .PP
252 .Vb 1
253 \& # emerge \-va rrdtool
254 .Ve
255 .PP
256 Take a look at Gentoo handbook for further details on how to manage \s-1USE\s0
257 flags: http://www.gentoo.org/doc/en/handbook/handbook\-x86.xml?part=2
258 .SH "BUILDING DEPENDENCIES"
259 .IX Header "BUILDING DEPENDENCIES"
260 But again this may have been too optimistic still, and you actually have to
261 compile your own copies of some of the required libraries. Things like
262 libpng and zlib are pretty standard so you will probably have them on your
263 system anyway. Freetype, Fontinst, Cairo, Pango may be installed, but it is
264 possible that they are pretty old and thus don't live up to our
265 expectations, so you may want to compile their latest versions.
266 .SS "General build tips for \s-1AIX\s0"
267 .IX Subsection "General build tips for AIX"
268 If you are working with \s-1AIX\s0, you may find the \fB\-\-disable\-shared\fR option
269 will cause things to break for you. In that case you may have to install the
270 shared libraries into the RRDtool \s-1PREFIX\s0 and work with \fB\-\-disable\-static\fR
271 instead.
272 .PP
273 Another hint to get RRDtool working on \s-1AIX\s0 is to use the \s-1IBM\s0 \s-1XL\s0 C Compiler:
274 .PP
275 .Vb 2
276 \& export CC=/usr/vac/bin/cc
277 \& export PERLCC=$CC
278 .Ve
279 .PP
280 (Better instructions for \s-1AIX\s0 welcome!)
281 .SS "Build Instructions"
282 .IX Subsection "Build Instructions"
283 Some libraries want to know where other libraries are. For this to work,
284 set the following environment variable
285 .PP
286 .Vb 2
287 \& export PKG_CONFIG_PATH=${INSTALL_DIR}/lib/pkgconfig
288 \& export PATH=$INSTALL_DIR/bin:$PATH
289 .Ve
290 .PP
291 The above relies on the presence of the \fIpkgconfig\fR program. Below you find instructions
292 on how to compile pkgconfig.
293 .PP
294 Since we are compiling libraries dynamically, they must know where to find
295 each other. This is done by setting an appropriate \s-1LDFLAGS\s0. Unfortunately,
296 the syntax again differs from system to system:
297 .IP "Solaris" 4
298 .IX Item "Solaris"
299 .Vb 1
300 \& export LDFLAGS=\-R${INSTALL_DIR}/lib
301 .Ve
302 .Sp
303 if you are using the Sun Studio/Forte compiler, you may also want to set
304 .Sp
305 .Vb 2
306 \& CFLAGS="\-xO3 \-xcode=pic13"   (SPARC)
307 \& CFLAGS="\-xO3 \-Kpic"          (x86)
308 .Ve
309 .IP "Linux" 4
310 .IX Item "Linux"
311 .Vb 1
312 \& export LDFLAGS="\-Wl,\-\-rpath \-Wl,${INSTALL_DIR}/lib"
313 .Ve
314 .IP "\s-1HPUX\s0" 4
315 .IX Item "HPUX"
316 .Vb 1
317 \& export LDFLAGS="+b${INSTALL_DIR}/lib"
318 .Ve
319 .IP "\s-1AIX\s0" 4
320 .IX Item "AIX"
321 .Vb 1
322 \& export LDFLAGS="\-Wl,\-blibpath:${INSTALL_DIR}/lib"
323 .Ve
324 .PP
325 If you have \s-1GNU\s0 make installed and it is not called 'make',
326 then do
327 .PP
328 .Vb 2
329 \& export MAKE=gmake
330 \& export GNUMAKE=gmake
331 .Ve
332 .PP
333 otherwise just do
334 .PP
335 .Vb 1
336 \& export MAKE=make
337 .Ve
338 .PP
339 \fIBuilding pkgconfig\fR
340 .IX Subsection "Building pkgconfig"
341 .PP
342 As mentioned above, without pkgconfig the whole build process will be lots
343 of pain and suffering, so make sure you have a copy on your system. If it is
344 not available natively, here is how to compile it.
345 .PP
346 .Vb 6
347 \& wget http://pkgconfig.freedesktop.org/releases/pkg\-config\-0.23.tar.gz
348 \& gunzip \-c pkg\-config\-0.23.tar.gz | tar xf \-
349 \& cd pkg\-config\-0.23
350 \& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
351 \& $MAKE
352 \& $MAKE install
353 .Ve
354 .PP
355 After installing pkgconfig in a custom directory, setting up the corresponding
356 environment variable will be helpful.
357 .PP
358 .Vb 1
359 \& export PKG_CONFIG=$INSTALL_DIR/bin/pkg\-config
360 .Ve
361 .PP
362 \fIBuilding zlib\fR
363 .IX Subsection "Building zlib"
364 .PP
365 Chances are very high that you already have that on your system ...
366 .PP
367 .Vb 7
368 \& cd $BUILD_DIR
369 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/zlib\-1.2.3.tar.gz
370 \& gunzip \-c zlib\-1.2.3.tar.gz | tar xf \-
371 \& cd zlib\-1.2.3
372 \& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC" \-\-shared
373 \& $MAKE
374 \& $MAKE install
375 .Ve
376 .PP
377 \fIBuilding libpng\fR
378 .IX Subsection "Building libpng"
379 .PP
380 Libpng itself requires zlib to build, so we need to help a bit. If you
381 already have a copy of zlib on your system (which is very likely) you can
382 drop the settings of \s-1LDFLAGS\s0 and \s-1CPPFLAGS\s0. Note that the backslash (\e) at
383 the end of line 4 means that line 4 and line 5 are on one line.
384 .PP
385 .Vb 7
386 \& cd $BUILD_DIR
387 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/libpng\-1.2.18.tar.gz
388 \& gunzip \-c libpng\-1.2.18.tar.gz | tar xf \-
389 \& cd libpng\-1.2.10
390 \& env CFLAGS="\-O3 \-fPIC" ./configure \-\-prefix=$INSTALL_DIR
391 \& $MAKE
392 \& $MAKE install
393 .Ve
394 .PP
395 \fIBuilding freetype\fR
396 .IX Subsection "Building freetype"
397 .PP
398 .Vb 7
399 \& cd $BUILD_DIR
400 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/freetype\-2.3.5.tar.gz
401 \& gunzip \-c freetype\-2.3.5.tar.gz | tar xf \-
402 \& cd freetype\-2.3.5
403 \& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
404 \& $MAKE
405 \& $MAKE install
406 .Ve
407 .PP
408 If you run into problems building freetype on Solaris, you may want to try to
409 add the following at the start the configure line:
410 .PP
411 .Vb 1
412 \& env EGREP=egrep
413 .Ve
414 .PP
415 \fIBuilding LibXML2\fR
416 .IX Subsection "Building LibXML2"
417 .PP
418 .Vb 7
419 \& cd $BUILD_DIR
420 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/libxml2\-2.6.32.tar.gz
421 \& gunzip \-c libxml2\-2.6.32.tar.gz | tar xf \-
422 \& cd libxml2\-2.6.32
423 \& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
424 \& $MAKE
425 \& $MAKE install
426 .Ve
427 .PP
428 \fIBuilding fontconfig\fR
429 .IX Subsection "Building fontconfig"
430 .PP
431 Note that fontconfig has a run time configuration file in INSTALL_DIR/etc you
432 may want to adjust that so that fontconfig finds the fonts on your system.
433 Run the fc-cache program to build the fontconfig cache after changing the
434 config file.
435 .PP
436 .Vb 7
437 \& cd $BUILD_DIR
438 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/fontconfig\-2.4.2.tar.gz
439 \& gunzip \-c fontconfig\-2.4.2.tar.gz   | tar xf \-
440 \& cd fontconfig\-2.4.2
441 \& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC" \-\-with\-freetype\-config=$INSTALL_DIR/bin/freetype\-config
442 \& $MAKE
443 \& $MAKE install
444 .Ve
445 .PP
446 \fIBuilding Pixman\fR
447 .IX Subsection "Building Pixman"
448 .PP
449 .Vb 7
450 \& cd $BUILD_DIR
451 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/pixman\-0.10.0.tar.gz
452 \& gunzip \-c pixman\-0.10.0.tar.gz  | tar xf \-
453 \& cd pixman\-0.10.0
454 \& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
455 \& $MAKE
456 \& $MAKE install
457 .Ve
458 .PP
459 \fIBuilding Cairo\fR
460 .IX Subsection "Building Cairo"
461 .PP
462 .Vb 11
463 \& cd $BUILD_DIR
464 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/cairo\-1.6.4.tar.gz
465 \& gunzip \-c cairo\-1.6.4.tar.gz   | tar xf \-
466 \& cd cairo\-1.6.4
467 \& ./configure \-\-prefix=$INSTALL_DIR \e
468 \&    \-\-enable\-xlib=no \e
469 \&    \-\-enable\-xlib\-render=no \e
470 \&    \-\-enable\-win32=no \e
471 \&    CFLAGS="\-O3 \-fPIC"
472 \& $MAKE
473 \& $MAKE install
474 .Ve
475 .PP
476 When building on Solaris you may want todo
477 .PP
478 .Vb 5
479 \& ./configure \-\-prefix=$INSTALL_DIR \e
480 \&    \-\-enable\-xlib=no \e
481 \&    \-\-enable\-xlib\-render=no \e
482 \&    \-\-enable\-win32=no \e
483 \&    CFLAGS="\-O3 \-fPIC \-D_POSIX_PTHREAD_SEMANTICS"
484 .Ve
485 .PP
486 \fIBuilding Glib\fR
487 .IX Subsection "Building Glib"
488 .PP
489 .Vb 7
490 \& cd $BUILD_DIR
491 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/glib\-2.15.4.tar.gz
492 \& gunzip \-c glib\-2.15.4.tar.gz  | tar xf \-
493 \& cd glib\-2.15.4
494 \& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
495 \& $MAKE
496 \& $MAKE install
497 .Ve
498 .PP
499 \fIBuilding Pango\fR
500 .IX Subsection "Building Pango"
501 .PP
502 .Vb 7
503 \& cd $BUILD_DIR
504 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/pango\-1.21.1.tar.bz2
505 \& bunzip2 \-c pango\-1.21.1.tar.bz2 | tar xf \-
506 \& cd pango\-1.21.1
507 \& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC" \-\-without\-x
508 \& $MAKE
509 \& $MAKE install
510 .Ve
511 .SS "Building rrdtool (second try)"
512 .IX Subsection "Building rrdtool (second try)"
513 Now all the dependent libraries are built and you can try again. This time
514 you tell configure where it should be looking for libraries and include
515 files. This is done via environment variables. Depending on the shell you
516 are running, the syntax for setting environment variables is different.
517 .PP
518 And finally try building again. We disable the python and tcl bindings
519 because it seems that a fair number of people have ill configured python and
520 tcl setups that would prevent RRDtool from building if they are included in
521 their current state.
522 .PP
523 .Vb 5
524 \& cd $BUILD_DIR/rrdtool\-1.4.8
525 \& ./configure \-\-prefix=$INSTALL_DIR \-\-disable\-tcl \-\-disable\-python
526 \& $MAKE clean
527 \& $MAKE
528 \& $MAKE install
529 .Ve
530 .PP
531 \&\s-1SOLARIS\s0 \s-1HINT:\s0 if you want to build  the Perl module for the native Perl (the
532 one shipping with Solaris) you will need the Sun Forte compiler installed on
533 your box or you have to hand-tune bindings/perl\-shared/Makefile while
534 building!
535 .PP
536 Now go to \fI\f(CI$INSTALL_DIR\fI\fR\fB/share/rrdtool/examples/\fR and run them to see if
537 your build has been successful.
538 .SH "AUTHOR"
539 .IX Header "AUTHOR"
540 Tobias Oetiker <tobi@oetiker.ch>