XDG Compliant user (early) packages tree.

[sxemacs] / PROBLEMS

diff --git a/PROBLEMS b/PROBLEMS
index 8862be1..bcebee8 100644 (file)
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -8,11 +8,24 @@ following idiosyncrasies:
 
 ** User init file (C-h v user-init-file)
 
-SXEmacs searches for its init file in `~/.sxemacs/init.el'.
-Symlinking your old ~/.xemacs directory should be enough to get you up
-and running.
+SXEmacs looks for user init files in `user-init-directory'.  The
+preferred directory is: ${XDG_CONFIG_HOME}/sxemacs but it can fall
+back to the old ~/.sxemacs directory.
 
-    $ ln -s ~/.xemacs ~/.sxemacs RET
+The search order is:
+
+    ${XDG_CONFIG_HOME}/sxemacs
+    ${HOME}/.config/sxemacs    # if $XDG_CONFIG_HOME is not set
+    ${HOME}/.sxemacs           # if other dirs don't exist
+
+You can also force the use of ~/.sxemacs regardless of the existence
+of the XDG dir/var by setting $SXE_USE_LEGACY environment variable to
+a non-nil value.
+
+If you're coming from XEmacs, symlinking your old ~/.xemacs directory
+to a SXEmacs location should be enough to get you up and running:
+
+    $ ln -svfn ${HOME}/.xemacs ${XDG_CONFIG_HOME}/sxemacs
 
 BTW, unlike XEmacs, SXEmacs doesn't attempt to "migrate" your old init
 file or Gnu/Emacs .emacs file.
@@ -348,6 +361,18 @@ configure... you MUST set $CONFIG_SHELL
 
             CONFIG_SHELL=/bin/bash ../configure [opts]
 
+
+** make does not stop on subdirectory build failure
+
+Due to a bug in the make argument parsing in code generated by
+autoconf it is possible for make not to stop when a subdirectory fails.
+
+This failure occurs for instance when the make command line has a variable
+assignment which has a value with a - and k. Example:
+
+make CFLAGS="-Wall -fpacked -fpedantic" build-report
+
+
 * XEmacs Packages
 =================
 
@@ -437,4 +462,4 @@ you have taglib installed.  Use the included ffi-taglib.el.
 
 The original XEmacs PROBLEMS file may be found in the SXEmacs 
 source distribution as PROBLEMS.XEmacs - while many issues mentioned
-have since been fixed, it is preserved for posterity. 
\ No newline at end of file
+have since been fixed, it is preserved for posterity.