<?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="table.in.float">
<refmeta>
<refentrytitle>table.in.float</refentrytitle>
</refmeta>
<refnamediv>
<refname><parameter>table.in.float</parameter></refname>
<refpurpose>Use or emulate a float to display a formal table?</refpurpose>
</refnamediv>
<refsynopsisdiv>
<programlisting><xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="syn/table.in.float.xml"/></programlisting>
</refsynopsisdiv>
<refsection>
<title>Description</title>
<para id="floating_table_def">Determines whether formal tables
float. Floating tables do not necessarily appear in the output
document in the location in which they appear in the DocBook
input, they may move when this improves the overall document
layout. Non-floating tables always appear in the rendered
document in the same place as they appear in the input DocBook
document.</para>
<para id="nonfloating_table_desc">Informal tables never float.
Tables that do not float are processed using the
<package>longtable</package> package. Unlike the methods used to
process floating tables, tables processed with
<package>longtable</package> may span page boundaries. Floating
tables may not cross page boundaries and so may not be larger than
a single page.</para>
<para id="longtable_limits">The <package>longtable</package>
package is limited in that titles must be positioned at the top of
the table. This limits the positioning of non-floating table
titles to the top of the table.</para>
<para>When <parameter>table.in.float</parameter> is
<literal>0</literal> formal tables do not float.</para>
<para>The default is <literal>1</literal>, formal tables
float.</para>
</refsection>
</refentry>