-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
114 lines (94 loc) · 4.52 KB
/
INSTALL
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
Links 2.22 -- How To Install
----------------------------
Follow this step-by-step:
0) Check you have installed the following libraries and are able to compile with
them. On a package-driven distribution, you will need both "library" and
"library-dev(el)":
Mandatory libraries
-------------------
libpng - required to compile links in graphics mode (not required in text
mode). Libpng 2.1.18 has a bug and must be patched by the patch
libpng-1.2.18.patch which is shipped with Links.
IJG libjpeg - if you want to display JPEG's (probably yes).
TIFF Library - if you want TIFFs.
SVGAlib - if you want Links to be able to display on SVGAlib.
OpenSSL and zlib - if you want SSL connections. zlib is not necessary if you
know the SSL is compiled without zlib.
Optional libraries
------------------
zlib - shows gzipped pages
libbz2 - shows bzipped content
lzma - shows content compressed with lzma
If any of the library is not present on the system or is unusably old and you cannot install it
(typically because you are not a root), then go to 11) Compiling with
user-supplied libraries.
1) Do not forget to run "ldconfig" if you have installed any new libraries :-)
2) "./configure --help"
Read the output and choose which options you want to give ./configure.
Probably you will want --enable-graphics
3) "./configure <your options>"
4) Check the output of ./configure (in the table at the end) whether you really
get what you want
5) "make"
6) If you are a root, "make install" with root privileges. If not, copy the
resulting "links" executable into some suitable place, preferrably within
your $PATH. The whole browser is just one executable.
7) If you haven't got a permanent Internet connection, save the "doc/"
subdirectory into some suitable place (/usr/share/, /usr/local/share). The
most important part is the "doc/links_cal/" subdirectory which contains a calibration pattern
(calibration.html in English, kalibrace.html in Czech)
you will need to get a flawless picture on your monitor.
8) If you want to supply a Links icon into your X Window System windowmanager,
you will find a suitable 48x48 icon in graphics/links.xpm
9) Delete the archive and source directory - no more needed
10) The browser is ready now. You just have to calibrate it to get a flawless
picture (see doc/calibration.html or the Links homepage, which is in default
bookmarks).
11) Compiling with user-supplied libraries.
This describes how to compile Links with user-supplied libraries zlib,
libpng, libpjpeg and libtiff. If you want to use any of these libraries from
the system, omit appropriate references. The versions are just for example:
Download libpng-1.2.3, zlib-1.1.4, libjpeg-6b and libtiff-v3.5.7
archives and unpack them. Build the libraries according to their
instructions to get static (*.a) library in each.
Please note libpng-1.2.18 is buggy and must be patched with
libpng-1.2.18.patch which is shipped with Links.
export CPPFLAGS="-I../zlib-1.1.4 -I../libpng-1.2.3 -I../jpeg-6b
-I../tiff-v3.5.7/libtiff"
export LDFLAGS="=L../zlib-1.1.4 -L../libpng-1.2.3 -L../jpeg-6b
-L ../tiff-v3.5.7/libtiff"
goto 2)
PITFALLS
--------
Compile:
Unix - use ./configure; make
in some FreeBSD 3 distributions you have to set CFLAGS=-aout before
running ./configure
Tested on Linux, FreeBSD, Solaris, IRIX
OS/2 - use ./configure; make
You must have GNU bash and GNU text/shell/file utilities so that
configure can run
The only supported compiler is EMX, you probably won't be able to
compile it with anything else
configure under OS/2 needs to know paths to gcc, make anb bash. Set (for
example):
SET HOSTTYPE=i586
SET MACHTYPE=i586-pc-os2
SET CONFIG_SHELL=d:/prg/gnu/bin/bash.exe
SET CC=d:/prg/emx/bin/gcc.exe
SET MAKE=d:/prg/emx/bin/make.exe
SET EMXOPT=-h100
Windows - you must have Cygwin or Interix environment
Otherwise, compile it just like on Unix
Install:
Unix - make install
OS/2 - copy file links.exe somewhere to your path or create CMD file that runs
links
WARNING: EMX has nasty limit of open files. Links will work badly or won't work
with default settings. Set variable EMXOPT=-h100 before you run links.
libpng-1.2.18 - "Error when loading compiled-in font: png_do_rgb_to_gray found
nongray pixel. libpng error: png_do_rgb_to_gray found nongray
pixel Abort." This is caused by a bug in libpng and
libpng-1.2.18.patch shipped with Links must be used to patch
libpng to fix the bug.
vim: textwidth=80