Amazing the difference a paren can make, including fix my last commit.
[sxemacs] / PROBLEMS
index bcebee8..23bb9b9 100644 (file)
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -32,11 +32,22 @@ file or Gnu/Emacs .emacs file.
 
 ** Packages Hierarchy
 
+*** System-wide Packages (late-packages)
+
 The default location that SXEmacs searches for packages is
 `$prefix/share/sxemacs/'.  The same as for the user-init-file, a
 symlink is all you need to get up and running.
 
-    $ ln -s /usr/local/lib/xemacs /usr/local/share/sxemacs RET
+    $ ln -svfn /usr/local/lib/xemacs /usr/local/share/sxemacs
+
+*** User Packages in ${HOME} (early-packages)
+
+For packages that you keep in your ${HOME}, the preferred location is:
+${XDG_DATA_HOME}/sxemacs.  This is normally ${HOME}/.local/share/sxemacs,
+and SXEmacs will use that if ${XDG_DATA_HOME} is not set.
+
+These packages may also be located in ~/.sxemacs if that is where you
+have your user-init-directory set to.
 
 
 * Build Quirks
@@ -402,7 +413,7 @@ have a ImageMagick that is using OpenMP (currently only svn HEAD).  To
 fix this you will need to rebuild ImageMagick, making sure that you
 configure it using --disable-openmp.
 
-See: <http://issues.sxemacs.org/show_bug.cgi?id=104>
+See: <https://issues.sxemacs.org/show_bug.cgi?id=104>
 
 ** Multimedia Goodness
 
@@ -446,7 +457,7 @@ effectively circumvent this issue.
 
 This is a known bug (#13 in our bug database).  At the moment the only
 advise we can give is: do not use sentinels before 22.1.7.
-Also see our bug database at http://issues.sxemacs.org
+Also see our bug database at https://issues.sxemacs.org
 
 *** make-media-stream seems to recognise any file as valid audio
 
@@ -457,6 +468,28 @@ moment.  However, you can perform the additional check yourself if
 you have taglib installed.  Use the included ffi-taglib.el.
 
 
+*** XCreateIC fails at startup
+
+SXEmacs sometimes fails to create the input context with XCreateIC on
+non-C languages.  SXEmacs will include the values of the LANG and
+XMODIFIERS environment variables which influence the behavior of
+XCreateIC.  Failures have been observed with XMODIFIERS=@im=ibus
+
+
+*** Text gets garbled/corrupted with Xorg ATI driver
+
+Some versions of the Xorg ATI driver present display issues where text
+display gets corrupted.  Because of the conservative way SXEmacs
+updates the screen it is more susceptible to these issues than other
+applications.
+
+Some users have reported the problem goes away when using proprietary
+drivers.  CAVEAT EMPTOR: Proprietary drivers have also been reported
+to break other parts of the system, most notabable are bad
+interactions with graphic boot package Plymouth when it asks for
+password for encrypted volumes at boot.
+
+
 * Original XEmacs PROBLEMS File
 ===============================