Ignore:
Timestamp:
02/08/2018 01:59:40 PM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, ken/refactor-virt, lazarus, perl-modules, qt5new, trunk, xry111/git-date, xry111/git-date-for-trunk, xry111/git-date-test
Children:
6769aa6
Parents:
f806dbca
Message:

Graphviz: make all dependencies optional and explain what they are useful for

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19738 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed
  • general/genutils/graphviz.xml

    rf806dbca r31ef4b60  
    100100    <bridgehead renderas="sect3">Graphviz Dependencies</bridgehead>
    101101
    102     <bridgehead renderas="sect4">Recommended</bridgehead>
    103     <para role="recommended">
    104       <xref linkend="freetype2"/>,
    105       <xref linkend="fontconfig"/>,
    106       <xref linkend="freeglut"/>,
    107       <xref linkend="gdk-pixbuf"/>,
    108       <xref linkend="libjpeg"/>,
    109       <xref linkend="libpng"/>,
    110       <xref linkend="librsvg"/>,
    111       <xref linkend="pango"/> and
    112       <xref linkend="xorg7-lib"/>
    113     </para>
    114 
    115     <bridgehead renderas="sect4">Optional</bridgehead>
     102    <note>
     103      <para>
     104        <application>Graphviz</application> basic usage does not need any
     105        libraries out of what is found in the LFS book. Its <quote>core</quote>
     106        rendering engine allows to generate several graphic formats, such as
     107        Postscript, SVG, VML, .fig, and Tk. Those formats can be converted
     108        to almost any other, using for example tools from <xref role="nodep"
     109        linkend="imagemagick"/>. The dependencies below add the ability to
     110        generate graph images in bitmap format, to display the graph image on
     111        screen, to edit a graph by seeing directly the result image, or to view
     112        large graphs. Since <application>Graphviz</application> is a dependency
     113        of several other packages in this book, it is suggested to first build
     114        it without any dependencies, then to rebuild it when you have built
     115        enough packages to suit your needs.
     116      </para>
     117    </note>
     118
     119    <bridgehead renderas="sect4">Optional, for various bitmap outputs</bridgehead>
    116120    <para role="optional">
    117       <xref linkend="libglade"/>,
     121      <xref linkend="pango"/>, with
     122      <xref linkend="cairo"/>,
     123      <xref linkend="xorg7-lib"/>,
     124      <xref linkend="fontconfig"/>, and
     125      <xref linkend="libpng"/>, to generate images in bitmap SVG, postscript,
     126      PNG, and PDF formats, or displaying the image on screen
     127    </para>
     128
     129    <para role="optional">
     130      Adding
     131      <xref linkend="gtk2"/> with
     132      <xref linkend="libjpeg"/> allows to add JPEG, BMP, TIF, and ICO formats,
     133      and to display the image in a GTK+ window
     134    </para>
     135
     136    <para role="optional">
     137      <ulink url="http://www.libgd.org/">GD Library</ulink> may be used
     138      instead of <application>Pango</application>. It adds the ability to
     139      generate images in GIF, VRML, and GD formats, but
     140      <application>Pango</application> provides better outputs for the other
     141      formats, and is needed for displaying images
     142    </para>
     143     
     144    <para role="optional">
     145      Other formats may be added with
     146      <xref linkend="libwebp"/> (WebP support is considered experimental),
     147      <ulink url="http://openil.sourceforge.net/projects.php">DevIL</ulink>,
     148      <ulink url="http://sourceforge.net/projects/lasi/">libLASi</ulink>,
     149      <ulink url="http://www.freedesktop.org/wiki/Software/glitz">glitz</ulink>,
     150      and <ulink url="http://www.libming.org/">libming</ulink> (Macromedia
     151      Flash)
     152    </para>
     153
     154    <bridgehead renderas="sect4">Optional, to load graphic images that may be
     155    displayed inside the nodes of a graph</bridgehead>
     156
     157    <para role="optional">
     158      <filename class="libraryfile">libgs.so</filename> from
    118159      <xref linkend="gs"/>,
    119       <xref linkend="gtk2"/>,
    120       <xref linkend="qt5"/>,
    121       <ulink url="http://openil.sourceforge.net/projects.php">DevIL</ulink>,
    122       <ulink url="http://linux.softpedia.com/get/Programming/Debuggers/Electric-Fence-3305.shtml/">Electric Fence</ulink>,
    123       <ulink url="http://sourceforge.net/projects/lasi/">libLASi</ulink>,
    124       <ulink url="http://www.libgd.org/">GD Library</ulink>, and
    125       <ulink url="http://www.freedesktop.org/wiki/Software/glitz">glitz</ulink>
     160      <xref linkend="librsvg"/>, and
     161      <xref linkend="poppler"/>
     162    </para>
     163
     164    <bridgehead renderas="sect4">Optional, to build more tools</bridgehead>
     165
     166    <para role="optional">
     167      <xref linkend="freeglut"/> (with <xref linkend="libglade"/>,
     168      <ulink url="https://projects.gnome.org/gtkglext/">GtkGLExt</ulink>, and
     169      <ulink url="http://gts.sourceforge.net/">libGTS</ulink>, for building
     170      the <command>smyrna</command> large graph viewer, which is
     171      considered experimental),
     172      <xref linkend="qt5"/>, for building the <command>gvedit</command>
     173      graph editor. Another graph editor, <command>dotty</command> needs only
     174      <xref role="nodep" linkend="xorg7-lib"/>
     175<!-- use nodep to avoid repetition -->
    126176    </para>
    127177
     
    130180      <xref linkend="swig"/> (<application>SWIG</application> must be
    131181      installed or no bindings will be built),
     182      <xref linkend="gcc"/> (for the go language),
    132183      <xref linkend="guile"/>,
    133184      <xref linkend="openjdk"/>,
     
    144195    </para>
    145196
     197    <bridgehead renderas="sect4">Optional (building tools)</bridgehead>
     198    <para role="optional">
     199      <ulink url="https://github.com/Snaipe/Criterion">Criterion</ulink>
     200          (framework for tests),
     201      <ulink url="http://linux.softpedia.com/get/Programming/Debuggers/Electric-Fence-3305.shtml/">Electric Fence</ulink>,
     202    </para>
     203
    146204    <para condition="html" role="usernotes">User Notes:
    147205      <ulink url="&blfs-wiki;/graphviz"/>
     
    222280      only one directory, but two directories need to be included.
    223281      This is possible nevertheless by using the -I switch inside the variable.
     282    </para>
     283
     284    <para>
     285      <option>--with-webp</option>: Even if <xref linkend="libwebp"/> is
     286      installed, it is not included in the build without this option.
     287    </para>
     288
     289    <para>
     290      <option>--with-smyrna</option>: Even if the needed dependencies are
     291      installed, the interactive graph viewer <command>smyrna</command> is not
     292      built without this option.
    224293    </para>
    225294
Note: See TracChangeset for help on using the changeset viewer.