sfos/ledger
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add some material to README-1ST, along with a couple of formatting changes.

Browse source 
Give an early pointer to where to look if 'acprep update' fails.
Clarify a few things in the first section.
Give sections clearer headers, so they can be more easily referred to.
Add a FAQ entry about what to do if './acprep update' gives errors.
Update FAQ entry about MPFR library to refer to above new entry.
This commit is contained in:
Karl Fogel 2012-10-31 14:54:55 -04:00
parent 3b9b2cf908
commit c5a15a556a
1 changed files with 36 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

43
README-1ST
View file

@ -5,9 +5,12 @@ To build this code after doing a Git clone, run:
$ ./acprep update
If you try to configure and build on your own, you are almost certainly going
to run into problems. In future, you can run this command again and again,
and it will keep you updated to the very latest version.
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
@ -21,8 +24,8 @@ Now install the optimized version, but know that you have 'build/debug/ledger'
available for testing and more useful bug reports.
===============================================================================
IF YOU HAVE CONFIGURE OR BUILD PROBLEMS
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
@ -40,9 +43,10 @@ down easily:
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.:
===============================================================================
F.A.Q.
- Q: The build fails saying it can't find utf8.h
@ -50,6 +54,29 @@ it's usually fairly obvious where things have gone astray.
----------------------------------------------------------------------
- Q: './acprep update' gives errors
A: You're probably missing some dependency libraries. Did you run
'./acprep dependencies'? If you tried that too and it didn't
work, then you may need to install dependencies by hand. On a
Debian GNU/Linux system (or Debian-based system such as Ubuntu),
something 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
@ -68,7 +95,9 @@ it's usually fairly obvious where things have gone astray.
- 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.
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 "'./acprep update' gives errors".
----------------------------------------------------------------------