<?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="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="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="autowidth-items"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="../tables/table.xml"
xpointer="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>