Add gotor[d] to remote interface
[llpp.git] / BUILDING
blob428fe0eff6f68c2645c0119694f14791e1b5f9b7
1 MuPDF[1] rendering library is used to do the actual work, so it needs
2 to be built and installed to use llpp, MuPDF's README[2] describes how
3 to build it and lists its dependencies.
5 Note that MuPDF is a moving target therefore below is the commit id
6 of the git version of MuPDF that this version of llpp is known to work
7 with:
8 67ebe59a41f8b2deaf78dc916c5cd203d3fcc3a3
10 llpp also depends on OCaml[3], lablGL[4], having a C compiler wouldn't
11 hurt either.
13 To build llpp one can invoke `sh buildall.sh' which will first attempt
14 to automatically fetch lablGL, mupdf, mupdf's prerequisites and build
15 them, then, if everything goes fine, it will proceed building llpp
16 itself. Note that OCaml still needs to be installed separately, also,
17 in addition to the usual suspects (i.e.  GCC, make, binutils, OCaml),
18 you will need `wget' and `unzip' for this script to work.
20 If everything goes fine llpp binary will appear, it can be used like so:
22 $ ./llpp /path/to/some.pdf
24 $ ./llpp -p password /path/to/some.password.protected.pdf
26 [1] http://www.mupdf.com
27 [2] http://mupdf.com/repos/mupdf/README
28 [3] http://caml.inria.fr/
29 [4] http://wwwfun.kurims.kyoto-u.ac.jp/soft/lsl/lablgl.html