Cosmetics
[llpp.git] / BUILDING
blobc733bd658d443a6323c481fda60d755b5fe4e735
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 d396b126c7ab5c241e0dc7ff0edd9942ad5dfdaa
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