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 It should be noted that vanilla MuPDF does not handle internal links
   7 precisely, one can use patched MuPDF from SumatraPDF[5], but MuPDF
   8 from SumatraPDF has problems of it's own (wrong font substitutions),
   9 user is free to pick his poison.
  10
  11 llpp also depends on OCaml[6] and lablGL[7], having a C compiler
  12 wouldn't hurt either.
  13
  14 To build llpp "the easy way" one can invoke `sh buildall.sh' which
  15 will first attempt to automatically fetch openjpeg, jbig2dec, mupdf
  16 and build them then, if everything goes fine it will proceed building
  17 llpp itself. Note that OCaml should still be installed separately.
  18
  19 Otherwise, provided that all prereqs are already built, one should
  20 invoke `sh build.sh' from the top of llpp's directory, prior to that
  21 it's advisable to review build.sh so that it matches local mupdf
  22 installation (or lack thereof)
  23
  24 If everything goes fine llpp binary will appear, it can be used like so:
  25
  26 $ ./llpp /path/to/some.pdf
  27
  28 [1] http://www.mupdf.com
  29 [2] http://mupdf.com/repos/mupdf/README
  30 [3] http://mupdf.com/download/snapshots/
  31 [4] http://mupdf.com/download/source/mupdf-thirdparty.zip
  32 [5] http://blog.kowalczyk.info/software/sumatrapdf/index.html
  33 [6] http://caml.inria.fr/
  34 [7] http://wwwfun.kurims.kyoto-u.ac.jp/soft/lsl/lablgl.html