snapshot of project "lynx", label v2-8-8dev_3c

1 files changed, 93 insertions, 0 deletions

diff --git a/docs/OS-390.announce b/docs/OS-390.announce
new file mode 100644
index 00000000..e28767de
--- /dev/null
+++ b/docs/OS-390.announce
@@ -0,0 +1,93 @@
+This document suggests steps to install Lynx on OS/390 systems.
+
+========================================================================
+o Download the archive file lynx2-8-6.tar.Z in BINARY from the site
+  where you found this announcement or from a site listed at
+  http://lynx.isc.org/
+
+o Unpack with:
+
+	uncompress <lynx2-8-6.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-6.zip in BINARY.
+
+o Unpack with:
+
+	unzip -aa lynx2-8-6.zip
+
+  The "-aa" 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-6/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=, --sysconfdir=, 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-6/lynx.cfg \
+	    ../lynx2-8-6/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
+pg@sweng.stortek.com