An Emacs interface to w3m
Emacs Lisp Groff Shell
Pull request Compare This branch is even with emacsorphanage:master.
Permalink
Failed to load latest commit information.
attic prevent some directories from being added to the load-path Feb 27, 2013
doc prevent some directories from being added to the load-path Feb 27, 2013
icons * icons/*.png, icons30/*.png: New files. Jan 26, 2007
icons30 * icons/*.png, icons30/*.png: New files. Jan 26, 2007
patches * patches/README: Update. Dec 8, 2006
shimbun Introduce w3m-flet Jul 19, 2012
.cvsignore * w3mhack.el: Create w3m-load.el. Apr 27, 2004
BUGS.ja Update. Dec 8, 2006
COPYING Update FSF's address in GPL notices. Jul 5, 2005
ChangeLog w3m-search.el (w3m-search-do-search): Save history position Dec 25, 2012
ChangeLog.1 Follow Emacs's change: Feb 28, 2012
Makefile.in Respect DESTDIR Jan 6, 2012
NEWS Update. Feb 6, 2008
NEWS.ja Update. Feb 6, 2008
README * README: Add information about how to create `configure' script. May 20, 2008
README.ja * README: Add information about how to create `configure' script. May 20, 2008
aclocal.m4 Respect DESTDIR Jan 6, 2012
bookmark-w3m.el bookmark-w3m.el (bookmark-make-record-function): Don't bind it to any… Oct 21, 2010
configure.in Check for dvipdfmx and texi2pdf. Jan 16, 2006
install-sh Cosmetic fixes. Nov 15, 2002
mew-w3m.el * w3m-bug.el (report-emacs-w3m-bug) Jan 13, 2010
mime-w3m.el Call w3m-history-store-position here and there; replace labels and flet Jul 18, 2012
mkinstalldirs * Makefile.in (install-lisp, install-icons, install-icons30): Quote d… Feb 6, 2008
octet.el Replace let-bindings of buffer-read-only to nil with inhibit-read-onl… Aug 18, 2010
w3m-antenna.el (w3m-antenna-check-rss): Ignore future entries to display site Nov 6, 2009
w3m-bookmark.el w3m-bookmark.el (w3m-bookmark-buffer): Use (0 0) as the Unix epoch Oct 10, 2012
w3m-bug.el * w3m-bug.el (report-emacs-w3m-bug) Jan 13, 2010
w3m-ccl.el w3m-ccl.el (charset-id): Work for old Emacsen. Jul 13, 2011
w3m-cookie.el 2010-05-24 Fedor Khod'kov <fedor76@istra.ru> May 24, 2010
w3m-dtree.el Merge no-defsubst branch. May 20, 2009
w3m-ems.el w3m-ems.el (w3m-create-image): Fix last change. Dec 17, 2012
w3m-favicon.el aclocal.m4 (AC_EMACS_LISP): Simplify. Dec 5, 2011
w3m-fb.el Bind w3m-delete-buffer, w3m-fb-frame-parameter, w3m-list-buffers, Sep 20, 2006
w3m-filter.el w3m-filter.el (w3m-filter-configuration): Work around a widget bug Oct 18, 2012
w3m-form.el Abolish w3m-switch-to-buffer Feb 13, 2012
w3m-hist.el w3m.el (w3m-about-header): Show info of image where point stays. Feb 10, 2012
w3m-image.el (w3m-imagick-convert-program-available-p): If someone Sep 2, 2009
w3m-lnum.el w3m-util.el (w3m-force-mode-line-update): New alias. Jun 4, 2012
w3m-mail.el w3m-util.el (w3m-make-local-hook): New function. Oct 7, 2010
w3m-namazu.el Merge no-defsubst branch. May 20, 2009
w3m-perldoc.el Fix expressions of the copyright notices. Oct 17, 2007
w3m-proc.el Call w3m-history-store-position here and there; replace labels and flet Jul 18, 2012
w3m-rss.el Call w3m-history-store-position here and there; replace labels and flet Jul 18, 2012
w3m-search.el w3m-search.el (w3m-search-do-search): Save history position Dec 25, 2012
w3m-session.el Abolish w3m-switch-to-buffer Feb 13, 2012
w3m-symbol.el * w3m.el (w3m-language): Allow the value like "Japanese (UTF-8)" of Jan 9, 2009
w3m-tabmenu.el Abolish w3m-switch-to-buffer Feb 13, 2012
w3m-ucs.el Fix expressions of the copyright notices. Oct 17, 2007
w3m-util.el w3m-util.el (w3m-flet): Rewrite it using cl-letf Dec 5, 2012
w3m-weather.el Call w3m-history-store-position here and there; replace labels and flet Jul 18, 2012
w3m-xmas.el w3m-ems.el (w3m-create-image): Fix last change. Dec 17, 2012
w3m.el w3m-ems.el (w3m-create-image): Fix last change. Dec 17, 2012
w3mhack.el Call w3m-history-store-position here and there; replace labels and flet Jul 18, 2012

README

       This package contains emacs-w3m, an Emacs interface to w3m

1. Introduction

   w3m is a pager with WWW capability, developed by Akinori ITO.
   Although it is a pager, it can be used as a text-mode WWW browser.
   Visit the official w3m page for details:

       http://w3m.sourceforge.net/

   Emacs-w3m is a simple Emacs interface to w3m.  Its official web page
   is available at:

        http://emacs-w3m.namazu.org/

   You can find more detailed version of the following explanations
   in the form of HTML'ized info:

        http://emacs-w3m.namazu.org/info/


2. Requirements

   Check whether your system meets the following requirements before
   installing emacs-w3m.

   Emacs-w3m requires the latest version of w3m (version 0.3.1 and
   later).  Since this program is much sensitive to the version of w3m,
   you should confirm it if you already have w3m installed.  And we
   recommend you visit the official w3m web page to check whether a
   newer version of w3m has been released:

       http://prdownloads.sourceforge.net/w3m/

   If you want to use the shimbun library which is included in the
   emacs-w3m distribution, you have to install FLIM package.  For more
   detail about the shimbun library, see "Shimbun Library" section in
   Info.

   a) Emacs 21.x
      No additional packages are required.

   b) XEmacs 21.x
      First of all, you should note that emacs-w3m supports only XEmacs
      21.4.17 and later and XEmacs 21.5-b19 and later.  In addition, you
      need to have installed the latest xemacs-base package including
      the timer-funcs.el module.

      APEL package is required.  Use the latest one available in:

        http://kanji.zinbun.kyoto-u.ac.jp/~tomo/lemi/dist/apel/

      Note: You must not use the APEL XEmacs package (which is contained
       in SUMO) of the versions older than 1.32.  If you have already
       installed such a version, you should upgrade it or replace it
       with APEL which is linked above (you can also use the same
       directives in order to newly install APEL):

          % rm -fr /usr/local/lib/xemacs/xemacs-packages/lisp/apel
          % cd apel-10.7
          % make install-package XEMACS=xemacs-21.4.x\
            PACKAGEDIR=/usr/local/lib/xemacs/xemacs-packages

      If you are using XEmacs 21.x, you should install the "gifsicle"
      program.  There is a known bug in all XEmacs 21.x series that
      it won't let it display optimized animated gifs correctly or may
      make it crash when some kind of an interlaced gif image is
      displayed.  Emacs-w3m uses the "gifsicle" program to convert gif
      data in order to make it possible to be handled by XEmacs 21.x.
      It is available at:

          http://www.lcdf.org/gifsicle/

   c) Emacs 20.x, Emacs 19.34 (including Mule 2.3)
      Emacs-w3m no longer supports those Emacs versions.


3. Installation

3.1. Installing emacs-w3m on UNIX-like systems

     At the first, run the `configure' script.

         % ./configure

     If you can't find the `configure' script, rus the `autoconf'
     command. It create this script.

         % autoconf

     Important notice to the Gnus users:
     ===================================
     If the various versions of Gnusae are installed in your system (it
     is likely that there are the released version and the development
     version of Gnusae), make sure that priority is given to the
     directory where the gnus.elc file which you use is installed in the
     load-path.  To do that, use the --with-addpath option as follows:

         % ./configure --with-addpath=/usr/local/share/emacs/site-lisp/gnus

     If you've installed APEL, FLIM or something in non-standard
     directories other than the default `load-path', you must specify
     them using the --with-addpath option as follows (you may also
     include the Gnus directory being separated with `:' in it):

         % ./configure --with-addpath=/opt/share/apel:/opt/share/flim

     Next, execute the following commands to install emacs-w3m to an
     appropriate directory.

         % make
         % make install

     If you are using Emacs 21 or XEmacs, you had better install icon
     image files.  To do this:

         % make install-icons
     or
         % make install-icons30

     The latter will install the slightly larger icons with characters.

     You can also install emacs-w3m as an XEmacs package using
     `make install-package' instead of `make install'.

         % make
         % make install-package

     In this case, you don't have to execute `make install-icons' nor
     `make install-icons30'.

     The info files will also be installed by `make install' or
     `make install-package'.

3.2. Installing on non-UNIX-like systems

     If you cannot execute the `configure' script on your system, or if
     no `make' command is available, execute the following command:

         % emacs -batch -q -no-site-file -l w3mhack.el NONE -f w3mhack-nonunix-install

     If APEL, FLIM (or any other library) aren't installed in the
     ordinary places, the installer will leave them out.  In such a
     case, it is necessary to tell those places to the installer as
     shown below:

         % emacs -batch -q -no-site-file -l w3mhack.el //c/share/apel://c/share/flim -f w3mhack-nonunix-install


4. Configuration

   We recommend using the ~/.emacs-w3m file (which is the default
   value of `w3m-init-file') when you twiddle some variables of
   emacs-w3m.  This file is similar to ~/.emacs, but is read when
   emacs-w3m starts.  However, note that there are options which
   shouldn't be put there, for example, `w3m-command'.

4.1. Essential Configuration

     Put this line into your ~/.emacs file:

         (require 'w3m-load)

     You have nothing to do if you have emacs-w3m installed as an XEmacs
     package.

4.2. mime-w3m.el

     In order to handle text/html part with emacs-w3m under SEMI MUAs
     such as T-gnus and Wanderlust, you have to put the following line
     in your ~/.emacs file:

         (require 'mime-w3m)

4.3. Proxy Gateway

     There are some ways to do this, one is to set the "http_proxy"
     environment variable globally in the shell something like:

         setenv http_proxy http://proxy.hogege.com:8000/

     Another way is to customize the `w3m-command-arguments' variable to
     add the options "-o" and "http_proxy=http://PROXY_SERVER_NAME:PORT/".
     This can also be done in your ~/.emacs-w3m file as shown below:

        (setq w3m-command-arguments
              (nconc w3m-command-arguments
                     '("-o" "http_proxy=http://proxy.hogege.com:8000/")))

     To specify `no-proxy' hosts, which shouldn't be connected to with
     proxy gateways, you can set the "no_proxy" environment variable
     with the comma separated host names, or set the
     `w3m-no-proxy-domains' variable with a list of domain names (not
     host names) as follows:

         (setq w3m-no-proxy-domains '("local.com" "neighbor.com"))

     See also the documentation for the `w3m-command-arguments-alist'
     variable to use regexps to specify the `no-proxy' hosts.


5. Contact the emacs-w3m community

   To contact the emacs-w3m community for reporting bugs, contributing
   improvements, making a suggestion or asking us for help, send a mail
   to the open list <emacs-w3m@namazu.org>.  You can also send a bug
   report using the `report-emacs-w3m-bug' command or the `C-c C-b' key
   if you have set the `mail-user-agent' variable that will work
   properly.


6. Acknowledgments

   w3m, which is an essential part of this package, was written by
   Akinori ITO.  We'd like to address our thanks to him for his nice
   work.


7. Related Information

   [1] APEL
       It can be downloaded from:
       http://kanji.zinbun.kyoto-u.ac.jp/~tomo/lemi/dist/apel/

   [2] FLIM
       It can be downloaded from:
       http://kanji.zinbun.kyoto-u.ac.jp/~tomo/lemi/dist/flim/flim-1.14/
       Before installing it, it is necessary to install APEL.

   [3] gifsicle
       It can be downloaded from: http://www.lcdf.org/gifsicle/


Local Variables:
mode: indented-text
mode: outline-minor
outline-regexp: "[0-9]\\.[0-9]\\.[0-9]\\.\\|[0-9]\\.[0-9]\\.\\|[0-9]\\."
coding: ascii
fill-column: 72
End: