Consistency
[llpp.git] / BUILDING
blob9aa093b100e3740c629d321d69fe8b6e6b8ff0fa
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. Snapshots of MuPDF itself can
4 be found here[3]
6 Note that MuPDF is a moving target therefore bellow is the commit id
7 of the git version of MuPDF that this version of llpp is known to work
8 with:
9 13bea1fd3df96f0554335789395121ba715ba15e
11 llpp also depends on OCaml[4], lablGL[5], having a C compiler wouldn't
12 hurt either.
14 To build llpp one can invoke `sh buildall.sh' which will first attempt
15 to automatically fetch lablGL, mupdf, mupdf's prerequisites and build
16 them, then, if everything goes fine, it will proceed building llpp
17 itself. Note that OCaml still needs to be installed separately, also,
18 in addition to the usual suspects (i.e.  GCC, make, binutils, OCaml),
19 you will need `wget' and `unzip' for this script to work.
21 If everything goes fine llpp binary will appear, it can be used like so:
23 $ ./llpp /path/to/some.pdf
25 $ ./llpp -p password /path/to/some.password.protected.pdf
27 [1] http://www.mupdf.com
28 [2] http://mupdf.com/repos/mupdf/README
29 [3] http://mupdf.com/download/snapshots/
30 [4] http://caml.inria.fr/
31 [5] http://wwwfun.kurims.kyoto-u.ac.jp/soft/lsl/lablgl.html