/usr/share/doc/texinfo/html/Conditional-Commands.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 5.2, 26 September 2013),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.

Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013 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 the Front-Cover Texts being "A GNU Manual",
and with the Back-Cover Texts as in (a) below.  A copy of the license
is included in the section entitled "GNU Free Documentation
License".

(a) The FSF's Back-Cover Text is: "You have the freedom to copy and
modify this GNU manual.  Buying copies from the FSF supports it in
developing GNU and promoting software freedom." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Texinfo 5.2: Conditional Commands</title>

<meta name="description" content="GNU Texinfo 5.2: Conditional Commands">
<meta name="keywords" content="GNU Texinfo 5.2: Conditional Commands">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Command-and-Variable-Index.html#Command-and-Variable-Index" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Conditionals.html#Conditionals" rel="up" title="Conditionals">
<link href="Conditional-Not-Commands.html#Conditional-Not-Commands" rel="next" title="Conditional Not Commands">
<link href="Conditionals.html#Conditionals" rel="previous" title="Conditionals">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {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}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Conditional-Commands"></a>
<div class="header">
<p>
Next: <a href="Conditional-Not-Commands.html#Conditional-Not-Commands" accesskey="n" rel="next">Conditional Not Commands</a>, Up: <a href="Conditionals.html#Conditionals" accesskey="u" rel="up">Conditionals</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Conditional-Commands-1"></a>
<h3 class="section">18.1 Conditional Commands</h3>

<p>Texinfo has an <code>@if<var>format</var></code> environment for each output
format, to allow conditional inclusion of text for a particular output
format.
</p>
<a name="index-ifinfo"></a>
<p><code>@ifinfo</code> begins segments of text that should be ignored by
TeX when it typesets the printed manual, and by <code>makeinfo</code>
when not producing Info output.  The segment of text appears only in
the Info file and, for historical compatibility, the plain text
output.
</p>
<a name="index-ifdocbook"></a>
<a name="index-ifhtml"></a>
<a name="index-ifplaintext"></a>
<a name="index-iftex"></a>
<a name="index-ifxml"></a>
<p>The environments for the other formats are analogous, but without the
special historical case:
</p>
<dl compact="compact">
<dt><code>@ifdocbook &hellip; @end ifdocbook</code></dt>
<dd><p>Text to appear only in the Docbook output.
</p>
</dd>
<dt><code>@ifhtml &hellip; @end ifhtml</code></dt>
<dd><p>Text to appear only in the HTML output.
</p>
</dd>
<dt><code>@ifplaintext &hellip; @end ifplaintext</code></dt>
<dd><p>Text to appear only in the plain text output.
</p>
</dd>
<dt><code>@iftex &hellip; @end iftex</code></dt>
<dd><p>Text to appear only in the printed manual.
</p>
</dd>
<dt><code>@ifxml &hellip; @end ifxml</code></dt>
<dd><p>Text to appear only in the XML output.
</p></dd>
</dl>

<p>The <code>@if&hellip;</code> and <code>@end if&hellip;</code> commands must appear
on lines by themselves in your source file.  The newlines following
the commands are (more or less) treated as whitespace, so that the
conditional text is flowed normally into a surrounding paragraph.
</p>
<p>The <code>@if&hellip;</code> constructs are intended to conditionalize
normal Texinfo source; see <a href="Raw-Formatter-Commands.html#Raw-Formatter-Commands">Raw Formatter Commands</a>, for using
underlying format commands directly.
</p>
<p>Here is an example showing all these conditionals:
</p>
<div class="example">
<pre class="example">@iftex
This text will appear only in the printed manual.
@end iftex
@ifinfo
However, this text will appear only in Info and plain text.
@end ifinfo
@ifhtml
And this text will only appear in HTML.
@end ifhtml
@ifplaintext
Whereas this text will only appear in plain text.
@end ifplaintext
@ifxml
Notwithstanding that this will only appear in XML.
@end ifxml
@ifdocbook
Nevertheless, this will only appear in Docbook.
@end ifdocbook
</pre></div>

<p>The preceding example produces the following line:
</p>
<p>And this text will only appear in HTML.
</p>
<p>Notice that you only see one of the input lines, depending on which
version of the manual you are reading.
</p>
<a name="index-errormsg"></a>
<p>In complex documents, you may want Texinfo to issue an error message
in some conditionals that should not ever be processed.  The
<code>@errormsg{<var>text</var>}</code> command will do this; it takes one
argument, the text of the error message, which is expanded more or
less as if it were Info text.
</p>
<p>We mention <code>@errormsg{}</code> here even though it is not strictly
related to conditionals, since in practice it is most likely to be
useful in that context.  Technically, it can be used anywhere.
See <a href="External-Macro-Processors.html#External-Macro-Processors">External Macro Processors</a>, for a caveat regarding the line
numbers which <code>@errormsg</code> emits in TeX.
</p>

<hr>
<div class="header">
<p>
Next: <a href="Conditional-Not-Commands.html#Conditional-Not-Commands" accesskey="n" rel="next">Conditional Not Commands</a>, Up: <a href="Conditionals.html#Conditionals" accesskey="u" rel="up">Conditionals</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
texinfo-doc-nonfree 5.2.0-1 / usr / share / doc / texinfo / html / Conditional-Commands.html
