        Emacs-wget README  ($Date: 2002/11/29 07:35:08 $)

This package contains programs to call wget from Emacs.

1. Introduction

   GNU Wget is a free software package for retrieving files using HTTP, HTTPS
   and FTP, the most widely-used Internet protocols. It is a non-interactive
   command line tool.  More information, see wget web page:

   http://www.gnu.org/software/wget/

   Wget is originally written by Hrvoje Niksic.


   Emacs-wget provides an interface of GNU wget for Emacs.  You can call
   it from web browser on Emacs, like Emacs/W3 or emacs-w3m.

   The latest emacs-wget is available at:

   http://pop-club.hp.infoseek.co.jp/emacs/emacs-wget/


2. Requirements

   GNU Emacs and GNU wget.

   Emacs: http://www.gnu.org/software/emacs/
   Wget:  http://www.gnu.org/software/wget/


3. Installation

   a.) Put all *.el files into your load-path directory.


   b.) Put following expressions into your .emacs file.

        (autoload 'wget "wget" "wget interface for Emacs." t)
        (autoload 'wget-web-page "wget" "wget interface to download whole web page." t)


   c.) In case using with Web browser on Emacs:

   c-1.) With emacs-w3m, put the following code into your .emacs:

        (load "w3m-wget")

   c-2.) With Emacs/W3, put the following code into your .emacs:

        (autoload 'w3-wget "w3-wget" "wget interface for Emacs/W3." t)


   d) If wget version is 1.7 or less, put the following code into your .emacs:

        (setq wget-basic-options '("-v"))


   e) When you write your .wgetrc:

   e-1.) quiet = on

         Emacs-wget will fail to download.  Put the following into your .emacs:

        (setq wget-basic-options (cons "-equiet=off" wget-basic-options))

   e-2.) dir_prefix = PATH/TO/DOWNLOAD

         Variable wget-download-directory will be ignored.  Put the
         following into your .emacs:

        (setq wget-basic-options (cons "-P." wget-basic-options))

   e-3.) timestamping = on
         mirror = on  (mirror=on automatically sets timestamping=on)

         These options conflict with -nc option.  If your wget-default-options
         or wget-ftp-default-options have -nc option, get rid of it.

   e-4.) logfile = log

         *wget* buffer will appear but show no information, because the
         output from wget is robbed by the 'log' file.  I don't have
         good idea, except not displying surd *wget* buffer:

	(setq wget-process-buffer nil)


   f) If the system can not search wget command, tell emacs where to
      find it.

        (setq wget-command "C:/cygwin/bin/wget")


4. Running with...

   (emacs-version)               wget -V
   ---------------               -------
    20.7 (Meadow 1.15)            1.8.2 (cygwin)
    21.2.50 (CVS)                 1.7
    21.3.50 (CVS)                 1.8.1
    21.3.50 (CVS)                 1.8.2

   If you find emacs-wget work with other environment above, please tell
   me <ataka@milk.freemail.ne.jp>.


5. Contact address

   E-mail to <ataka@milk.freemail.ne.jp>.
   Any information, bug-report, request, comments, etc... are welcome.

   If you send me a bug-report, please write your wget version, too.

   I don't use emacs-wget with Emacs/W3, so please give me an
   information about Emacs/w3 and emacs-wget.


6. Acknowledgments

   This program shall never see the light without GNU wget, developer
   Hrvoje Niksic, and other wget contributors.  Thanks to great program.

   Great thanks to Takayuki Arakawa for his words, helps, and tests.
   Without him, it will take long time to develop this package.

   Yoichi NAKAYAMA <yoichi@eken.phys.nagoya-u.ac.jp> maintains
   emacs-wget package in FreeBSD ports collection.

   Thanks to:

   Mitsugu SAKAMOTO <mitsugu@argv.org>
          Reported unsupported functions on Meadow-pre1.15
	  (window-text-height, replace-regexp-in-string).
   TSURUDA Naoki <tsuru@yokohama.office.ne.jp>
          Reported bug running on Meadow-1.15.
	  Reported arguments order problem when using with wget-1.8.2 (cygwin).
   KOSEKI Yoshinori <kose@yk.NetLaputa.ne.jp>
          Suggestion for load timing of w3m-wget.el.
   SHINYA Akihiko <shinya@sonicteam.com>
          Reported problem when setting .wgetrc
	  (quiet, timestamping, mirror, dir_prefix, and logfile).



Local Variables:
mode: indented-text
fill-column: 72
End:
