<?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_autowidth">
  <refmeta>
    <refentrytitle>dblatex autowidth</refentrytitle>
  </refmeta>
  <refnamediv>
    <refname><sgmltag class="xmlpi">dblatex
             <parameter>autowidth</parameter></sgmltag></refname>
    <refpurpose>Column sizing by LaTeX in
    <sgmltag>segmentedlist</sgmltag> tables</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <programlisting><![CDATA[<?dblatex autowidth="all" ?>]]></programlisting>
  </refsynopsisdiv>
  <refsection>
    <title>Description</title>
    <para>Defines, when <sgmltag>segmentedlist</sgmltag>s are presented
    in tabular form, whether the column widths are automatically sized
    by latex. The allowed values are:</para>
    
    <xi:include href="../tables/table.xml"
                xpointer="xpointer(id('autowidth-items'))"
                xmlns:xi="http://www.w3.org/2001/XInclude" />

    <para>In addition to these keywords,
    <parameter>autowidth</parameter> can also take for its value
    keywords of the form <literal>column:
    <replaceable>N</replaceable><replaceable>
    ...</replaceable></literal>, where <replaceable>N</replaceable> is
    the number of the column (counting from 1) which is to have its
    width automatically sized.  Columns with numbers not referenced,
    and not otherwise sized, will all have widths equally apportioned
    from available space.</para>

    <xi:include href="../params/newtbl.autowidth.xml"
                xpointer="xpointer(id('newtbl-autowidth-and-seglists'))"
                xmlns:xi="http://www.w3.org/2001/XInclude" />

    <para>The <sgmltag class="xmlpi">dblatex
    <parameter>autowidth</parameter></sgmltag> processing instruction
    supersedes column width sizing specified by the <xref
    linkend="default.table.width"/> parameter or <xref
    linkend="pi-dblatex_table-width"/> processing instruction.</para>

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

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

  <refsection>
    <title>See Also</title>
    <itemizedlist>
      <listitem><xref linkend="sec-table-width" /></listitem>
      <listitem><xref linkend="pi-dblatex_table-width"/></listitem>
      <listitem><xref linkend="pi-dblatex_colwidth"/></listitem>
      <listitem><xref linkend="segmentedlist.as.table"/></listitem>
      <listitem><xref linkend="pi-dblatex_list-presentation"/></listitem>
      <listitem><xref linkend="newtbl.autowidth"/></listitem>
      <listitem><xref linkend="default.table.width"/></listitem>
    </itemizedlist>
  </refsection>
</refentry>
