summaryrefslogtreecommitdiff
path: root/README-1ST
diff options
context:
space:
mode:
authorJohn Wiegley <johnw@newartisans.com>2009-10-31 00:08:34 -0400
committerJohn Wiegley <johnw@newartisans.com>2009-10-31 00:10:01 -0400
commit435677eea4db0ed5f974d91e569a7c2b2d825df3 (patch)
treea642e00f95758b3dc5f0522fa5361bb2b8b6993f /README-1ST
parent2149a8e773cb8bf84aa803ee12373b4861d03714 (diff)
downloadfork-ledger-435677eea4db0ed5f974d91e569a7c2b2d825df3.tar.gz
fork-ledger-435677eea4db0ed5f974d91e569a7c2b2d825df3.tar.bz2
fork-ledger-435677eea4db0ed5f974d91e569a7c2b2d825df3.zip
Added another FAQ item to README-1ST
Diffstat (limited to 'README-1ST')
-rw-r--r--README-1ST28
1 files changed, 21 insertions, 7 deletions
diff --git a/README-1ST b/README-1ST
index 0c7d3bb0..cb62accf 100644
--- a/README-1ST
+++ b/README-1ST
@@ -1,37 +1,49 @@
-
README FIRST!!!
+===============================================================================
To build this code after doing a Git clone, run:
- $ acprep update
+ $ ./acprep update
If you try to configure/build on your own, you are almost certainly going to
-run into problems.
+run into problems. In future, you can run this command again and it will keep
+you updated with the very latest version.
+===============================================================================
F.A.Q.
+ ----------------------------------------------------------------------
- Q: The build fails saying it can't find utf8.h
- A: You didn't run acprep update.
+ A: You didn't run ./acprep update.
+ ----------------------------------------------------------------------
- - Q: The build fails saying it can't find boost_regex
+ - 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 library have a custom
- "suffix" on them.
+ 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.
+
+ ----------------------------------------------------------------------
- Q: Something else fails, or Ledger crashes on startup
@@ -45,3 +57,5 @@ run into problems.
(gdb) bt
Send me that backtrace output, and the output from "ledger --version".
+
+ ----------------------------------------------------------------------