Update build appendix to include pathplan, and new libraries.

diff --git a/doc/libguide/build.tex b/doc/libguide/build.tex
index 73cbd23687f25055b08a9ade75f70f9f92bf4b7c..c999e066ee749618e7cabbcfd8f2868385afdffb 100644 (file)
--- a/doc/libguide/build.tex
+++ b/doc/libguide/build.tex
@@ -1,5 +1,13 @@
 \section{Compiling and linking}
 \label{sec:build}
+This appendix provides a brief description of how to build
+your program using \gviz\ as a library. It also notes the 
+various libraries involved. As compilation systems vary
+greatly, we make no attempt to provide low-level build
+instructions. We assume that the user is capable of tailoring
+the build environment to use the necessary include files and
+libraries.
+
 All of the necessary include files and libraries are available
 in the {\tt include} and {\tt lib} directories where \gviz\
 is installed. At the simplest level, all an application needs
@@ -12,22 +20,41 @@ For linking, the application should use the \gviz\ libraries
 \begin{itemize}
 \item {\tt gvc}
 \item {\tt graph}
-\item {\tt cdt}\footnote{
+\item {\tt pathplan}
+\item {\tt cdt}
+\end{itemize}
+If the system is configured to use plug-ins, these libraries
+are all that are necessary. At run time, the program will
+load the dynamic libraries it needs.
+
+If the program does not use plug-ins, then these libraries
+need to be incorporated at link time. These libraries may
+include
+\begin{itemize}
+\item {\tt gvplugin\_dot\_layout}
+\item {\tt gvplugin\_neato\_layout}
+\item {\tt gvplugin\_gd}
+\item {\tt gvplugin\_pangocairo}\footnote{
 For completeness, we note that it may be necessary to explicitly
 link in the following additional libraries, depending
 on the options set when \gviz\ was built:
 {\tt expat},
 {\tt fontconfig},
 {\tt freetype2},
+{\tt pangocairo},
+{\tt cairo},
+{\tt pango},
+{\tt gd},
 {\tt jpeg},
 {\tt png},
-{\tt z}, and
-{\tt ltdl}.
+{\tt z}, 
+{\tt ltdl},
+and other libraries required by Cairo and Pango.
 Typically, though, most builds handle these implicitly.}
 \end{itemize}
+plus any other plug-ins the program requires.
 
-If \gviz\ is built and installed with the GNU build tools
-(This includes the current Windows binary package),
+If \gviz\ is built and installed with the GNU build tools,
 there are package configure files created in the {\tt lib/pkgconfig} 
 directory which can be used with the {\tt pkg-config} program
 to obtain the include file and library information for 
@@ -41,7 +68,7 @@ could have the form:
 
 \begin{verbatim}
 CFLAGS=`pkg-config libgvc --cflags` -Wall -g -O2
-LDFLAGS=-Wl,--rpath -Wl,`pkg-config libgvc --variable=libdir` `pkg-config libgvc --libs`
+LDFLAGS=`pkg-config libgvc --libs`
 
 all: simple dot demo
 

diff --git a/doc/libguide/libguide.pdf b/doc/libguide/libguide.pdf
index 15dda441ee2800ad8304bf403fbb6af4a122d137..31399d3f02e29de3ba39cb07608b888a2b6142b5 100644 (file)
Binary files a/doc/libguide/libguide.pdf and b/doc/libguide/libguide.pdf differ