forked from ledger/ledger
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README-1ST
190 lines (134 loc) · 8.11 KB
/
README-1ST
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
README FIRST!!!
To build this code after doing a Git clone, run:
$ ./acprep update
If anything goes wrong, see "COMMON CONFIGURE/BUILD PROBLEMS" below.
If you try to configure and build without running acprep first, you are
almost certainly going to run into problems. In future, you can run
'acprep update' again and again, and it will keep you updated to the
very latest version.
I further recommend building both debug and optimized versions of Ledger, in a
subdirectory of your source tree named 'build' (which acprep will manage for
you, you simply need to create it):
$ mkdir build
$ ./acprep opt make
$ ./acprep debug make
Now install the optimized version:
$ cd build/ledger/opt
$ sudo make install
but know that you have 'build/ledger/debug' available for testing and
for more useful bug reports.
===============================================================================
COMMON CONFIGURE/BUILD PROBLEMS
===============================================================================
To build and install Ledger requires several dependencies on various
platforms. You can install these dependencies very simply for most of them
using:
$ ./acprep dependencies
The first order of business if acprep update doesn't work is to find out where
things went wrong. So follow these steps to produce a bug report I can track
down easily:
$ ./acprep --debug update # shows what acprep was thinking
$ <edit config.log> # shows what configure was thinking
With the contents of config.log, and the output from acprep --debug update,
it's usually fairly obvious where things have gone astray.
===============================================================================
F.A.Q.
===============================================================================
- Q: The build fails saying it can't find utf8.h
A: You didn't run ./acprep update.
----------------------------------------------------------------------
- Q: './acprep update' gives errors or './acprep dependencies' fails
A: You're probably missing some dependency libraries. If you tried
'./acprep dependencies' already and that didn't solve the problem,
then you may need to install dependencies by hand. On a Debian
GNU/Linux system (or Debian-based system such as Ubuntu), something
like this should work (as root):
# aptitude update
# for name in \
cmake libboost-dev libboost-date-time-dev libboost-doc \
libboost-dbg libboost-filesystem-dev libboost-graph-dev \
libboost-iostreams-dev libboost-program-options-dev \
libboost-python-dev libboost-regex-dev \
libboost-serialization-dev libboost-signals-dev \
libboost-test-dev libboost-thread-dev libboost-wave-dev \
libmpfr-dev libmpfr-dbg libmpfr-doc; \
do \
aptitude install ${name}; \
done
----------------------------------------------------------------------
- Q: Configure fails saying it can't find boost_regex
A: Look in config.log and search for "boost_regex", then scroll down a bit
until you see the exact compile error. Usually it's failing because
your include directory is different from anything acprep is expecting to
see. It could also be failing because your Boost libraries have a
custom "suffix" on them.
Let's say your Boost was installed in ~/boost, and every library has the
suffix '-xgcc42'. This is what you would run:
CPPFLAGS=-I$HOME/boost acprep --boost=xgcc42 update
----------------------------------------------------------------------
- Q: Configure fails saying it can't find MPFR
A: You need MPFR version 2.4.0 or higher. This version does not come with
most Debian distributions, so you will need to build it. The
relevant packages are 'libmpfr-dev' and 'libmpfr-dbg'. See also
the question above about what to do if './acprep update' gives
errors or './acprep dependencies' fails.
----------------------------------------------------------------------
- Q: I'm seeing a segfault deep inside the boost_regex code!
A: Actually, the real segfault is in libstdc++'s facet code. It's being
caused by using a debug Boost with a non-debug build of Ledger, or
vice-versa.
----------------------------------------------------------------------
- Q: Something else fails, or Ledger crashes on startup
A: This, I am most interested in hearing about. Please e-mail me a copy of
config.log and your build log to <johnw@newartisans.com>. Also, if
Ledger is crashing, try running it under gdb like so:
$ gdb ledger
(gdb) run <ARGS TO LEDGER>
... runs till crash ...
(gdb) bt
Send me that backtrace output, and the output from "ledger --version".
----------------------------------------------------------------------
- Q: Whenever I try to use the Python support, I get a segfault
A: Make sure that the boost_python library you linked against is using the
exact same Python as the Ledger executable. In particular I see this
bug on OS X systems where boost_python is linked against the default
Python, while Ledger is linked against the version provided by MacPorts.
Or vice versa.
Solution: Use one or the other. If you prefer the system Python, run
"port deactivate -f python26", to get MacPorts' version out of the way.
You'll then need to delete the Ledger binary and run "make" to relink
it.
----------------------------------------------------------------------
- Q: When I run "make check", the Python unit tests always crash
A: This can happen for the same reason as above. It can also happen if you
have ICU support enabled. This is a bug I'm still trying to track down.
----------------------------------------------------------------------
- Q: My distribution has versions of Boost and/or CMake that are too old for
Ledger. How do I build my own Boost and/or CMake binaries that will
work properly with Ledger? Thereafter, how do I configure Ledger
properly to use those newly built verisons of Boost and/or CMake?
A: Here's commands that one user used to make this work, for Boost 1.51.0
on Debian GNU/Linux 6.0.x (aka Debian squeeze). It's likely to work ok
for other versions of Boost as well. YMMV on other distributions and/or
other Debian distribution versions, though.
# Preparing and building Boost 1.51.0
$ cd /somewhere/you/want/to/build/boost
$ wget -N http://iweb.dl.sourceforge.net/project/boost/boost/1.51.0/boost_1_51_0.tar.bz2
$ tar xvf boost_1_51_0.tar.bz2
$ cd boost_1_51_0
$ ./bootstrap.sh
$ ./b2 --build-type=complete --layout=tagged --prefix=/where/you/want/boost/installed
$ ./b2 --build-type=complete --layout=tagged --prefix=/where/you/want/boost/installed install
# Preparing and building CMake 2.8.8
$ cd /somewhere/you/want/to/build/cmake
$ wget -N http://www.cmake.org/files/v2.8/cmake-2.8.8.tar.gz
$ tar xvf cmake-2.8.8.tar.gz
$ cd cmake-2.8.8
$ ./configure --prefix=/where/you/want/cmake/installed/
$ make
$ make install
# Building Ledger using the CMake and/or Boost as installed above
$ cd /path/to/ledger/sources
$ env PATH=/where/you/want/cmake/installed/bin:$PATH BOOST_ROOT=/where/you/want/boost/installed ./acprep --prefix=/where/you/want/ledger/installed --debug --python config
$ env PATH=/where/you/want/cmake/installed/bin:$PATH BOOST_ROOT=/where/you/want/boost/installed ./acprep --prefix=/where/you/want/ledger/installed --debug --python make
$ env PATH=/where/you/want/cmake/installed/bin:$PATH BOOST_ROOT=/where/you/want/boost/installed ./acprep --prefix=/where/you/want/ledger/installed --debug --python install