JezK
Edit File: _0040table.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <!-- Created by GNU Texinfo 6.8, https://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.8, 8 June 2021), 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-2021 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>@table (GNU Texinfo 6.8)</title> <meta name="description" content="@table (GNU Texinfo 6.8)"> <meta name="keywords" content="@table (GNU Texinfo 6.8)"> <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="Two_002dcolumn-Tables.html" rel="up" title="Two-column Tables"> <link href="_0040ftable-_0040vtable.html" rel="next" title="@ftable @vtable"> <style type="text/css"> <!-- a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} pre.menu-comment {font-family: serif} pre.menu-preformatted {font-family: serif} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> </head> <body lang="en"> <div class="subsection" id="g_t_0040table"> <div class="header"> <p> Next: <a href="_0040ftable-_0040vtable.html" accesskey="n" rel="next"><code>@ftable</code> and <code>@vtable</code></a>, Up: <a href="Two_002dcolumn-Tables.html" accesskey="u" rel="up">Making a Two-column Table</a> [<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> <span id="Using-the-_0040table-Command"></span><h4 class="subsection">8.4.1 Using the <code>@table</code> Command</h4> <span id="table"></span> <span id="index-Definition-lists_002c-typesetting"></span> <p>Use the <code>@table</code> command to produce a two-column table. This command is typically used when you have a list of items and a brief text with each one, such as a list of definitions. </p> <p>Write the <code>@table</code> command at the beginning of a line, after a blank line, and follow it on the same line with an argument that is an ‘indicating’ command, such as <code>@code</code>, <code>@samp</code>, <code>@var</code>, <code>@option</code>, or <code>@kbd</code> (see <a href="Indicating.html">Indicating Definitions, Commands, etc.</a>). This command will be applied to the text in the first column. For example, <code>@table @code</code> will cause the text in the first column to be output as if it had been the argument to a <code>@code</code> command. </p> <span id="g_t_0040asis"></span><span id="index-asis"></span> <p>You may use the <code>@asis</code> command as an argument to <code>@table</code>. <code>@asis</code> is a command that does nothing: if you use this command after <code>@table</code>, the first column entries are output without added highlighting (“as is”). </p> <p>The <code>@table</code> command works with other commands besides those explicitly mentioned here. However, you can only use predefined Texinfo commands that take an argument in braces. You cannot reliably use a new command defined with <code>@macro</code>, although an <code>@alias</code> (for a suitable predefined command) is acceptable. See <a href="Defining-New-Texinfo-Commands.html">Defining New Texinfo Commands</a>. </p> <span id="index-item-1"></span> <p>Begin each table entry with an <code>@item</code> command at the beginning of a line. Write the text for the first column on the same line as the <code>@item</code> command. Write the text for the second column on the line following the <code>@item</code> line and on subsequent lines. You may write as many lines of supporting text as you wish, even several paragraphs. But only the text on the same line as the <code>@item</code> will be placed in the first column (including any footnotes). You do not need to type anything for an empty second column. </p> <p>Normally, you should put a blank line before an <code>@item</code> line (except the first one). This puts a blank line in the Info file. Except when the entries are very brief, a blank line looks better. End the table with a line consisting of <code>@end table</code>, followed by a blank line. TeX will always start a new paragraph after the table, so the blank line is needed for the Info output to be analogous. </p> <p>For example, the following table highlights the text in the first column with the <code>@samp</code> command: </p> <div class="example"> <pre class="example">@table @samp @item foo This is the text for @samp{foo}. @item bar Text for @samp{bar}. @end table </pre></div> <p>This produces: </p> <dl compact="compact"> <dt><span>‘<samp>foo</samp>’</span></dt> <dd><p>This is the text for ‘<samp>foo</samp>’. </p></dd> <dt><span>‘<samp>bar</samp>’</span></dt> <dd><p>Text for ‘<samp>bar</samp>’. </p></dd> </dl> <p>If you want to list two or more named items with a single block of text, use the <code>@itemx</code> command. (See <a href="_0040itemx.html"><code>@itemx</code>: Second and Subsequent Items</a>.) </p> <p>The <code>@table</code> command (see <a href="#g_t_0040table">Using the <code>@table</code> Command</a>) is not supported inside <code>@display</code>. Since <code>@display</code> is line-oriented, it doesn’t make sense to use them together. If you want to indent a table, try <code>@quotation</code> (see <a href="_0040quotation.html"><code>@quotation</code>: Block Quotations</a>) or <code>@indentedblock</code> (see <a href="_0040indentedblock.html"><code>@indentedblock</code>: Indented text blocks</a>). </p> </div> <hr> <div class="header"> <p> Next: <a href="_0040ftable-_0040vtable.html"><code>@ftable</code> and <code>@vtable</code></a>, Up: <a href="Two_002dcolumn-Tables.html">Making a Two-column Table</a> [<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>