Increase page width for bird's eye
[llpp.git] / BUILDING
blob07c6cb52b244c830cdb68c821285174099c484f4
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]
6 llpp also depends on OCaml[5] and lablGL[6], having a C compiler
7 wouldn't hurt either.
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 should still be installed
13 separately.
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)
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://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