                                                4 December 1999.  SMS.

                     Wget 1.5.3 for VMS (1.5.3c)
                     ===========================

------------------------------------------------------------------------

      Disclaimer
      ----------

   No claims of any sort are made herein.  The real Wget author is
probably unaware of (or indifferent to) this effort.  Any suggestions
for improving the code in the VMS-specific sections are welcome, but low
expectations are more realistic than high ones.

------------------------------------------------------------------------

      Description
      -----------

   This note accompanies a quick VMS port of Wget version 1.5.3, a GNU
free network utility to retrieve files from the World Wide Web using
HTTP and FTP.

   Built and tested (slightly) using Alpha VMS V7.2, DEC C V6.0-001, and
TCPIP V5.0.

------------------------------------------------------------------------

      News
      ----

   Version 1.5.3c  1999-12-03
   --------------------------

- Changed FTP-LS.C:
   - Automatically senses and works with VMS DIRECTORY listings (FTP
     DIR).  This was tested with fewer than all VMS FTP servers.  Any
     problem report should include a sample FTP DIR listing and/or
     access information for the troublesome FTP server.
   - Assumes that times in the FTP DIR listing are local time, not UTC.
   - Adjusts local file times by the VMS logical name (or environment
     variable) "WGET_TIMEZONE_DIFFERENTIAL", the (signed) number of
     seconds to add to the remote file time to get the local file time. 
     For example, a user in Minnesota (US Central time) fetching files
     from an FTP server in the UK could shift the reported file times by
     six hours with "DEFINE WGET_TIMEZONE_DIFFERENTIAL -21600" before
     running WGET.

- Redistributed the labor of UTC-to-local time conversions.  (HTTP.C and
  VMS.C)

- Added "#define OS_TYPE "VMS" to CONFIG.H (for use in MAIN.C when
  "DEBUG" is defined in CONFIG.H).

- Updated DESCRIP.MMS.  Fixed a problem creating a new CONFIG.H from
  CONFIG.H_VMS.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

   Version 1.5.3b  1999-10-03
   ---------------------------

   Since the first non-release near 19-AUG-1999, the following changes
have been made:

- Late changes to INIT.C and NETRC.C have been included in the kit.

- HTTP.C was changed to avoid ACCVIO when the logical name
  SYS$TIMEZONE_DIFFERENTIAL or SYS$TIMEZONE_DAYLIGHT_SAVING was not
  defined.

- DESCRIP.MMS has been enhanced to add a "CLEAN" target, to specify
  explicitly the dependencies for the object files, to create
  [.SRC]CONFIG.H, if necessary, and to accomodate an optional macro,
  "DBG", which adds "/DEBUG" options to the compiler and linker
  option lists.  Use MMS (or MMK) option "/MACRO = DBG" to build the
  debug executable.

- The program version identifier was changed from "1.5.3" to
  "1.5.3b".

- This document was updated.

------------------------------------------------------------------------

      Home source URL
      ---------------
   
ftp://gnjilux.cc.fer.hr/pub/unix/util/wget/wget.tar.gz

------------------------------------------------------------------------

      Changes to source files (all in [.SRC])
      ---------------------------------------

   Files new for VMS:

      CONFIG.H_VMS      VMS-specific CONFIG.H.
      DESCRIP.MMS       MMS or MMK description ("make") file.
      VMS.C             "utime()" replacement function.
      VMS.H             Replacement for <utime.h>.  Declarations of
                        "utimbuf" structure and "utime()" function
                        prototype.
      WGET.OPT          LINK options file.


   Files modified for VMS:

      CMPT.C            Made tidy for DEC C.
      CONNECT.C         Made tidy for DEC C.
      FTP-LS.C          Added support for VMS FTP servers.  Fixed file
                        times.  Added "WGET_TIMEZONE_DIFFERENTIAL", for
                        file time adjustment.
      FTP.C             Made tidy for DEC C.
      FTP-BASIC.C       Made tidy for DEC C.
      HTTP.C            Made tidy for DEC C.  Added VMS code for
                        UTC-local/DST time conversion.
      INIT.C            Changed to use "SYS$LOGIN:.WGETRC" as the name
                        of the initialization file.  Changed to open
                        this file in text mode, not binary.  
      NETRC.C           Changed to use "SYS$LOGIN:.NETRC" as the name of
                        the user name and password file.
      RBUF.C            Made tidy for DEC C.
      URL.C             Added code to replace unacceptable dots (".")
                        with underscores ("_") in URL-derived file
                        specifications.
      UTILS.C           Added VMS-specific code to work around the lack
                        of "fork()" and symbolic links.
      VERSION.C         Changed version from "1.5.3" to "1.5.3c".

