summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html')
-rw-r--r--Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html56
1 files changed, 27 insertions, 29 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html
index 30103c78d98..cc49be9f75f 100644
--- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html
+++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html
@@ -1,17 +1,17 @@
<head>
<title>UK TeX FAQ -- question label conditional</title>
</head><body>
-<h3>Conditional compilation and &ldquo;comments&rdquo;</h3>
-<p/>While LaTeX (or any other TeX-derived package) isn&rsquo;t really like a
+<h3>Conditional compilation and &#8220;comments&#8221;</h3>
+<p/>While LaTeX (or any other TeX-derived package) isn&#8217;t really like a
compiler, people regularly want to do compiler-like things using it.
-Common requirements are conditional &lsquo;compilation&rsquo; and &lsquo;block
-comments&rsquo;, and several LaTeX-specific means to this end are available.
+Common requirements are conditional &#8216;compilation&#8217; and &#8216;block
+comments&#8217;, and several LaTeX-specific means to this end are available.
<p/>The simple <code>\</code><code>newcommand{<code>\</code><code>gobble</code>}[1]</code><code>{</code><code>}</code>
-and <code>\</code><code>iffalse</code><code> ... </code><code>\</code><code>fi</code> aren&rsquo;t really satisfactory (as
+and <code>\</code><code>iffalse</code><code> ... </code><code>\</code><code>fi</code> aren&#8217;t really satisfactory (as
a general solution) for comments, since the matter being skipped is
nevertheless scanned by TeX, not always as you would expect. The
-scanning imposes restrictions on what you&rsquo;re allowed to skip; this may
-not be a problem in <em>today&rsquo;s</em> job, but could return to bite you
+scanning imposes restrictions on what you&#8217;re allowed to skip; this may
+not be a problem in <em>today&#8217;s</em> job, but could return to bite you
tomorrow. For an example of surprises that may come to bite you,
consider the following example (derived from real user experience):
<blockquote>
@@ -23,19 +23,19 @@ use \verb+\iftrue+ -- a surprise
</pre>
</blockquote><p>
The <code>\</code><code>iftrue</code> is spotted by TeX as it scans, ignoring the
-<code>\</code><code>verb</code> command; so the <code>\</code><code>iffalse</code> isn&rsquo;t terminated by the
+<code>\</code><code>verb</code> command; so the <code>\</code><code>iffalse</code> isn&#8217;t terminated by the
following <code>\</code><code>fi</code>. Also, <code>\</code><code>gobble</code> is pretty inefficient at
consuming anything non-trivial, since all the matter to be skipped is
copied to the argument stack before being ignored.
<p/>If your requirement is for a document from which whole chapters (or
the like) are missing, consider the LaTeX
-<code>\</code><code>include</code>/<code>\</code><code>includeonly</code> system. If you &lsquo;<code>\</code><code>include</code>&rsquo; your
-files (rather than <code>\</code><code>input</code> them &mdash; see
-<a href="FAQ-include.html">What&rsquo;s going on in my <code>\</code><code>include</code> commands?</a>),
-LaTeX writes macro traces of what&rsquo;s going on at the end of each
+<code>\</code><code>include</code>/<code>\</code><code>includeonly</code> system. If you &#8216;<code>\</code><code>include</code>&#8217; your
+files (rather than <code>\</code><code>input</code> them &#8212; see
+<a href="FAQ-include.html">What&#8217;s going on in my <code>\</code><code>include</code> commands?</a>),
+LaTeX writes macro traces of what&#8217;s going on at the end of each
chapter to the <code>.aux</code> file; by using <code>\</code><code>includeonly</code>, you can give
LaTeX an exhaustive list of the files that are needed. Files that
-don&rsquo;t get <code>\</code><code>include</code>d are skipped entirely, but the document
+don&#8217;t get <code>\</code><code>include</code>d are skipped entirely, but the document
processing continues as if they <em>were</em> there, and page, footnote,
and other numbers are not disturbed. Note that you can choose which
sections you want included interactively, using the
@@ -44,7 +44,7 @@ sections you want included interactively, using the
allows you to exclude a (list of) <code>\</code><code>include</code>d files from your
document, by means of an <code>\</code><code>excludeonly</code> command.
<p/>If you want to select particular pages of your document, use Heiko
-Oberdiek&rsquo;s <i>pagesel</i> or the <i>selectp</i> packages. You
+Oberdiek&#8217;s <i>pagesel</i> or the <i>selectp</i> packages. You
can do something similar with an existing PDF document (which
you may have compiled using <i>pdflatex</i> in the first place),
using the <i>pdfpages</i> package. The job is then done with a
@@ -83,7 +83,7 @@ for browsing; there are <code>narrowversion</code> and
<code>wideversion</code> for the two versions of the file.
<p/><i>version</i> offers similar facilities to <i>comment.sty</i>
(i.e., <code>\</code><code>includeversion</code> and <code>\</code><code>excludeversion</code> commands);
-it&rsquo;s far &ldquo;lighter weight&rdquo;, but is less robust (and in particular,
+it&#8217;s far &#8220;lighter weight&#8221;, but is less robust (and in particular,
cannot deal with very large areas of text being included/excluded).
<p/>A significant development of <i>version</i>, confusingly called
<i>versions</i> (i.e., merely a plural of the old package name).
@@ -91,9 +91,9 @@ cannot deal with very large areas of text being included/excluded).
<code>\</code><code>markversion{</code><em>version-name</em><code>}</code> which defines an environment
that prints the included text, with a clear printed mark around it.
<p/><i>optional</i> defines a command <code>\</code><code>opt</code>; its first argument is
-an &lsquo;inclusion flag&rsquo;, and its second is text to be included or
+an &#8216;inclusion flag&#8217;, and its second is text to be included or
excluded. Text to be included or excluded must be well-formed
-(nothing mismatched), and should not be too big &mdash; if a large body of
+(nothing mismatched), and should not be too big &#8212; if a large body of
text is needed, <code>\</code><code>input</code> should be used in the argument.
The documentation (in the package file itself) tells you
how to declare which sections are to be included: this can be done in
@@ -125,9 +125,9 @@ environments named in its argument. So, for example:
</pre>
</blockquote><p>
<p/>A further valuable twist is offered by the <i>extract</i> package.
-This allows you to produce a &ldquo;partial copy&rdquo; of an existing document:
-the package was developed to permit production of a &ldquo;book of
-examples&rdquo; from a set of lecture notes. The package documentation
+This allows you to produce a &#8220;partial copy&#8221; of an existing document:
+the package was developed to permit production of a &#8220;book of
+examples&#8221; from a set of lecture notes. The package documentation
shows the following usage:
<blockquote>
<pre>
@@ -143,27 +143,25 @@ which will cause the package to produce a file <i>foobar.tex</i>
containing all the <code>figure</code> and <code>table</code>
environments, and the <code>\</code><code>chapter</code> and <code>\</code><code>section</code> commands, from
the document being processed. The new file <i>foobar.tex</i> is
-generated in the course of an otherwise ordinary run on the &lsquo;master&rsquo;
+generated in the course of an otherwise ordinary run on the &#8216;master&#8217;
document. The package provides a good number of other facilities,
including (numeric or labelled) ranges of environments to extract, and
an <code>extract</code> environment which you can use to create complete
-ready-to-run LaTeX documents with stuff you&rsquo;ve extracted.
+ready-to-run LaTeX documents with stuff you&#8217;ve extracted.
<dl>
-<dt><tt><i>askinclude.sty</i></tt><dd>Distributed with Heiko Oberdiek&rsquo;s packages &mdash;
- <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/oberdiek.zip">macros/latex/contrib/oberdiek</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/oberdiek/">browse the directory</a>)
+<dt><tt><i>askinclude.sty</i></tt><dd>Distributed as part of <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/oberdiek.zip">macros/latex/contrib/oberdiek</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/oberdiek/">browse the directory</a>); <a href="http://www.tex.ac.uk/tex-archive/help/Catalogue/entries/askinclude.html">catalogue entry</a>
<dt><tt><i>comment.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/comment.zip">macros/latex/contrib/comment</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/comment/">browse the directory</a>)
-<dt><tt><i>excludeonly.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/misc/excludeonly.sty">macros/latex/contrib/misc/excludeonly.sty</a>
+<dt><tt><i>excludeonly.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/excludeonly.zip">macros/latex/contrib/excludeonly</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/excludeonly/">browse the directory</a>)
<dt><tt><i>extract.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/extract.zip">macros/latex/contrib/extract</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/extract/">browse the directory</a>)
<dt><tt><i>memoir.cls</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/memoir.zip">macros/latex/contrib/memoir</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/memoir/">browse the directory</a>)
<dt><tt><i>optional.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/misc/optional.sty">macros/latex/contrib/misc/optional.sty</a>
-<dt><tt><i>pagesel.sty</i></tt><dd>Distributed with Heiko Oberdiek&rsquo;s packages &mdash;
- <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/oberdiek.zip">macros/latex/contrib/oberdiek</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/oberdiek/">browse the directory</a>)
+<dt><tt><i>pagesel.sty</i></tt><dd>Distributed as part of <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/oberdiek.zip">macros/latex/contrib/oberdiek</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/oberdiek/">browse the directory</a>); <a href="http://www.tex.ac.uk/tex-archive/help/Catalogue/entries/pagesel.html">catalogue entry</a>
<dt><tt><i>pdfpages.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/pdfpages.zip">macros/latex/contrib/pdfpages</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/pdfpages/">browse the directory</a>)
<dt><tt><i>selectp.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/misc/selectp.sty">macros/latex/contrib/misc/selectp.sty</a>
-<dt><tt><i>verbatim.sty</i></tt><dd>Distributed as part of <a href="http://www.tex.ac.uk/tex-archive/macros/latex/required/tools.zip">macros/latex/required/tools</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/required/tools/">browse the directory</a>)
+<dt><tt><i>verbatim.sty</i></tt><dd>Distributed as part of <a href="http://www.tex.ac.uk/tex-archive/macros/latex/required/tools.zip">macros/latex/required/tools</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/required/tools/">browse the directory</a>); <a href="http://www.tex.ac.uk/tex-archive/help/Catalogue/entries/verbatim.html">catalogue entry</a>
<dt><tt><i>version.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/misc/version.sty">macros/latex/contrib/misc/version.sty</a>
<dt><tt><i>versions.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/versions/versions.sty">macros/latex/contrib/versions/versions.sty</a>
-<dt><tt><i>xcomment.sty</i></tt><dd>Distributed as part of <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/seminar.zip">macros/latex/contrib/seminar</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/seminar/">browse the directory</a>)
+<dt><tt><i>xcomment.sty</i></tt><dd>Distributed as part of <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/seminar.zip">macros/latex/contrib/seminar</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/seminar/">browse the directory</a>); <a href="http://www.tex.ac.uk/tex-archive/help/Catalogue/entries/xcomment.html">catalogue entry</a>
</dl>
<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=conditional">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=conditional</a>
</body>