summaryrefslogtreecommitdiff
path: root/doc/install.md
diff options
context:
space:
mode:
authorRodrigo Arias Mallo <rodarima@gmail.com>2023-12-10 23:23:57 +0100
committerrodarima <rodarima@gmail.com>2023-12-19 01:49:25 +0100
commit58a950376b3c09098da3b286bb71b7b6eb4777d2 (patch)
tree682df13eacd603d3559259108d1257a17cbd8eef /doc/install.md
parente0b57163df45c4759de65d16d8f57d7e5e12ac58 (diff)
Update README.md with dillo.org dead notice
The official server is lost. Move install instructions to its own document.
Diffstat (limited to 'doc/install.md')
-rw-r--r--doc/install.md80
1 files changed, 80 insertions, 0 deletions
diff --git a/doc/install.md b/doc/install.md
new file mode 100644
index 00000000..de3d1d03
--- /dev/null
+++ b/doc/install.md
@@ -0,0 +1,80 @@
+# Installing Dillo on Linux
+
+Dillo is already packaged in many Linux distributions. To use the binary
+from your distribution check your package manager. Example in Arch
+Linux:
+
+```
+$ sudo pacman -S dillo
+```
+
+## Building from source
+
+Dillo requires FLTK-1.3, if you don't have it (try `fltk-config
+--version` to check), follow the steps in the FLTK documentation to
+install it:
+
+https://www.fltk.org/doc-1.3/intro.html
+
+Then, to install Dillo:
+
+### From a release
+
+```sh
+$ tar jxvf dillo-3.0.5.tar.bz2
+$ cd dillo-3.0.5
+$ ./configure; make
+$ sudo make install-strip
+```
+
+### From git
+
+```sh
+$ git clone git@github.com:dillo-browser/dillo.git
+$ cd dillo
+$ ./autogen.sh
+$ ./configure
+$ make
+$ sudo make install
+```
+
+## Hyphenation database
+
+In order to use the hyphenation feature, pattern files from CTAN need to
+be installed. This can be done with the script
+`dillo-install-hyphenation`. Call it with ISO-639-1 language codes
+("en", "es", "de"...) as arguments, or without arguments to get more
+help.
+
+## Dpi programs
+
+These are installed by `make install`. If you don't have root access,
+copy "dillo" and "dpid" to some directory in your path and install
+the dpis by running `./install-dpi-local` from the top directory (they
+will be installed under ~/.dillo).
+
+# Other systems
+
+## BSD
+
+Dillo compiles on BSD systems; please report on this anyway, and note
+that you'll need GNU make. If your dillo crashes or locks at times, use:
+
+```
+$ ./configure --disable-threaded-dns
+```
+
+So dillo uses a single thread for name resolving.
+
+## Solaris
+
+Dillo may compile and run OK on Solaris but (please report).
+Use gmake (a symbolic link make -> gmake works OK).
+
+Solaris is very inconsistent so you may need to add/remove:
+
+```
+-lrt -lposix4
+```
+
+at link time.