Overview

Dependencies
============

    - working linux framebuffer
    - libcairo
    - libpoppler or libpoppler-glib

Building
========

If you're very lucky you can just do::

    $ ./waf configure build

If you're unlucky, look at the help (./waf --help) or try the following.

Missings Poppler headers
------------------------

Because gade-pdf-la needs headers files that are private in poppler,
some headers files may miss you (they are not installed by distribution
packages like in debian, red hat, archlinux, etc.)

So you will need to download and uncompress the source tarball
(http://poppler.freedesktop.org) that corresponds to your installed poppler
library, then do

    $ CPATH=/path/to/poppler ./waf configure build

Missing reference to poppler symbols
------------------------------------

You may have trouble with missing symbols at linking time
(undefined reference to `CairoOutputDev::CairoOutputDev()` for instance).

If you've installed the library from a distribution package, you can try to
link with the poppler-glib (you may have to install the corresponding package)::

    $ ./waf configure --poppler=poppler-glib

If you've compiled poppler manually, you can re-compile it with the
--enable-cairo-output config option

Missing libraries
-----------------

The gade-pdf-la build tools will try to find the required libraries in common
UNIX places (in ``/usr/lib`` and ``/usr/lib/<libname>`` for instance). If you're
library files are in other places, you may give the directory list within the ``LIBPATH``
enironment variable::

    $ LIBPATH=/usr/local/lib:$HOME/.local/lib ./waf configure build

My command line
---------------

here is my command line::

    $ CPATH=$PWD/poppler-0.18.0/poppler ./waf configure build --poppler=poppler-glib

The ``./waf`` tools have many other options to tune the build process ...


Building manually
-----------------

You may not want to use the ``./waf`` tools. It is very simple to manually build
gade-pdf-la. Here is an example of command line to do so::

    $ g++ -Wno-write-strings -DPOPPLER_MAJOR=0 -DPOPPLER_MINOR=12
    -I/usr/include/cairo -I/usr/include/freetype2 -I/usr/include/poppler/
    -c src/poppler-clib.cxx
    $ gcc -c -Wall -pedantic -I/usr/include/cairo src/main.c
    $ gcc -o gade-pdf-la main.o poppler-clib.o -lpoppler-glib

Installing
==========

    $ ./waf install

:Note: Only one executable file is generated: ``gade-pdf-la`` (in the ``./build/``
       directory by default). So copy it to any ``PATH`` foler, for example: ``/usr/bin``.

Running
=======

    $ gade-pdf-la file.pdf

gade-pdf-la shall run from within screen, tmux, links, elinks

Specifying the target terminal number (tty8)::

    $ gade-pdf-la -c 8

Specifying the source tty device (to get configuration)::

    $ gade-pdf-la -t /dev/tty -c 8


Testing poppler-clib
====================

    $ gcc -I/usr/include/cairo -c src/test-poppler-clib.c
    $ gcc -o test-poppler-clib test-poppler-clib.o poppler-clib.o -lpoppler-glib
    $ ./test-poppler-clib test.pdf out.png

LICENSE
=======

Work under the WTFPL v2.