summaryrefslogtreecommitdiffstats
path: root/docs/OS-390.announce
blob: 13a7bc7641dd1276d92f5b93d228bb9eb32655b4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
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
  https://lynx.invisible-island.net/

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)

========================================================================
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