1This document suggests steps to install Lynx on OS/390 systems.
2
3========================================================================
4o Download the archive file lynx2-8-6.tar.Z in BINARY from the site
5  where you found this announcement or from a site listed at
6  https://lynx.invisible-island.net/
7
8o Unpack with:
9
10	uncompress <lynx2-8-6.tar.Z | pax -rv -o to=IBM-1047
11
12  The "-o to=IBM-1047" is needed to convert the ASCII archive
13  to EBCDIC.  You must not download as a text file; the conversion
14  must be performed after the uncompress.
15
16========================================================================
17o Alternatively, download the PKZIPped archive lynx2-8-6.zip in BINARY.
18
19o Unpack with:
20
21	unzip -aa lynx2-8-6.zip
22
23  The "-aa" is needed to convert the ASCII archive
24  to EBCDIC.  (unzip is not shipped with OS/390.  You can
25  obtain it from:
26
27   Linkname: OS/390 UNIX - Tools and Toys
28	URL: http://www.s390.ibm.com/unix/bpxa1ty1.html
29
30   Linkname: Info-ZIP zip and unzip
31	URL: http://www.s390.ibm.com/ftp/os390/oe/port/infozip-os390.tar.Z
32  )
33
34========================================================================
35o Run the configure script:
36
37	mkdir -p ./OS390/.
38	cd       ./OS390
39	rm -f config.cache
40	CC=c89 CFLAGS="-D_XOPEN_SOURCE_EXTENDED=1 -D_ALL_SOURCE" \
41	    ../lynx2-8-6/configure
42
43  The definitions select the ANSI C compiler (c89) and options
44  to select the right header file directories.  You may also
45  find it useful to set the installation directories with
46  the --prefix=, --sysconfdir=, and --exec_prefix= options.
47
48========================================================================
49o Build Lynx
50
51	gmake
52
53  (I have been unable to build Lynx with IBM's make.  gmake is not
54  shipped with OS/390.  You may obtain gmake from:
55
56   Linkname: Mortice Kern Systems (MKS) Inc. - S/390 �
57	     OpenEdition--GNU Utilities
58	URL: http://www.mks.com/s390/gnu/index.htm
59
60   Linkname: Other
61	URL: http://www.mks.com/s390/gnu/register.htm
62  )
63
64========================================================================
65o Test Lynx:
66
67	./lynx -cfg=../lynx2-8-6/lynx.cfg \
68	    ../lynx2-8-6/lynx_help/lynx_help_main.html
69
70========================================================================
71o Install Lynx:
72
73	gmake install
74	gmake install-help
75	gmake install-doc
76
77========================================================================
78REMAINING PROBLEMS:
79
80	3270-type terminals are not supported. This is probably a
81	permanent restriction since curses support for 3270s is
82	unlikely to appear.
83
84	URL schemes other than HTTP:, FTP:, and FILE: are untested
85	and likely not to work.
86
87	Some character entities are not rendered correctly.
88
89	The Download command converts binary files from ASCII to EBCDIC.
90	This can be undone by a download filter in lynx.cfg.
91
92Paul Gilmartin
93pg@sweng.stortek.com
94