B                                                 18 May 2004.  SMS.  0                      Wget 1.9.1 for VMS (1.9.1a)0                      ===========================  H ------------------------------------------------------------------------         Disclaimer       ----------  H    No claims of any sort are made herein.  The main Wget developers seemF indifferent to this effort.  Any suggestions for improving the code inD the VMS-specific sections are welcome, but low expectations are more realistic than high ones.   H ------------------------------------------------------------------------         Description        -----------   F    This note accompanies a quick VMS port of Wget version 1.9.1, a GNUD free network utility to retrieve files from the World Wide Web usingH HTTP and FTP.  The most obvious features seem to work, but many have not been tested.  5    Built and tested (slightly) in these environments:   ; OpenVMS Alpha V7.3-1, Compaq C V6.5-001, TCPIP V5.3 - ECO 2   9 OpenVMS IA64 V8.1, hp C X7.1-024, TCPIP T5.5.  (Woo-hoo.)   0 OpenVMS VAX V7.3, Compaq C V6.4-005, TCPIP V5.1.  H ------------------------------------------------------------------------  
       News
       ----      Version 1.9.1a  2004-04-28     --------------------------   , - Changes to VMS-WGET.COM since Wget 1.5.3h:F    - A separate LIST command-line option now controls compiler listingF      files.  The DBG option no longer implies compiler listing files. D      The LIST option also generates a link map with cross-reference.*    - The DBG option may actually work now.)    - Added support for IA64 architecture. + - Changes to DESCRIP.MMS since Wget 1.5.3h: H    - Compiler listing files (.LIS) and link maps (.MAP) are now put intoF      the system-specific directory with the corresponding object files?      (.OBJ), namely, [.SRC.ALPHA], [.SRC.IA64], or [.SRC.VAX].  A      Previously, they were put into the source directory ([.SRC])       itself.6    - CLEAN target now deletes any .LIS and .MAP files.1    - New HELP target creates a Wget help library. A    - The OS_TYPE macro is now defined, including the VMS version. C    - No more complaints like "%MMS-W-MBREDEFILL, Illegal attempt to 5      redefine macro 'CFLAGS'" on old versions of MMS. D    - A separate LIST macro now controls compiler listing files.  The8      DBG macro no longer implies compiler listing files.'    - New support for IA64 architecture. D - Built-in initialization of some DECC$* run-time options on non-VAXG   systems.  Currently this behavior is compiled in, so any changes must H   be made in the VMS.C source file.  These changes have no effect on VAXA   (or older Alpha) systems where the OS and C run-time support is 	   absent. H    - Command-line case preservation.  Wget for VMS enables the following      DECC$* run-time option:         DECC$ARGV_PARSE_STYLE 8      With extended command parsing enabled ("SET PROCESSE      /PARSE_STYLE = EXTENDED"), command-line case is preserved.  This E      obviates quoting case-sensitive option switches, URLs, and other       parameters.H    - Extended file names on ODS5 file systems.  Wget for VMS enables the'      following DECC$* run-time options:          DECC$EFS_CASE_PRESERVE         DECC$EFS_CHARSET@      Thus, if an OSD5 file system is used as the destination forG      downloaded files, multiple dots will be permitted and case will be G      preserved in file names.  If an ODS2 file system is used, the same D      character substitutions will be made as in Wget 1.5.3h, namely,;      "." -> "_" (where needed), "~" -> "-", and "@" -> "$".   H ------------------------------------------------------------------------  -       Changes to source files (all in [.SRC]) -       ---------------------------------------       Files new for VMS:   /       CONFIG.H_VMS       VMS-specific CONFIG.H.   >       DESCRIP.MMS        MMK or MMS description ("make") file.  G       VMS-WGET.COM       DCL procedure to build the executable from the D                          source, using MMK or MMS (and DESCRIP.MMS).  @       VMS.C              Various VMS-specific code: DEC run-time>                          initialization, ODS2-ODS5 file systemH                          detection, ODS2 file name adjustment, "utime()"G                          replacement function, and for VMS before V7.0, :                          "getpwuid()" and "localtime_r()".  H       VMS.H              VMS-specific header file.  For VMS C RTL beforeH                          V7.3, replacement for <utime.h>.  For VMS C RTL?                          before V7.0, replacement for <pwd.h>.  9                          Declarations of replacement data E                          types/structures and function prototypes for                           VMS.C.   =       VMS_IP.H           IP software type-specific "#include" 5                          directives.  Used by HOST.C.   %       VMS_NOTES.TXT      These notes.   +       WGET.OPT           LINK options file.   C       WGET_MULTINET.OPT  LINK options file supplement for Multinet.         Files modified for VMS:  H       CONVERT.C         Changed to use "_orig" instead of ".orig" as the:                         file name suffix used for the "-K"6                         ("--backup-converted") option.  C       COOKIES.C         Fixed %CC-I-QUESTCOMPARE1 with a type cast. G                         Fixed %CC-W-LONGEXTERN by changing 33-character C                         symbol cookie_jar_generate_cookie_header to 7                         cookie_jar_generate_cookie_hdr.   D       COOKIES.H         Changed cookie_jar_generate_cookie_header toC                         cookie_jar_generate_cookie_hdr (COOKIES.C).   F       FTP.C             Changed to eliminate a spurious -debug messageE                         ("Unrecognized permissions for <directory>"). E                         Changed to eliminate spurious complaints when C                         recursive downloads hit an empty directory.   H       FTP-LS.C          Fixed %CC-W-OUTTYPELEN from attempt to fprintf()A                         an int (u->port) using a "%hu" conversion 5                         specifier.  It now uses "%d". C                         Changed to open the ".listing" file in text )                         mode, not binary. D                         Changed VMS FTP DIR-parsing code to tolerate?                         more variability (leading blank lines). B                         Added support for the environment variableB                         "WGET_TIMEZONE_DIFFERENTIAL" for file time?                         adjustment (as in Wget 1.5.3h for VMS).   0       HOST.C            Added code for Multinet.       D       HTTP.C            Fixed multiple %CC-I-QUESTCOMPARE1 with type                         casts.D                         Changed cookie_jar_generate_cookie_header toC                         cookie_jar_generate_cookie_hdr (COOKIES.C). @                         Added code to try using the logical nameD                         "SYS$TIMEZONE_DIFFERENTIAL" for UTC-to-local=                         time conversions if "gmtime()" fails. F                         Added code to use SYS$TIMEZONE_DAYLIGHT_SAVING;                         in some local-UTC time conversions.   F       INIT.C            Changed to use "SYS$LOGIN:.wgetrc" as the name:                         of the initialization file on VMS.C                         Changed to open this file in text mode, not                          binary.   H       MAIN.C            Changed the program identification debug messageE                         ("built on OS_TYPE" instead of "on OS_TYPE"). @                         Changed to set ODS5 flag if the download>                         destination is on an ODS5 file system.  H       NETRC.C           Changed to use "SYS$LOGIN:.netrc" as the name of?                         the user name and password file on VMS.   E       URL.C             Added code to replace unacceptable dots (".") H                         with underscores "_"), tildes ("~") with hyphensC                         ("-"), and at signs ("@") with dollar signs @                         ("$"), respectively, in URL-derived file'                         specifications.   G       UTILS.C           Added VMS-specific code to work around the lack $                         of "fork()".D                         Fixed multiple %CC-I-QUESTCOMPARE1 with type                         casts.>                         Changed to assist ODS2 name reversion.  4       VERSION.C         Changed "1.9.1" to "1.9.1a".  H ------------------------------------------------------------------------         Home source URL        ---------------   & http://www.gnu.org/directory/wget.html http://ftp.gnu.org/gnu/wget/ ftp://ftp.gnu.org/gnu/wget/   H ------------------------------------------------------------------------         Instructions       ------------  D    Extract the files from the distribution kit.  The kit includes an? Alpha executable, "[.WGET-1_9_1A.SRC.ALPHA]WGET.EXE", and a VAX - executable, "[.WGET-1_9_1A.SRC.VAX]WGET.EXE".   H    The command procedure VMS-WGET.COM attempts to determine the CPU typeF and the IP package, defines the appropriate macros for MMK or MMS, and7 then builds the appropriate executable from the source:   $       SET DEFAULT [.WGET-1_9_1A.SRC]F       @ VMS-WGET CLEAN ! Deletes all object, list, map, and executable8                        ! files for the current CPU type.F       @ VMS-WGET       ! Copies CONFIG.H_VMS to CONFIG.H, compiles the@                        ! source files, and links the executable,G                        ! WGET.EXE.  Add "DASHD" to this command line to G                        ! enable the Wget "-d" command-line option.  Add D                        ! "DBG" to this command line to build a debugH                        ! executable.  Add "LIST" if compiler listing and4                        ! link map files are desired.A       @ VMS-WGET HELP  ! Creates a help library.  (Optional.  See                          ! below.)  *    Set the symbol for the foreign command:  6       WGET :== $ {actual_device_and_directory}WGET.EXE  C    A very basic VMS HELP file is supplied in [.DOC]WGET.HLP.  To be G used, it must be added to a HELP library, either an existing library or F one just for Wget.  As mentioned above, a new Wget help library may be- created using the command, "@ VMS-WGET HELP".   E    When a new HELP library is created, a logical name "HLP$LIBRARY_n" ? may be defined to allow the HELP utility to find it.  See "HELP  /USERLIBRARY" for details.  H    Try to read the original documentation to learn how to use Wget.  The1 principal differences in this VMS adaptation are:   :    "-b" ("background") has no effect.  (It uses "fork()".)  >    Excess dots are replaced by underscores in URL-derived fileH specifications on ODS2 file systems.  For example, on a UNIX system, theE URL "ftp://ftp.anywhere.org/x.y.z/a.b.c" could produce the local file D "ftp.anywhere.org/x.y.z/a.b.c".  With this VMS adaptation, the localE ODS2 file would be "[.FTP_ANYWHERE_ORG.X_Y_Z]A_B.C".  On an ODS5 file ? system, the file would be [.ftp^.anywhere^.org.x^.y^.z]a^.b.c".   H ------------------------------------------------------------------------  C    The accompanying source kit suffers from storage on an ODS2 file E system, which does not preserve case or allow multiple dots in a file G name.  Building this kit should work on VMS,  but it may be expected to F fail on other systems.  To use this kit on a non-VMS system, the files; must be renamed to restore their original mixed-case names.   H ------------------------------------------------------------------------  =    Steven M. Schweda               (+1) 651-699-9818  (voice) 3    382 South Warwick Street        sms@antinode.org     Saint Paul  MN  55105-2547                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           