Sync with upstream
[llpp.git] / BUILDING
blob3e18ce106b04b7de5b742da66f56119dec6b64b8
1 MuPDF[1] rendering library is used to do the actual work, so it needs
2 to be built and installed to use llpp.
4 Note that MuPDF is a moving target therefore below is the commit id
5 of the git version of MuPDF that this version of llpp is known to work
6 with:
7 7aa2806dc5c74d56929e2f2bafeaeed20e364609
9 llpp also depends on OCaml[2], lablGL[3] having a C compiler wouldn't
10 hurt either. (mupdf depends on libcrypto[4] part of openssl)
12 To build llpp one can invoke `sh buildall.sh' which will first attempt
13 to automatically fetch lablGL, mupdf, mupdf's prerequisites and build
14 them, then, if everything goes fine, it will proceed building llpp
15 itself. Note that OCaml and libcrypto still needs to be installed
16 separately, also, in addition to the usual suspects (i.e.  GCC, make,
17 binutils, OCaml), you will need `wget' and `unzip' for this script to
18 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://caml.inria.fr/
28 [3] http://wwwfun.kurims.kyoto-u.ac.jp/soft/lsl/lablgl.html
29 [4] http://www.openssl.org/docs/crypto/crypto.html