1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
This is the GNU cflow package.
This document describes the actions needed to build the pre-release
or CVS version of the package. See end of file for copying conditions.
* Introduction
This is a *pre-release* version, and not ready for production use yet. If you
are taking source from CVS, you will need to have automake, and
autoconf installed to bootstrap the package. See the chapter `Building' for
the detailed instructions. After bootstrapping, there should be a file
'INSTALL' with generic installation instructions. Package-specific
installation instructions are set forth in the file README.
Please, note that the accompanying documentation may be inaccurate or
incomplete (well, to say the truth it is absent. See TODO for more info).
The ChangeLog file is the authoritative documentation for all recent changes.
Report bugs to <bug-cflow@gnu.org>
* Checking Out the Sources
The following instructions apply if you wish to obtain sources from
the CVS repository:
To checkout the source tree from CVS issue the following command:
CVS_RSH=ssh \
cvs -d :ext:anoncvs@cvs.savannah.gnu.org:/cvsroot/cflow checkout cflow
Make sure SSHv2 is used.
This will give you read-only access. If you think you need write access,
contact the mailing list.
The CVS repository is also available via HTTP from
http://cvs.savannah.gnu.org/cgi-bin/viewcvs/cflow/cflow/
* Building
If you have taken the sources from CVS you will need the following
packages to build cflow. I don't make any extra effort to accommodate
older versions of these packages, so please make sure that you have the
latest stable version.
- Automake <http://www.gnu.org/software/automake/>
- Autoconf <http://www.gnu.org/software/autoconf/>
- Flex <http://flex.sourceforge.net/>
- Gettext <http://www.gnu.org/software/gettext/>
- Gnulib <http://www.gnu.org/software/gnulib/>
- M4 <http://www.gnu.org/software/m4/>
- Texinfo <http://www.gnu.org/software/texinfo>
- Wget <http://www.gnu.org/software/wget/>
To prepare the package for building run `build-aux/bootstrap' utility.
For example:
$ cd cflow
$ build-aux/bootstrap
If you have already checked out gnulib sources, use --gnulib-srcdir
to specify their location, this will spare you time and bandwidth:
$ cd cflow
$ build-aux/bootstrap --gnulib-srcdir=$HOME/gnu/gnulib
* Debugging
To enable additional debugging information, configure the package with
--enable-debug option.
Sometimes it is impossible or inconvenient to start cflow from the
debugger. In this case, use --HANG option. The option instructs the
program to sleep for a given number of seconds (3600 by default)
right after startup. For example, run:
cflow --HANG [OTHER-OPTIONS]
Then switch to another terminal, get the PID of the ivoked utility
and attach to it using gdb:
gdb cflow PID
Once in gdb, issue the following command
set _argp_hang=0
Now set your breakpoints and proceed as usual.
* Copyright information:
Copyright (C) 2005, 2007 Sergey Poznyakoff
Permission is granted to anyone to make or distribute verbatim copies
of this document as received, in any medium, provided that the
copyright notice and this permission notice are preserved,
thus giving the recipient permission to redistribute in turn.
Permission is granted to distribute modified versions
of this document, or of portions of it,
under the above conditions, provided also that they
carry prominent notices stating who last changed them.
Local Variables:
mode: outline
paragraph-separate: "[ ]*$"
version-control: never
End:
|