Add notes about how to affect the style of text.

diff --git a/doc/info/attrs.html b/doc/info/attrs.html
index 06844122f3959fe5f1a7e76208ddbf255e126035..459f6dabcce4cca311ad7c8896f2ceb8e0714d8b 100644 (file)
--- a/doc/info/attrs.html
+++ b/doc/info/attrs.html
@@ -814,13 +814,24 @@ This field indicates which graph component uses the attribute.
   font faces that are generally available, such as Times-Roman, Helvetica or
   Courier.
   <P>
+  How font names are resolved also depends on the underlying library that handles
+  font name resolution.
   If Graphviz was built using the
-  <A HREF=http://pdx.freedesktop.org/~fontconfig/fontconfig-user.html>fontconfig library</A>, the latter library
-  will be used to search for the font. However, if the <TT>fontname</TT> string
-  contains a slash character "/", it is treated as a pathname for the font
-  file, though font lookup will append the usual font suffixes.
-  <P>
-  If Graphviz does not use fontconfig, <TT>fontname</TT> will be
+  <A HREF=http://pdx.freedesktop.org/~fontconfig/fontconfig-user.html>fontconfig library</A>, 
+  the latter library will be used to search for the font. 
+  See the commands <B>fc-list</B>, <B>fc-match</B> and the other fontconfig commands for how
+  names are resolved and which fonts are available.
+  Other systems may provide their own font package, such as Quartz for OS X.
+  <P>
+  Note that various font attributes, such as weight and slant, can be built into the
+  font name. Thus, using the <TT>fontname=times:italic</TT> will produce a slanted
+  Times font from fontconfig, while <TT>fontname=times-bold</TT> will resolve to a bold
+  Times using Quartz. Obviously, the syntax differs from system to system. 
+  You will need
+  to ascertain which package is used by your Graphviz system and refer to the relevant
+  documentation.
+  <P>
+  If Graphviz is not built with a high-level font library, <TT>fontname</TT> will be
   considered the name of a Type 1 or True Type font file.
   If you specify <TT>fontname=schlbk</TT>, the tool will look for a
   file named  <TT>schlbk.ttf</TT> or <TT>schlbk.pfa</TT> or <TT>schlbk.pfb</TT>
@@ -2442,6 +2453,11 @@ enclosed in the parentheses,  <TT>(...)+</TT> indicates 1 or more, and
   device-dependent form. Style lists are passed to device drivers, which
   can use this to generate appropriate output.
   <P>
+  The style attribute affects the basic appearance of nodes, edges and graphs, 
+  but has no effect on any text used in labels. For this, use the <A HREF=#d:fontname><TT>fontname</TT></A>, <A HREF=#d:fontsize><TT>fontsize</TT></A> and <A HREF=#d:fontcolor><TT>fontcolor</TT></A>
+  attributes, or the <TT>&lt;FONT&gt;</TT>, <TT>&lt;B&gt;</TT>, <TT>&lt;I&gt;</TT>, etc. 
+  elements in <A HREF=shapes.html#html>HTML-like labels</A>.
+  <P>
   The <TT>setlinewidth</TT> style value can be
   used for more control over the width of node borders and edges than is
   allowed by <TT>bold</TT>. This style value takes an argument, specifying the

diff --git a/doc/infosrc/attrs b/doc/infosrc/attrs
index 2302fea725b5c6004d90fc0ddbf66668da73cbc2..5c12c852407f0027c6374ff6450ab16b42a336b6 100644 (file)
--- a/doc/infosrc/attrs
+++ b/doc/infosrc/attrs
@@ -338,13 +338,24 @@ when the graph is displayed or printed. As such, it is best to rely on
 font faces that are generally available, such as Times-Roman, Helvetica or
 Courier.
 <P>
+How font names are resolved also depends on the underlying library that handles
+font name resolution.
 If Graphviz was built using the
-<A HREF=http://pdx.freedesktop.org/~fontconfig/fontconfig-user.html>fontconfig library</A>, the latter library
-will be used to search for the font. However, if the <TT>fontname</TT> string
-contains a slash character "/", it is treated as a pathname for the font
-file, though font lookup will append the usual font suffixes.
-<P>
-If Graphviz does not use fontconfig, <TT>fontname</TT> will be
+<A HREF=http://pdx.freedesktop.org/~fontconfig/fontconfig-user.html>fontconfig library</A>, 
+the latter library will be used to search for the font. 
+See the commands <B>fc-list</B>, <B>fc-match</B> and the other fontconfig commands for how
+names are resolved and which fonts are available.
+Other systems may provide their own font package, such as Quartz for OS X.
+<P>
+Note that various font attributes, such as weight and slant, can be built into the
+font name. Thus, using the <TT>fontname=times:italic</TT> will produce a slanted
+Times font from fontconfig, while <TT>fontname=times-bold</TT> will resolve to a bold
+Times using Quartz. Obviously, the syntax differs from system to system. 
+You will need
+to ascertain which package is used by your Graphviz system and refer to the relevant
+documentation.
+<P>
+If Graphviz is not built with a high-level font library, <TT>fontname</TT> will be
 considered the name of a Type 1 or True Type font file.
 If you specify <TT>fontname=schlbk</TT>, the tool will look for a
 file named  <TT>schlbk.ttf</TT> or <TT>schlbk.pfa</TT> or <TT>schlbk.pfb</TT>

diff --git a/doc/infosrc/types b/doc/infosrc/types
index db94d2c82b789cd40789709b9a4630714fcf8d9d..b5cb35564fad037d10685fdc8ed18012f93dc9d8 100644 (file)
--- a/doc/infosrc/types
+++ b/doc/infosrc/types
@@ -406,6 +406,11 @@ Additional styles are available in
 device-dependent form. Style lists are passed to device drivers, which
 can use this to generate appropriate output.
 <P>
+The style attribute affects the basic appearance of nodes, edges and graphs, 
+but has no effect on any text used in labels. For this, use the <A HREF=#d:fontname><TT>fontname</TT></A>, <A HREF=#d:fontsize><TT>fontsize</TT></A> and <A HREF=#d:fontcolor><TT>fontcolor</TT></A>
+attributes, or the <TT>&lt;FONT&gt;</TT>, <TT>&lt;B&gt;</TT>, <TT>&lt;I&gt;</TT>, etc. 
+elements in <A HREF=shapes.html#html>HTML-like labels</A>.
+<P>
 The <TT>setlinewidth</TT> style value can be
 used for more control over the width of node borders and edges than is
 allowed by <TT>bold</TT>. This style value takes an argument, specifying the