lynx-dev OS-390.announce

[pg]

Hello, Lyncei,

Since OS/390 is at least as weird as VMS, I'd like to add some special
instructions and caveats in a doc/OS-390.announce file.  Patch
enclosed.

Editorial emendations welcome.  I hope this isn't considered "new
development".  :-)  A few filenames in the text anticipate the
released version by extrapolating from the previous version.

Thanks,
gil

%%% Created Tue May 11 08:11:41 MDT 1999 by target lynx.patch. %%%
diff -bru orig/lynx2-8-2/docs/OS-390.announce lynx2-8-2/docs/OS-390.announce
--- orig/lynx2-8-2/docs/OS-390.announce Tue May 11 07:59:36 1999
+++ lynx2-8-2/docs/OS-390.announce      Tue May 11 08:11:23 1999
@@ -0,0 +1,93 @@
+This document suggests steps to install Lynx on OS/390 systems.
+
+========================================================================
+o Download the archive file lynx2-8-2.tar.Z in BINARY from the site
+  where you found this announcement or from a site listed at
+  http://lynx.browser.org/
+
+o Unpack with:
+
+       uncompress <lynx2-8-2.tar.Z | pax -rv -o to=IBM-1047
+
+  The "-o to=IBM-1047" is needed to convert the ASCII archive
+  to EBCDIC.  You must not download as a text file; the conversion
+  must be performed after the uncompress.
+
+========================================================================
+o Alternatively, download the PKZIPped archive lynx2-8-2.zip in BINARY.
+
+o Unpack with:
+
+       unzip -a lynx2.8.2.zip
+
+  The "-a" is needed to convert the ASCII archive
+  to EBCDIC.  (unzip is not shipped with OS/390.  You can
+  obtain it from:
+
+   Linkname: OS/390 UNIX - Tools and Toys
+        URL: http://www.s390.ibm.com/unix/bpxa1ty1.html
+
+   Linkname: Info-ZIP zip and unzip
+        URL: http://www.s390.ibm.com/ftp/os390/oe/port/infozip-os390.tar.Z
+  )
+
+========================================================================
+o Run the configure script:
+
+       mkdir -p ./OS390/.
+       cd       ./OS390
+       rm -f config.cache
+       CC=c89 CFLAGS="-D_XOPEN_SOURCE_EXTENDED=1 -D_ALL_SOURCE" \
+           ../lynx2-8-2/configure
+
+  The definitions select the ANSI C compiler (c89) and options
+  to select the right header file directories.  You may also
+  find it useful to set the installation directories with
+  the --prefix=, --libdir=, and --exec_prefix= options.
+
+========================================================================
+o Build Lynx
+
+       gmake
+
+  (I have been unable to build Lynx with IBM's make.  gmake is not
+  shipped with OS/390.  You may obtain gmake from:
+
+   Linkname: Mortice Kern Systems (MKS) Inc. - S/390 ®
+             OpenEdition--GNU Utilities
+        URL: http://www.mks.com/s390/gnu/index.htm
+   
+   Linkname: Other
+        URL: http://www.mks.com/s390/gnu/register.htm
+  )
+
+========================================================================
+o Test Lynx:
+
+       ./lynx -cfg=../lynx2-8-2/lynx.cfg \
+           ../lynx2-8-2/lynx_help/lynx_help_main.html
+
+========================================================================
+o Install Lynx:
+
+       gmake install
+       gmake install-help
+       gmake install-doc
+
+========================================================================
+REMAINING PROBLEMS:
+
+       3270-type terminals are not supported. This is probably a
+       permanent restriction since curses support for 3270s is
+       unlikely to appear.
+
+       URL schemes other than HTTP:, FTP:, and FILE: are untested
+       and likely not to work.
+
+       Some character entities are not rendered correctly.
+
+       The Download command converts binary files from ASCII to EBCDIC.
+       This can be undone by a download filter in lynx.cfg.
+
+Paul Gilmartin
address@hidden