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
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
=================
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