fix, initialise auto_remove_nodes upon ase_make_digraph()
[sxemacs] / PROBLEMS
index 81db39f..cdf90b3 100644 (file)
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -195,6 +195,14 @@ To run configure successfully...
 
     CONFIG_SHELL=/path/to/bash $CONFIG_SHELL configure [option, ...]
 
+*** configure on FreeBSD
+
+Turning on the use of libssp and -fstack-protector from configure
+( --with-error-checking=stack ) will result in a broken build. 
+
+Do not, under any circumstances, add -fstack-protector to CFLAGS, even 
+independently of the stack error checking option. 
+
 ** bdwgc and gcc and code optimisation
 
 There are some weird optimisation issues with the Boehm-Demers-Weiser
@@ -269,6 +277,77 @@ 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.
+
+** OpenIndiana
+
+SXEmacs does build and run on OpenIndiana (151a) but you will need to
+install a few files/packages beforehand.  Namely...
+
+    Common Name             OpenIndiana Package Name
+
+       GCC                     gcc-3
+       GNU M4                  gnu-m4
+       automake                automake-110
+       autoconf                autoconf
+       libtool                 libtool (also install libltdl)
+       pkg-config              gettext
+       math.h                  header-math
+       bison                   bison
+       gmp                     gmp
+       mpfr                    mpfr
+
+Yes, you read that right... to get pkg-config you must install the
+"gettext" package. :-)
+
+In that list, `bison', `gmp', and `mpfr' are not critical, but you
+will get extra functionality in your SXEmacs if you have them.
+
+*** automake additional instructions for OpenIndiana
+
+When you install the automake-110 OpenIndiana package it won't set up
+the symlinks to /usr/bin/automake or /usr/bin/aclocal.  Fix that
+with...
+
+       sudo ln -sv automake-1.10 /usr/bin/automake
+       sudo ln -sv aclocal-1.10 /usr/bin/aclocal
+
+*** Running SXEmacs configure on OpenIndiana
+
+There's one more quirk with OpenIndiana when you try to run SXEmacs'
+configure... you MUST set $CONFIG_SHELL
+
+            CONFIG_SHELL=/bin/bash ../configure [opts]
+
 * XEmacs Packages
 =================
 
@@ -482,11 +561,6 @@ This is due to missing (hardware-)mixing capabilities of your
 soundcard.  There is a user-space plugin called dmix, which can
 effectively circumvent this issue.
 
-*** SXEmacs dumps core when using the aRts audio device
-
-Does it?  Please report details (version number of aRts, backtrace,
-etc.).
-
 *** SXEmacs crashes when using state sentinels with asynchronous sounds
 
 This is a known bug (#13 in our bug database).  At the moment the only