Avoid doing extra work
[llpp.git] / BUILDING
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], dependencies here[4]
5
6 llpp also depends on OCaml[5] and lablGL[6], having a C compiler
7 wouldn't hurt either.
8
9 To build llpp "the easy way" one can invoke `sh buildall.sh' which
10 will first attempt to automatically fetch openjpeg, jbig2dec, lablGL,
11 mupdf and build them then, if everything goes fine, it will proceed
12 building llpp itself. Note that OCaml and freetype should still be
13 installed separately.
14
15 Otherwise, provided that all prereqs are already built, one should
16 invoke `sh build.sh' from the top of llpp's directory, prior to that
17 it's advisable to review build.sh so that it matches local mupdf
18 installation (or lack thereof)
19
20 If everything goes fine llpp binary will appear, it can be used like so:
21
22 $ ./llpp /path/to/some.pdf
23 or
24 $ ./llpp -p password /path/to/some.password.protected.pdf
25
26 [1] http://www.mupdf.com
27 [2] http://mupdf.com/repos/mupdf/README
28 [3] http://mupdf.com/download/snapshots/
29 [4] http://mupdf.com/download/source/mupdf-thirdparty.zip
30 [5] http://caml.inria.fr/
31 [6] http://wwwfun.kurims.kyoto-u.ac.jp/soft/lsl/lablgl.html