From 8bd2e4fd5b2e12030b1353868e4e1566a0fb00c1 Mon Sep 17 00:00:00 2001
From: "Emden R. Gansner" <erg@alum.mit.edu>
Date: Sun, 9 Mar 2014 16:23:21 -0400
Subject: [PATCH] Add documentation for using <O>..</O>

---
 doc/info/shapes.html     | 36 ++++++++++++++++++++++++++++++++++--
 doc/infosrc/html.2       |  8 +++++++-
 doc/infosrc/html_grammar |  2 +-
 3 files changed, 42 insertions(+), 4 deletions(-)

diff --git a/doc/info/shapes.html b/doc/info/shapes.html
index 3e7d26853..cc0ab2146 100644
--- a/doc/info/shapes.html
+++ b/doc/info/shapes.html
@@ -545,6 +545,11 @@ Note that, as in HTML, element and attribute names are case-insensitive.
   <TD ALIGN=LEFT>|</TD>
   <TD ALIGN=LEFT><B>&lt;U&gt;</B> <I>text</I> <B>&lt;/U&gt</B></TD>
 </TR>
+<TR>
+  <TD ALIGN=RIGHT></TD>
+  <TD ALIGN=LEFT>|</TD>
+  <TD ALIGN=LEFT><B>&lt;O&gt;</B> <I>text</I> <B>&lt;/O&gt</B></TD>
+</TR>
 <TR>
   <TD ALIGN=RIGHT></TD>
   <TD ALIGN=LEFT>|</TD>
@@ -731,11 +736,17 @@ Attribute values must appear in double quotes.
 &gt;
 </PRE>
 <P>
-  &lt;!-- Underlined text --&gt;
+  &lt;!-- Underline text --&gt;
 <PRE>&lt;U
   &lt;!-- No attributes --&gt;
 &gt;
 </PRE>
+<P>
+  &lt;!-- Overline text --&gt;
+<PRE>&lt;O
+  &lt;!-- No attributes --&gt;
+&gt;
+</PRE>
 <P>
   &lt;!-- Subscript text --&gt;
 <PRE>&lt;SUB
@@ -1150,7 +1161,28 @@ Here is an example using an &lt;IMG&gt; element
 <IMG SRC=html4.gif>
 <P>
 with the <A HREF=html4.gv>input graph</A>.
-
+<P>
+The <tt>sides</tt> attribute (version 2.37 and later) allows one to combine cells to form 
+various non-convex shapes. For example, a <tt>tee-shaped</tt> node
+<P>
+<IMG SRC=tee.gif>
+<P>
+can be produced using
+<XMP>
+  tee [shape=none margin=0 label=
+    <<table border="0" cellspacing="0" cellborder="1">
+     <tr>
+      <td width="9" height="9" fixedsize="true" style="invis"></td>
+      <td width="9" height="9" fixedsize="true" sides="ltr"></td>
+      <td width="9" height="9" fixedsize="true" style="invis"></td>
+     </tr>
+     <tr>
+      <td width="9" height="9" fixedsize="true" sides="tlb"></td>
+      <td width="9" height="9" fixedsize="true" sides="b"></td>
+      <td width="9" height="9" fixedsize="true" sides="brt"></td>
+     </tr>
+    </table>>]
+</XMP>
 <H2><A NAME=epsf>User-defined Nodes</A></H2>
 
 There is a third type of node shape which is specified by the user.
diff --git a/doc/infosrc/html.2 b/doc/infosrc/html.2
index 49bac1b15..f48bfd8d8 100644
--- a/doc/infosrc/html.2
+++ b/doc/infosrc/html.2
@@ -119,11 +119,17 @@ Attribute values must appear in double quotes.
 &gt;
 </PRE>
 <P>
-  &lt;!-- Underlined text --&gt;
+  &lt;!-- Underline text --&gt;
 <PRE>&lt;U
   &lt;!-- No attributes --&gt;
 &gt;
 </PRE>
+<P>
+  &lt;!-- Overline text --&gt;
+<PRE>&lt;O
+  &lt;!-- No attributes --&gt;
+&gt;
+</PRE>
 <P>
   &lt;!-- Subscript text --&gt;
 <PRE>&lt;SUB
diff --git a/doc/infosrc/html_grammar b/doc/infosrc/html_grammar
index d1699c8e0..e16f20024 100644
--- a/doc/infosrc/html_grammar
+++ b/doc/infosrc/html_grammar
@@ -1,6 +1,6 @@
 label    =  text | table
 text     = textitem | text textitem
-textitem = string | T_&lt;BR/&gt; | T_&lt;FONT&gt; text T_&lt;/FONT&gt; | T_&lt;I&gt; text T_&lt;/I&gt; | T_&lt;B&gt; text T_&lt;/B&gt; | T_&lt;U&gt; text T_&lt;/U&gt | T_&lt;SUB&gt; text T_&lt;/SUB&gt |T_&lt;SUP&gt; text T_&lt;/SUP&gt | T_&lt;S&gt; text T_&lt;/S&gt
+textitem = string | T_&lt;BR/&gt; | T_&lt;FONT&gt; text T_&lt;/FONT&gt; | T_&lt;I&gt; text T_&lt;/I&gt; | T_&lt;B&gt; text T_&lt;/B&gt; | T_&lt;U&gt; text T_&lt;/U&gt | T_&lt;O&gt; text T_&lt;/O&gt | T_&lt;SUB&gt; text T_&lt;/SUB&gt |T_&lt;SUP&gt; text T_&lt;/SUP&gt | T_&lt;S&gt; text T_&lt;/S&gt
 table =  [ T_&lt;FONT&gt; ] T_&lt;TABLE&gt; rows T_&lt;/TABLE&gt; [ T_&lt;/FONT&gt; ]
 rows = row | rows row | rows T_&lt;HR/&gt; row
 row = T_&lt;TR&gt; cells T_&lt;/TR&gt;
-- 
2.40.0