docs: document Table.alignment analysis

Author: Steve Canny

docs/dev/analysis/features/table-props.rst

@@ -3,6 +3,23 @@ Table Properties
 ================
 
 
+Alignment
+---------
+
+Word allows a table to be aligned between the page margins either left,
+right, or center.
+
+The read/write :attr:`Table.alignment` property specifies the alignment for
+a table::
+
+    >>> table = document.add_table(rows=2, cols=2)
+    >>> table.alignment
+    None
+    >>> table.alignment = WD_TABLE_ALIGNMENT.RIGHT
+    >>> table.alignment
+    RIGHT (2)
+
+
 Autofit
 -------
 
@@ -28,12 +45,13 @@ Specimen XML
 
 .. highlight:: xml
 
-The following XML is generated by Word when inserting a 2x2 table::
+The following XML represents a 2x2 table::
 
     <w:tbl>
       <w:tblPr>
         <w:tblStyle w:val="TableGrid"/>
         <w:tblW w:type="auto" w:w="0"/>
+        <w:jc w:val="right"/>
         <w:tblLook w:firstColumn="1" w:firstRow="1" w:lastColumn="0"
                    w:lastRow="0" w:noHBand="0" w:noVBand="1" w:val="04A0"/>
       </w:tblPr>
@@ -151,6 +169,22 @@ Schema Definitions
       <xsd:element name="tblPrChange"         type="CT_TblPrChange"   minOccurs="0"/>
     </xsd:sequence>
 
+  <!-- table alignment --------------------------------- -->
+
+  <xsd:complexType name="CT_JcTable">
+    <xsd:attribute name="val" type="ST_JcTable" use="required"/>
+  </xsd:complexType>
+
+  <xsd:simpleType name="ST_JcTable">
+    <xsd:restriction base="xsd:string">
+      <xsd:enumeration value="center"/>
+      <xsd:enumeration value="end"/>
+      <xsd:enumeration value="left"/>
+      <xsd:enumeration value="right"/>
+      <xsd:enumeration value="start"/>
+    </xsd:restriction>
+  </xsd:simpleType>
+
   <!-- table width ------------------------------------- -->
 
   <xsd:complexType name="CT_TblWidth">