<refentry id="pi-dblatex_colwidth">

  <refmeta>

    <refentrytitle>dblatex colwidth</refentrytitle>

  </refmeta>

  <refnamediv>

    <refname><sgmltag class="xmlpi">dblatex

             <parameter>colwidth</parameter></sgmltag></refname>

    <refpurpose>Specifies a column width for

    <sgmltag>segmentedlist</sgmltag>s presented as tables</refpurpose>

  </refnamediv>

  <refsynopsisdiv>

    <programlisting>]]></programlisting>

  </refsynopsisdiv>

  <refsection>

    <title>Description</title>

    <para>Specifies a column width for the columns of a

    <sgmltag>segmentedlist</sgmltag> when presented as a table.  (See

    <xref linkend="segmentedlist.as.table"/>.)  This is the width of the

    cell content and does not include inter-cell spacing.</para>

    <para>The <parameter>colwidth</parameter> attribute may take any

    of the <sgmltag>colspec</sgmltag>'s

    <parameter>colwidth</parameter> attribute's values.  These

    are:</para>

    <itemizedlist>

      <listitem>

        <para>A valid TeX length (e.g. 4cm).</para>

      </listitem>

      <listitem>

        <para>A proportional width specification of the form

        <replaceable>N</replaceable><literal>*</literal>, where

        <replaceable>N</replaceable>is a positive integer.</para>

      </listitem>

      <listitem>

        <para>A combination of the above

        (e.g. <literal>3*+1cm</literal>).  Spaces are not

        allowed.</para>

      </listitem>

      <listitem>

        <para>Any of the keywords allowed the 

        linkend="default.table.width"/> parameter:

        <literal>autowidth.default</literal>,

        <literal>autowidth.all</literal>, and

        <literal>autowidth.none</literal>.  The first two,

        <literal>autowidth.default</literal> and

        <literal>autowidth.none</literal>, have the same meaning --

        LaTeX determines the width of the column based on the width of

        the widest cell value.  <literal>autowidth.none</literal>

        means the same as <quote><literal>*</literal></quote>,

        proportional spacing.</para>

      </listitem>

    </itemizedlist>

    <para>The <sgmltag class="xmlpi">dblatex

    <parameter>colwidth</parameter></sgmltag> processing instruction supersedes

    any column width specified by the 

    linkend="default.table.width"/> parameter or 

    linkend="pi-dblatex_table-width"/> processing instruction.</para>

    <para id="column-autowidth-defaults">The default depends on

    whether the overall table width is specified.  When there is no

    fixed table width columns default to the LaTeX default, the width

    of the widest cell.  This is the default when no parameters or

    processing instructions are used.  When a fixed table width is

    specified the default is <quote><literal>*</literal></quote>,

    proportional spacing.</para>

  </refsection>

  <refsection>

    <title>Context</title>

    <para>Recognized in the <sgmltag>segtitle</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="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>