summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-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".
+
+ ----------------------------------------------------------------------