Runtime
-------

   * Q2.1  The options menu is ugly under Emacs 19

     In Emacs 19, Emacs/W3 uses the 'easymenu' package to define menus.
     Unfortunately, this package does not show the current state of a
     boolean menu entry, it just shows as 'Toggle xxxx'.

     This feature-lack will be fixed in Emacs 19.35 or Emacs 20.1 when
     they are released.

   * Q2.2  Animated GIFs cause XEmacs 19.14 or 20.0 to crash.

     There was a bug in the GIF decoding routines in XEmacs 19.14 and
     20.0 - please update to XEmacs 19.15 or 20.1 respectively.

   * Q2.3  I get an error when starting up about custom-declare-group

     This usually means you compiled Emacs/W3 in an emacs that could
     not find the 'custom' package (or found an old version), but you
     are running it in an emacs that finds the new one.  This is
     usually the case if you have a recent version of GNUS installed in
     a non-standard place.

     Make sure that you can load the custom library when compiling
     emacs.  Set the environment variable WIDGETDIR to where your
     custom library lives (ie: ~/lisp/gnus/lisp), or rerun configure
     with the '-with-custom=/full/path/to/custom/lisp/' command line
     argument and then remake with a 'make clean all'.

   * Q2.4  It is incredibly slow under OS/2

     This appears to be a problem with how fonts are looked up.  Thanks
     to chang@wsu.edu for this analysis.

     In OS/2, the font name default to forms like

          "-*-Courier-medium-r-normal--*-100-*-*-m-*-cp850" ......
          or
          "10.Courier"

     In these two cases, font detection fails because this does not
     match x-font-regexp.

     To solve this, set the default font as
     "-*-Courier-medium-r-normal-*-100-*-*-m-*-cp850-1"

   * Q2.5  How do I make emacs scroll the window horizontally when
     moving?

     In XEmacs, you should simply put something like this in your .emacs
     file:

             (add-hook 'w3-mode-hook '(lambda () (auto-show-mode 1)))

     Under Emacs 19, there are a variety of different packages that
     provide this functionality.  The one I have seen used the most is
     'hscroll.el', from
     `http://reality.sgi.com/wmesard/ftp/emacs/hscroll.el' - to turn it
     on, add this to your .emacs file:

             (autoload 'turn-on-hscroll "hscroll" nil t)
             (add-hook 'w3-mode-hook 'turn-on-hscroll)

   * Q2.6  I like being warned about invalid HTML on my own pages, but
     how       can I make Emacs/W3 stop telling me almost everything on
     the Web       is invalid?

     Snide answer: Make everyone start writing valid HTML pages. :)

     Real answer: You can use the file preparation hook, which is run
     before any parsing is done.  Something like this should work.

          (defun my-w3-file-prepare-hook ()
            (make-local-variable 'w3-debug-html)
            (setq w3-debug-html
                (if (or (string= (url-type url-current-object) "file")
                        (string-match ".*\\.some\\.domain\\.name"
                                      (or (url-host url-current-object) "")))
                    'style
                  nil)))
          (add-hook 'w3-file-prepare-hook 'my-w3-file-prepare-hook)
     This will turn on stylistic warnings for any local HTML files or
     files loaded from the `*.some.domain.name' domain.

   * Q2.7  I get an error restarting Emacs after using the preferences
     menu       in Emacs/W3:       `Symbol's function definition is
     void: custom-set-variables'

     Typically this happens if you are running GNU Emacs 19.  Because
     the custom libraries are not bundled with Emacs, you need to make
     sure that you load it from within your .emacs file.   Place the
     following line before any of the calls to `custom-set-variables':

          (require 'custom)

   * Q2.8  When using Emacs 20.x, a \201 character appears in the buffer
          before every character above ASCII 127?

     You should install the LEIM package and put the following lines in
     your .emacs file:

          (set-language-environment 'Latin-1)
          (standard-display-european t 'iso-latin-1)

     LEIM packages for Emacs 20.x are located at
     `ftp://prep.ai.mit.edu/pub/gnu/', filename is `leim-XX.Y.tar.gz',
     where XX.Y matches the Emacs version you are currently running.

   * Q2.9  All my FTP directory listings show up as HTML!  I HATE THAT!

     This will happen if you are going through a web-based proxy
     server.  To use the normal ftp support that Emacs provides, you
     will need to set up the no-proxy section of your proxy services to
     not include any ftp traffic  See Proxy Gateways: (w3)Proxy
     Gateways.  You must then also configure Ange-FTP or EFS to know
     about your specific proxy setup.

     After all this pain and anguish, you will see your FTP directories
     in dired as the gods intended.

   * Q2.10 Why can't I choose an option in an HTML form using the
     minibuffer       instead of the #%!@ing 'widget choose' buffer?

     This is in the hands of the widget library.  Thankfully, there is a
     way to change this behaviour.  Set the variable
     `widget-menu-minibuffer-flag' to `t' in your `~/.emacs' file, and
     you will get the expected behaviour.