INSTALL/PROBLEMS updates
authorSteve Youngs <steve@sxemacs.org>
Mon, 5 Dec 2011 00:17:52 +0000 (10:17 +1000)
committerSteve Youngs <steve@sxemacs.org>
Mon, 5 Dec 2011 00:17:52 +0000 (10:17 +1000)
* merges:
  Give a little more detail about crash reporting on MacOS X
  Add resolution to missing makeinfo while building
  Update link to mpc library. Warn of texinfo needed to build from git. Small typo fix

INSTALL
PROBLEMS

diff --git a/INSTALL b/INSTALL
index 0fdfeb9..0897915 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,5 +1,5 @@
 SXEmacs Installation Guide
-Copyright (C) 2005 - 2008 Steve Youngs
+Copyright (C) 2005 - 2011 Steve Youngs
 
 
 Building from tarball release: 
@@ -256,7 +256,7 @@ install them and incorporate them into SXEmacs.
     http://www.mpfr.org
 
   - MPC (Multi-Precision Complex numbers):
-    http://www.lix.polytechnique.fr/Labo/Andreas.Enge/mpc/mpc.html
+    http://www.multiprecision.org/index.php?prog=mpc
 
   The configure option to control ENT libraries is --with-ent.  It
   defaults to `all'.
@@ -352,6 +352,10 @@ particular that is:
 - your OS and machine architecture
 - the steps you have done
 
+There is a script under contrib called tar-build-failure.sh that
+will attempt to gather this information and create a tar file with
+helpful logs.
+
 Before submitting a report at http://issues.sxemacs.org/, please show
 up either on the mailing list or the IRC channel.  The developers can
 tell you in much greater detail what they need and how you can get the
@@ -380,6 +384,7 @@ You need at least...
 
   automake 1.9.4
   autoconf 2.60
+  texinfo 4.8
 
 Warnings from autogen.sh:
 ------------------------
@@ -395,7 +400,7 @@ The two most common warnings seen are...
     about quoting and you have some older style macros defined like:
     AC_DEFUN(NAME, ...) instead of AC_DEFUN([NAME], ...).
 
-  Warnings about ETAGS variable being redifined
+  Warnings about ETAGS variable being redefined
 
     These are because automake has a pre-defined ETAGS target that
     projects can use, unfortunately it doesn't fit in with our needs,
index 81db39f..24cda27 100644 (file)
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -269,6 +269,38 @@ Or:
 Reconfigure and rebuild SXEmacs afterwards.
 
 
+** Build fails because of missing makeinfo
+
+Install the GNU texinfo package on your system. You'll need at least
+version 4.8.
+
+
+** MacOS X warns of a crash during configure
+
+This is normal, as one of the tests made during configure (for the
+realpath call correctness) induces as crash.
+
+If you are developing SXEmacs and will do lots of runs of configure
+and that dialog annoys you, consider issuing:
+
+    # Disable crash reporting
+    sudo launchctl unload -w /System/Library/LaunchDaemons/com.apple.ReportCrash.Root.plist
+    # Redo last configure
+    ./config.status --recheck 
+    # Enable crash reporting
+    sudo launchctl load -w /System/Library/LaunchDaemons/com.apple.ReportCrash.Root.plist
+
+Another alternative (not recommended) is to launch
+
+       /Developer/Applications/Utilities/CrashReporterPrefs
+
+and configure the mode to server, but you will loose notifications of
+crashes on all applications.
+
+In order to give SXEmacs developers with good diagnosis information it
+is recommended the mode be Developer.
+
+
 * XEmacs Packages
 =================