blob: 6ba0a561303087bbc06cfa354e20ba349dd6fa02 [file] [log] [blame]
<!DOCTYPE html>
<html>
<!-- Created by Texinfo 6.8dev+dev, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual is for GNU Texinfo (version 6.8dev, 23 February 2022),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.
Copyright (C) 1988, 1990-1993, 1995-1999, 2001-2022 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled
"GNU Free Documentation License". -->
<title>Multitable Rows (GNU Texinfo 6.8dev)</title>
<meta name="description" content="Multitable Rows (GNU Texinfo 6.8dev)">
<meta name="keywords" content="Multitable Rows (GNU Texinfo 6.8dev)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link href="index.html" rel="start" title="Top">
<link href="Command-and-Variable-Index.html" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Multi_002dcolumn-Tables.html" rel="up" title="Multi-column Tables">
<link href="Multitable-Column-Widths.html" rel="prev" title="Multitable Column Widths">
<style type="text/css">
<!--
div.example {margin-left: 3.2em}
-->
</style>
</head>
<body lang="en">
<div class="subsection-level-extent" id="Multitable-Rows">
<div class="nav-panel">
<p>
Previous: <a href="Multitable-Column-Widths.html" accesskey="p" rel="prev">Multitable Column Widths</a>, Up: <a href="Multi_002dcolumn-Tables.html" accesskey="u" rel="up"><code class="code">@multitable</code>: Multi-column Tables</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h4 class="subsection" id="Multitable-Rows-1">8.5.2 Multitable Rows</h4>
<a class="index-entry-id" id="index-Multitable-rows"></a>
<a class="index-entry-id" id="index-Rows_002c-of-a-multitable"></a>
<a class="index-entry-id" id="index-item-2"></a>
<a class="index-entry-id" id="index-tab"></a>
<p>After the <code class="code">@multitable</code> command defining the column widths (see
the previous section), you begin each row in the body of a multitable
with <code class="code">@item</code>, and separate the column entries with <code class="code">@tab</code>.
Line breaks are not special within the table body, and you may break
input lines in your source file as necessary.
</p>
<a class="index-entry-id" id="index-headitem"></a>
<a class="index-entry-id" id="index-Heading-row_002c-in-table"></a>
<a class="index-entry-id" id="index-_003cthead_003e-HTML_002fXML-tag"></a>
<p>You can also use <code class="code">@headitem</code> instead of <code class="code">@item</code> to produce
a <em class="dfn">heading row</em>. The TeX output for such a row is in bold, and
the HTML and DocBook output uses the <code class="code">&lt;thead&gt;</code> tag. In Info, the
heading row is followed by a separator line made of dashes (&lsquo;<samp class="samp">-</samp>&rsquo;
characters).
</p>
<a class="index-entry-id" id="index-headitemfont"></a>
<a class="index-entry-id" id="index-Font-for-multitable-heading-rows"></a>
<p>The command <code class="code">@headitemfont</code> can be used in templates when the
entries in a <code class="code">@headitem</code> row need to be used in a template. It
is a synonym for <code class="code">@b</code>, but using <code class="code">@headitemfont</code> avoids
any dependency on that particular font style, in case we provide a way
to change it in the future.
</p>
<p>Here is a complete example of a multi-column table (the text is from
<cite class="cite">The GNU Emacs Manual</cite>, see <a data-manual="emacs" href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Split-Window.html#Split-Window">Splitting Windows</a> in <cite class="cite">The GNU Emacs Manual</cite>):
</p>
<div class="example">
<pre class="example-preformatted">@multitable @columnfractions .15 .45 .4
@headitem Key @tab Command @tab Description
@item C-x 2
@tab @code{split-window-vertically}
@tab Split the selected window into two windows,
with one above the other.
@item C-x 3
@tab @code{split-window-horizontally}
@tab Split the selected window into two windows
positioned side by side.
@item C-Mouse-2
@tab
@tab In the mode line or scroll bar of a window,
split that window.
@end multitable
</pre></div>
<p>produces:
</p>
<table class="multitable">
<thead><tr><th width="15%">Key</th><th width="45%">Command</th><th width="40%">Description</th></tr></thead>
<tbody><tr><td width="15%">C-x 2</td><td width="45%"><code class="code">split-window-vertically</code></td><td width="40%">Split the selected window into two windows,
with one above the other.</td></tr>
<tr><td width="15%">C-x 3</td><td width="45%"><code class="code">split-window-horizontally</code></td><td width="40%">Split the selected window into two windows
positioned side by side.</td></tr>
<tr><td width="15%">C-Mouse-2</td><td width="45%"></td><td width="40%">In the mode line or scroll bar of a window,
split that window.</td></tr>
</tbody>
</table>
</div>
<hr>
<div class="nav-panel">
<p>
Previous: <a href="Multitable-Column-Widths.html">Multitable Column Widths</a>, Up: <a href="Multi_002dcolumn-Tables.html"><code class="code">@multitable</code>: Multi-column Tables</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>