Cleaning up troubleshooting and other sections in FAQ; need input

After answering various faq-like questions on xemacs-beta I decided to redo the troubleshooting section of the FAQ so it really has everything people should know. In the process I've found some very very old stuff. Some I just terminated with extreme prejudice [e.g. some business about OpenWindows 3.0], but others I would like to get some input before deleting them entirely. ********************************************************* The following used to make extensive reference to 19.14 and 19.15. I fixed it up to remove those, but I don't know whether the resulting question has any relevance. ========================================================== ＠node Q2.1.23, Q2.1.24, Q2.1.22, Installation ＠unnumberedsubsec Q2.1.21: Movemail on Linux does not work Movemail on Linux defaults to using ＠code{.lock} file locking. If this is not appropriate for your system, edit src/s/linux.h and uncomment the line that reads: ＠example #define MAIL_USE_FLOCK ＠end example ＠end quotation ========================================================== Are any of the following still relevant? ========================================================== ＠node Q2.0.8, Q2.0.9, Q2.0.7, Installation ＠unnumberedsubsec Q2.0.8: can't resolve symbol _h_errno You are using the Linux/ELF distribution of XEmacs 19.14, and your ELF libraries are out of date. You have the following options: ＠enumerate ＠item Upgrade your libc to at least 5.2.16 (better is 5.2.18, 5.3.12, or 5.4.10). ＠item Patch the XEmacs binary by replacing all occurrences of ＠samp{_h_errno^＠＠} with ＠iftex ＠* ＠end iftex ＠samp{h_errno^＠＠^＠＠}. Any version of Emacs will suffice. If you don't understand how to do this, don't do it. ＠item Rebuild XEmacs yourself---any working ELF version of libc should be O.K. ＠end enumerate ＠email{hniksic＠(a)xemacs.org, Hrvoje Niksic} writes: ＠quotation Why not use a Perl one-liner for No. 2? ＠example perl -pi -e 's/_h_errno\0/h_errno\0\0/g' \ /usr/local/bin/xemacs-19.14 ＠end example NB: You ＠emph{must} patch ＠file{/usr/local/bin/xemacs-19.14}, and not ＠file{xemacs} because ＠file{xemacs} is a link to ＠file{xemacs-19.14}; the Perl ＠samp{-i} option will cause unwanted side-effects if applied to a symbolic link. ＠end quotation ＠email{steve＠(a)xemacs.org, SL Baur} writes: ＠quotation If you build against a recent libc-5.4 (late enough to have caused problems earlier in the beta cycle) and then run with an earlier version of libc, you get a ＠example $ xemacs xemacs: can't resolve symbol '__malloc_hook' zsh: 7942 segmentation fault (core dumped) xemacs ＠end example (Example binary compiled against libc-5.4.23 and run with libc-5.4.16). The solution is to upgrade to at least libc-5.4.23. Sigh. Drat. ＠end quotation ========================================================== ========================================================== ＠node Q2.0.10, Q2.0.11, Q2.0.9, Installation ＠unnumberedsubsec Q2.0.10: After I run configure I find a core dump, is something wrong? Not necessarily. If you have GNU sed 3.0 you should downgrade it to 2.05. ＠quotation sed 3.0 has been withdrawn from distribution. It has major revisions, which mostly seem to be improvements; but it turns out to have bugs too which cause trouble in some common cases. Tom Lord won't be able to work fixing the bugs until May. So in the mean time, we've decided to withdraw sed 3.0 from distribution and make version 2.05 once again the recommended version. ＠end quotation It has also been observed that the vfork test on Solaris will leave a core dump. ========================================================== ========================================================== ＠node Q2.0.11, Q2.0.12, Q2.0.10, Installation ＠unnumberedsubsec Q2.0.11: XEmacs doesn't resolve hostnames. This is the result of a long-standing problem with SunOS and the fact that stock SunOS systems do not ship with DNS resolver code in libc. ＠email{ckd＠(a)loiosh.kei.com, Christopher Davis} writes: ＠quotation That's correct [The SunOS 4.1.3 precompiled binaries don't do name lookup]. Since Sun figured that everyone used NIS to do name lookups (that DNS thing was apparently only a passing fad, right?), the stock SunOS 4.x systems don't have DNS-based name lookups in libc. This is also why Netscape ships two binaries for SunOS 4.1.x. The best solution is to compile it yourself; the configure script will check to see if you've put DNS in the shared libc and will then proceed to link against the DNS resolver library code. ＠end quotation ========================================================== ========================================================== ＠node Q2.1.4, Q2.1.5, Q2.1.3, Installation ＠unnumberedsubsec Q2.1.11: Translation Table Syntax messages at Startup I get tons of translation table syntax error messages during startup. How do I get rid of them? There are two causes of this problem. The first usually only strikes people using the prebuilt binaries. The culprit in both cases is the file ＠file{XKeysymDB}. ＠itemize ＠bullet ＠item The binary cannot find the ＠file{XKeysymDB} file. The location is hardcoded at compile time so if the system the binary was built on puts it a different place than your system does, you have problems. To fix, set the environment variable ＠code{XKEYSYMDB} to the location of the ＠file{XKeysymDB} file on your system or to the location of the one included with XEmacs which should be at ＠iftex ＠* ＠end iftex ＠file{<xemacs_root_directory>/lib/xemacs-19.16/etc/XKeysymDB}. ＠item The binary is finding the XKeysymDB but it is out-of-date on your system and does not contain the necessary lines. Either ask your system administrator to replace it with the one which comes with XEmacs (which is the stock R6 version and is backwards compatible) or set your ＠code{XKEYSYMDB} variable to the location of XEmacs's described above. ＠end itemize ========================================================== ========================================================== ＠node Q2.1.6, Q2.1.7, Q2.1.5, Installation ＠unnumberedsubsec Q2.1.6: XEmacs cannot connect to my X Terminal! Help! I can not get XEmacs to display on my Envizex X-terminal! Try setting the ＠code{DISPLAY} variable using the numeric IP address of the host you are running XEmacs from. ========================================================== ========================================================== ＠node Q2.1.7, Q2.1.8, Q2.1.6, Installation ＠unnumberedsubsec Q2.1.7: XEmacs just locked up my Linux X server! There have been several reports of the X server locking up under Linux. In all reported cases removing speedo and scaled fonts from the font path corrected the problem. This can be done with the command ＠code{xset}. It is possible that using a font server may also solve the problem. ＠node Q2.1.8, Q2.1.9, Q2.1.7, Installation ＠unnumberedsubsec Q2.1.8: HP Alt key as Meta. How can I make XEmacs recognize the Alt key of my HP workstation as a Meta key? Put the following line into a file and load it with xmodmap(1) before starting XEmacs: ＠example remove Mod1 = Mode_switch ＠end example ========================================================== ========================================================== ＠node Q2.1.13, Q2.1.14, Q2.1.12, Installation ＠unnumberedsubsec Q2.1.13: HP/UX 10.10 and ＠code{create_process} failure. ＠email{Dave.Carrigan＠(a)ipl.ca, Dave Carrigan} writes: ＠quotation With XEmacs 19.13 and HP/UX 10.10, anything that relies on the ＠code{create_process} function fails. This breaks a lot of things (shell-mode, compile, ange-ftp, to name a few). ＠end quotation ＠email{johnson＠(a)dtc.hp.com, Phil Johnson} writes: ＠quotation This is a problem specific to HP-UX 10.10. It only occurs when XEmacs is compiled for shared libraries (the default), so you can work around it by compiling a statically-linked binary (run configure with ＠samp{--dynamic=no}). I'm not sure whether the problem is with a particular shared library or if it's a kernel problem which crept into 10.10. ＠end quotation ＠email{cognot＠(a)ensg.u-nancy.fr, Richard Cognot} writes: ＠quotation I had a few problems with 10.10. Apparently, some of them were solved by forcing a static link of libc (manually). ＠end quotation ========================================================== ========================================================== ＠node Q3.7.5, Q3.7.6, Q3.7.4, Customization ＠unnumberedsubsec Q3.7.5: Why does cut-and-paste not work between XEmacs and a cmdtool? We don't know. It's a bug. There does seem to be a work-around, however. Try running xclipboard first. It appears to fix the problem even if you exit it. (This should be mostly fixed in 19.13, but we haven't yet verified that). ========================================================== Is the following still relevant? If so, is it relevant outside of HP/UX? If so, could someone help me rewrite it to work generally? If not, could someone help me fix it up to the latest HP/UX? ========================================================== ＠node Q2.1.10, Q2.1.11, Q2.1.9, Installation ＠unnumberedsubsec Q2.1.10: Warnings from incorrect key modifiers. The following information comes from the ＠file{PROBLEMS} file that comes with XEmacs. If you're having troubles with HP/UX it is because HP/UX defines the modifiers wrong in X. Here is a shell script to fix the problem; be sure that it is run after VUE configures the X server. ＠example #! /bin/sh xmodmap 2> /dev/null - << EOF keysym Alt_L = Meta_L keysym Alt_R = Meta_R EOF xmodmap - << EOF clear mod1 keysym Mode_switch = NoSymbol add mod1 = Meta_L keysym Meta_R = Mode_switch add mod2 = Mode_switch EOF ＠end example ========================================================== How about the following question regardling TM? TM was once the way to get MIME support for GNUS, VM, etc. but I gather they all do this by default now. And maybe there's a newer version of TM? Therefore, the following should probably get rewritten or deleted [suggestions?]: ========================================================== ＠node Q4.3.1, Q4.3.2, Q4.2.4, Subsystems ＠unnumberedsec 4.3: Other Mail & News ＠unnumberedsubsec Q4.3.1: How can I read and/or compose MIME messages? ＠c Changed June VM supports MIME natively. You probably want to use the Tools for MIME (tm). ＠xref{Q4.3.2}, for details. ＠email{trey＠(a)cs.berkeley.edu, Trey Jackson} has an Emacs & MIME web page at ＠iftex ＠* ＠end iftex ＠uref{http://bmrc.berkeley.edu/~trey/emacs/mime.html}. Another possibility is RMIME. You may find RMIME at ＠iftex ＠* ＠end iftex ＠uref{http://www.cinti.net/~rmoody/rmime/index.html}. ========================================================== ========================================================== ＠node Q4.3.2, Q4.3.3, Q4.3.1, Subsystems ＠unnumberedsubsec Q4.3.2: What is TM and where do I get it? TM stands for ＠dfn{Tools for MIME} and not Tiny MIME. TM integrates with all major XEmacs packages like Gnus (all flavors), VM, MH-E, and mailcrypt. It provides totally transparent and trouble-free MIME support. When appropriate a message will be decoded in place in an XEmacs buffer. TM now comes as a package with XEmacs 19.16 and XEmacs 20.2. TM was written by ＠email{morioka＠(a)jaist.ac.jp, MORIOKA Tomohiko} and ＠email{shuhei-k＠(a)jaist.ac.jp, KOBAYASHI Shuhei}. It is based on the work of ＠email{umerin＠(a)mse.kyutech.ac.jp, UMEDA Masanobu}, the original writer of GNUS. The following information is from the ＠file{README}: ＠dfn{tm} is a MIME package for GNU Emacs. tm has following functions: ＠itemize ＠bullet ＠item MIME style multilingual header. ＠item MIME message viewer (mime/viewer-mode). ＠item MIME message composer (mime/editor-mode). ＠item MIME extenders for mh-e, GNUS, RMAIL and VM. ＠end itemize tm is available from following anonymous ftp sites: ＠itemize ＠bullet ＠comment ＠item ＠uref{ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/} (Japan). ＠comment ＠item ＠uref{ftp://ftp.nis.co.jp/pub/gnu/emacs-lisp/tm/} (Japan). ＠comment ＠c The host above is unknown. ＠comment ＠item ＠uref{ftp://ftp.nisiq.net/pub/gnu/emacs-lisp/tm/} (US). ＠comment ＠item ＠uref{ftp://ftp.miranova.com/pub/gnus/jaist.ac.jp/} (US). ＠item ＠uref{ftp://ftp.unicamp.br/pub/mail/mime/tm/} (Brasil). ＠item ＠uref{ftp://ftp.th-darmstadt.de/pub/editors/GNU-Emacs/lisp/mime/} (Germany). ＠item ＠uref{ftp://ftp.tnt.uni-hannover.de/pub/editors/xemacs/contrib/} (Germany). ＠end itemize Don't let the installation procedure & instructions stop you from trying this package out---it's much simpler than it looks, and once installed, trivial to use. ＠email{youngs＠(a)xemacs.org, Steve Youngs} writes: ＠quotation All the major Emacs Lisp based MUAs (Gnus, MH-E, and VM) all do their own thing when it comes to MIME so you won't need TM to get MIME support in these packages. ＠end quotation ========================================================== ========================================================== ＠node Q4.3.5, Q4.4.1, Q4.3.4, Subsystems ＠unnumberedsubsec Q4.3.5: Where do I find pstogif (required by tm)? pstogif is part of the latex2html package. ＠email{vroonhof＠(a)math.ethz.ch, Jan Vroonhof} writes: latex2html is best found at the CTAN hosts and their mirrors in ＠iftex ＠* ＠end iftex ＠file{tex-archive/support/latex2html}. CTAN hosts are: ＠itemize ＠bullet ＠item ＠uref{ftp://ftp.tex.ac.uk/tex-archive/support/latex2html/}. ＠item ＠uref{ftp://ftp.dante.de/tex-archive/support/latex2html/}. ＠end itemize There is a good mirror at ftp.cdrom.com; ＠iftex ＠* ＠end iftex ＠uref{ftp://ftp.cdrom.com/pub/tex/ctan/support/latex2html/}. ========================================================== How about the following question about AUC TeX and ftpmail? This is clearly out-of-date. Could someone give an up-to-date summary? Does ftpmail(a)decwrl.dec.com exist at all any more? ========================================================== ＠node Q4.7.1, Q4.7.2, Q4.6.1, Subsystems ＠unnumberedsec 4.7: Other Unbundled Packages ＠unnumberedsubsec Q4.7.1: What is AUC TeX? Where do you get it? AUC TeX is a package written by ＠email{abraham＠(a)dina.kvl.dk, Per Abrahamsen}. Starting with XEmacs 19.16, AUC TeX is bundled with XEmacs. The following information is from the ＠file{README} and website. AUC TeX is an extensible package that supports writing and formatting TeX files for most variants of GNU Emacs. Many different macro packages are supported, including AMS TeX, LaTeX, and TeXinfo. The most recent version is always available by ftp at ＠iftex ＠* ＠end iftex ＠uref{ftp://sunsite.dk/packages/auctex/auctex.tar.gz}. In case you don't have access to anonymous ftp, you can get it by an email request to ＠email{ftpmail＠(a)decwrl.dec.com}. WWW users may want to check out the AUC TeX page at ＠iftex ＠* ＠end iftex ＠uref{http://sunsite.dk/auctex/}. ==========================================================