------------------------------------------------------------------------

      Instructions
      ------------

   Extract the files from the distribution kit.  The kit includes an
Alpha executable, "[.WGET-1_5_3C.SRC]WGET.EXE".

   To build from the source (using MMS or MMK, MMS shown):

      SET DEFAULT [.WGET-1_5_3C.SRC]
      MMS CLEAN  ! Deletes all object and executable files.
      MMS        ! Copies CONFIG.H_VMS to CONFIG.H, compiles the source
                 ! files, and links the executable, WGET.EXE.
                 ! Use "MMS /MACRO = DBG" to build the debug executable.

   Set the symbol for the foreign command:

      WGET :== $ {actual_device_and_directory}WGET.EXE

   Try to read the original documentation to learn how to use it.  The
principal differences in this VMS adaptation are:

   "-b" ("background") has no effect.  (It uses "fork()".)

   Excess dots are replaced by underscores in URL-derived file
specifications.  For example, on a UNIX system, the URL
"ftp://ftp.anywhere.org/x.y.z/a.b.c" could produce the local file
"ftp.anywhere.org/x.y.z/a.b.c".  With this VMS adaptation, the local
file would be "[.FTP_ANYWHERE_ORG.X_Y_Z]A_B.C".

------------------------------------------------------------------------

   The accompanying source kit suffers from storage on an ODS2 file
system, which does not preserve case or allow multiple dots in a file
name.  Building this kit should work on VMS,  but it may be expected to
fail on other systems.  Commands like the following should restore the
original names (on a UNIX system).

   mv  authors                   AUTHORS
   mv  changelog                 ChangeLog
   mv  copying                   COPYING
   mv  install                   INSTALL
   mv  machines                  MACHINES
   mv  mailing-list              MAILING-LIST
   mv  makefile.in               Makefile.in
   mv  news                      NEWS
   mv  readme                    README
   mv  todo                      TODO

   mv  doc/changelog             doc/ChangeLog
   mv  doc/makefile.in           doc/Makefile.in

   mv  po/makefile.in_in         po/Makefile.in.in
   mv  po/potfiles.in            po/POTFILES.in
   mv  po/pt_br.gmo              po/pt_BR.gmo
   mv  po/pt_br.po               po/pt_BR.po

   mv  src/changelog             src/ChangeLog
   mv  src/config.h_in           src/config.h.in
   mv  src/makefile.in           src/Makefile.in
   mv  src/tags                  src/TAGS

   mv  util/makefile.in          util/Makefile.in
   mv  util/readme               util/README

   mv  windows/readme            windows/README 
   mv  windows/config.h_ms       windows/config.h.ms 
   mv  windows/makefile.doc      windows/Makefile.doc 
   mv  windows/config.h_bor      windows/config.h.bor 
   mv  windows/makefile.src      windows/Makefile.src 
   mv  windows/makefile.top      windows/Makefile.top 
   mv  windows/makefile.watcom   windows/Makefile.watcom 
   mv  windows/makefile.top_bor  windows/Makefile.top.bor 
   mv  windows/makefile.src_bor  windows/Makefile.src.bor 

------------------------------------------------------------------------

   Steven M. Schweda               (+1) 651-645-9249  (voice, home)
   1630 Marshall Avenue  #8        (+1) 612-754-2636  (voice, work)
   Saint Paul  MN  55104-6225      (+1) 612-754-6302  (facsimile, work)
   sms@antinode.org                sms@provis.com  (work)
