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