Author: pierre Date: Thu Feb 8 05:59:40 2018 New Revision: 19738 Log: Graphviz: make all dependencies optional and explain what they are useful for
Modified: trunk/BOOK/general.ent trunk/BOOK/general/genutils/graphviz.xml Modified: trunk/BOOK/general.ent ============================================================================== --- trunk/BOOK/general.ent Wed Feb 7 16:15:43 2018 (r19737) +++ trunk/BOOK/general.ent Thu Feb 8 05:59:40 2018 (r19738) @@ -1,12 +1,12 @@ <!-- $LastChangedBy$ $Date$ --> -<!ENTITY day "07"> <!-- Always 2 digits --> +<!ENTITY day "08"> <!-- Always 2 digits --> <!ENTITY month "02"> <!-- Always 2 digits --> <!ENTITY year "2018"> <!ENTITY copyrightdate "2001-&year;"> <!ENTITY copyholder "The BLFS Development Team"> <!ENTITY version "&year;-&month;-&day;"> -<!ENTITY releasedate "February 7th, &year;"> +<!ENTITY releasedate "February 8th, &year;"> <!ENTITY pubdate "&year;-&month;-&day;"> <!-- metadata req. by TLDP --> <!ENTITY blfs-version "svn"> <!-- svn|[release #] --> <!ENTITY lfs-version "development"> <!-- x.y|development --> Modified: trunk/BOOK/general/genutils/graphviz.xml ============================================================================== --- trunk/BOOK/general/genutils/graphviz.xml Wed Feb 7 16:15:43 2018 (r19737) +++ trunk/BOOK/general/genutils/graphviz.xml Thu Feb 8 05:59:40 2018 (r19738) @@ -99,36 +99,87 @@ <bridgehead renderas="sect3">Graphviz Dependencies</bridgehead> - <bridgehead renderas="sect4">Recommended</bridgehead> - <para role="recommended"> - <xref linkend="freetype2"/>, - <xref linkend="fontconfig"/>, - <xref linkend="freeglut"/>, - <xref linkend="gdk-pixbuf"/>, - <xref linkend="libjpeg"/>, - <xref linkend="libpng"/>, - <xref linkend="librsvg"/>, - <xref linkend="pango"/> and - <xref linkend="xorg7-lib"/> + <note> + <para> + <application>Graphviz</application> basic usage does not need any + libraries out of what is found in the LFS book. Its <quote>core</quote> + rendering engine allows to generate several graphic formats, such as + Postscript, SVG, VML, .fig, and Tk. Those formats can be converted + to almost any other, using for example tools from <xref role="nodep" + linkend="imagemagick"/>. The dependencies below add the ability to + generate graph images in bitmap format, to display the graph image on + screen, to edit a graph by seeing directly the result image, or to view + large graphs. Since <application>Graphviz</application> is a dependency + of several other packages in this book, it is suggested to first build + it without any dependencies, then to rebuild it when you have built + enough packages to suit your needs. + </para> + </note> + + <bridgehead renderas="sect4">Optional, for various bitmap outputs</bridgehead> + <para role="optional"> + <xref linkend="pango"/>, with + <xref linkend="cairo"/>, + <xref linkend="xorg7-lib"/>, + <xref linkend="fontconfig"/>, and + <xref linkend="libpng"/>, to generate images in bitmap SVG, postscript, + PNG, and PDF formats, or displaying the image on screen </para> - <bridgehead renderas="sect4">Optional</bridgehead> <para role="optional"> - <xref linkend="libglade"/>, - <xref linkend="gs"/>, - <xref linkend="gtk2"/>, - <xref linkend="qt5"/>, + Adding + <xref linkend="gtk2"/> with + <xref linkend="libjpeg"/> allows to add JPEG, BMP, TIF, and ICO formats, + and to display the image in a GTK+ window + </para> + + <para role="optional"> + <ulink url="http://www.libgd.org/">GD Library</ulink> may be used + instead of <application>Pango</application>. It adds the ability to + generate images in GIF, VRML, and GD formats, but + <application>Pango</application> provides better outputs for the other + formats, and is needed for displaying images + </para> + + <para role="optional"> + Other formats may be added with + <xref linkend="libwebp"/> (WebP support is considered experimental), <ulink url="http://openil.sourceforge.net/projects.php">DevIL</ulink>, - <ulink url="http://linux.softpedia.com/get/Programming/Debuggers/Electric-Fence-3305.shtml/">Electric Fence</ulink>, <ulink url="http://sourceforge.net/projects/lasi/">libLASi</ulink>, - <ulink url="http://www.libgd.org/">GD Library</ulink>, and - <ulink url="http://www.freedesktop.org/wiki/Software/glitz">glitz</ulink> + <ulink url="http://www.freedesktop.org/wiki/Software/glitz">glitz</ulink>, + and <ulink url="http://www.libming.org/">libming</ulink> (Macromedia + Flash) + </para> + + <bridgehead renderas="sect4">Optional, to load graphic images that may be + displayed inside the nodes of a graph</bridgehead> + + <para role="optional"> + <filename class="libraryfile">libgs.so</filename> from + <xref linkend="gs"/>, + <xref linkend="librsvg"/>, and + <xref linkend="poppler"/> + </para> + + <bridgehead renderas="sect4">Optional, to build more tools</bridgehead> + + <para role="optional"> + <xref linkend="freeglut"/> (with <xref linkend="libglade"/>, + <ulink url="https://projects.gnome.org/gtkglext/">GtkGLExt</ulink>, and + <ulink url="http://gts.sourceforge.net/">libGTS</ulink>, for building + the <command>smyrna</command> large graph viewer, which is + considered experimental), + <xref linkend="qt5"/>, for building the <command>gvedit</command> + graph editor. Another graph editor, <command>dotty</command> needs only + <xref role="nodep" linkend="xorg7-lib"/> +<!-- use nodep to avoid repetition --> </para> <bridgehead renderas="sect4">Optional (To Build Language Bindings)</bridgehead> <para role="optional"> <xref linkend="swig"/> (<application>SWIG</application> must be installed or no bindings will be built), + <xref linkend="gcc"/> (for the go language), <xref linkend="guile"/>, <xref linkend="openjdk"/>, <xref linkend="lua"/>, @@ -143,6 +194,13 @@ <ulink url="http://www.r-project.org/">R</ulink> </para> + <bridgehead renderas="sect4">Optional (building tools)</bridgehead> + <para role="optional"> + <ulink url="https://github.com/Snaipe/Criterion">Criterion</ulink> + (framework for tests), + <ulink url="http://linux.softpedia.com/get/Programming/Debuggers/Electric-Fence-3305.shtml/">Electric Fence</ulink>, + </para> + <para condition="html" role="usernotes">User Notes: <ulink url="&blfs-wiki;/graphviz"/> </para> @@ -223,6 +281,17 @@ This is possible nevertheless by using the -I switch inside the variable. </para> + <para> + <option>--with-webp</option>: Even if <xref linkend="libwebp"/> is + installed, it is not included in the build without this option. + </para> + + <para> + <option>--with-smyrna</option>: Even if the needed dependencies are + installed, the interactive graph viewer <command>smyrna</command> is not + built without this option. + </para> + </sect2> <sect2 role="configuration"> -- http://lists.linuxfromscratch.org/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page