<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<refentry id="pi-dblatex_table-width">
  <refmeta>
    <refentrytitle>dblatex table-width</refentrytitle>
  </refmeta>
  <refnamediv>
    <refname><sgmltag class="xmlpi">dblatex
             <parameter>table-width</parameter></sgmltag></refname>
    <refpurpose>Control the Automatic Width of a Table</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <programlisting><![CDATA[<?dblatex table-width="12cm" ?>]]></programlisting>
  </refsynopsisdiv>
  <refsection>
    <title>Description</title>
    <para>Set the width of a table. Used only when there is at least
    one column in the table without a fixed width, the
    <parameter>table-width</parameter> has precedence over other
    determinants of a table's width.</para>

    <para>The <parameter>table.width</parameter> takes the values
    allowed for the <xref linkend="default.table.width" /> param, plus
    more. The values shared with <xref linkend="default.table.width"
    /> are:</para>

    <xi:include href="../tables/table.xml"
                xpointer="xpointer(id('table-width-format'))"
                xmlns:xi="http://www.w3.org/2001/XInclude" />
  </refsection>

  <refsection>
    <title>Automatic Column Width</title>

    <xi:include href="../tables/table.xml"
                xpointer="xpointer(id('pi-autowidth'))"
                xmlns:xi="http://www.w3.org/2001/XInclude" />

    <para>The <replaceable>scope</replaceable> can take the following values,
    like in the <parameter>newtbl.autowidth</parameter> parameter:</para>

    <xi:include href="../tables/table.xml"
                xpointer="xpointer(id('autowidth-items'))"
                xmlns:xi="http://www.w3.org/2001/XInclude" />

    <xi:include href="../tables/table.xml"
                xpointer="xpointer(id('pi-autowidth-column'))"
                xmlns:xi="http://www.w3.org/2001/XInclude" />

    <para>There is no default.</para>
  </refsection>

  <refsection>
    <title>Context</title>
    <para>Recognized in the <sgmltag>table</sgmltag> element.</para>
  </refsection>

  <refsection>
    <title>See Also</title>
    <itemizedlist>
      <listitem><xref linkend="sec-table-width" /></listitem>
      <listitem><xref linkend="sec-newtbl-autowidth2" /></listitem>
      <listitem><xref linkend="default.table.width" /></listitem>
      <listitem><xref linkend="newtbl.autowidth" /></listitem>
    </itemizedlist>
  </refsection>
</refentry>
