                                                3 October 1999.  SMS.

                        Wget for VMS
                        ============


      Disclaimer
      ----------

   No claims of any sort are made herein.  The real Wget author is
probably unaware of 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
      ----

   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.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.3b".


   Files which should be modified for VMS:

      FTP-LS.C          Can not handle VMS DIRECTORY output from an FTP
                        server.


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

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

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

      SET DEFAULT [.WGET-1_5_3B.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".

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

   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)
