summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html')
-rw-r--r--Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html31
1 files changed, 17 insertions, 14 deletions
diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html
index 523555173f4..d6c30e7683f 100644
--- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html
+++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html
@@ -27,7 +27,7 @@
<li><a href="#a1.2">1.2 Differences. Important!</a>
<ul>
<li><a href="#a1.2.1">1.2.1 LuaLaTeX, fontspec,<br><span style="visibility:hidden">1.2.1 </span>utf-8, Open Type</a></li>
- <li><a href="#a1.2.2">1.2.2 $ = dollar, not math mode</a></li>
+ <li><a href="#a1.2.2">1.2.2 Beware of $, %, and Others</a></li>
<li><a href="#a1.2.3">1.2.3 TeX Size Commands<br><span style="visibility:hidden">1.2.3 </span>Are Disabled</a></li>
<li><a href="#a1.2.4">1.2.4 Raster Images Only</a></li>
<li><a href="#a1.2.5">1.2.5 Academic Structure Disabled</a></li>
@@ -108,7 +108,7 @@
</li>
<li><a href="#a1.6.6">1.6.6 General Text Styling</a>
<ul>
- <li>\charscale, {\somefont...}, \forceindent, \backindent, \hangindent, \acronym, \decoglyph, \squeeze, \crush, \color, \textcolor, \memo, $, \nfs, \nbs</li>
+ <li>\charscale, {\somefont...}, \forceindent, \backindent, \hangindent, \acronym, \decoglyph, \squeeze, \crush, \color, \textcolor, \memo, \nfs, \nbs</li>
</ul>
</li>
<li><a href="#a1.6.7">1.6.7 Some other LaTeX Commands</a>
@@ -139,7 +139,7 @@
<div id="main">
<a id="thetop"></a>
<h1>Documentation for <code>novel</code> document class</h1>
-<p>Documentation version: 1.34.</p>
+<p>Documentation version: 1.36.</p>
<div class="pagetopage">
<p><b>User Guide</b></p>
@@ -246,10 +246,19 @@
<a id="a1.2.2"></a>
-<h4 style="clear:both">1.2.2 A dollar is a dollar, not math mode</h4>
+<h4 style="clear:both">1.2.2 Beware of $, %, and Other TeX Special Characters</h4>
-<p><img class="floatright" src="html-resources/trdol.png" width="238" height="67" alt="a dollar is a dollar"> When you type <code>$</code> in the document body, with or without a preceding backslash, <em>you do not enter or leave math mode</em>. What you get is the dollar symbol. This has no effect in the Preamble, where the dollar sign has its usual TeX special meaning.</p>
-<p>If you really need math mode, you can use <code>\(</code> ... <code>\)</code>. But, why? You are writing a novel, yes? You shouldn't need math mode.</p>
+<p><b>Alert:</b> This was not correctly explained in earlier documentation.</p>
+
+<p><img class="floatright" src="html-resources/trdol.png" width="238" height="67" alt="dollar is math mode"> TeX has a number of special characters. If you type them in a document, they will not appear as an ordinary printed character, but will do something else. These are:</p>
+
+<p class="code"><code>$ % # _ ^ & ~ \ { }</code> and sometimes <code>[ ]</code></p>
+
+<p>In most cases, an incorrect usage will provide an error message that can be easily deciphered. However, the dollar sign and percent symbol are tricky. Incorrect use of the dollar sign may either place your text in math mode (not your intent) or produce a baffling error message that points to an innocent package. The percent symbol normally produces no error, since it is a comment character. But then, whatever text follows on that line will be missing from your PDF.</p>
+
+<p>Special characters, other than the backslash, are escaped by placing a backslash in front, thus: <code>\$</code> for the dollar sign, <code>\%</code> for percent. If you must print a backslash, <code>\string\</code> does it.</p>
+
+<p>To avoid unforeseen problems, you should review your document in a text editor, prior to compiling. Search for any instances of special characters, particularly dollar and percent. Backslash them as needed.</p>
<a id="a1.2.3"></a>
@@ -444,7 +453,7 @@
<p style="clear:none;">Do not let the many Preamble settings intimidate you. All of them are pre-configured with default values that were carefully chosen for use in fiction. You may not need to write many settings.</p>
-<p style="clear:none;">Since <code>novel</code> is specifically intended for fiction, such as novels and collections of short stories, it does not implement many of the commands familiar to academic writers. In some cases, where such commands would interfere with <code>novel</code> commands, the academic commands have been entirely disabled. In particular, the dollar symbol <code>$</code> means a dollar, not math mode, once the document body begins.</p>
+<p style="clear:none;">Since <code>novel</code> is specifically intended for fiction, such as novels and collections of short stories, it does not implement many of the commands familiar to academic writers. In some cases, where such commands would interfere with <code>novel</code> commands, the academic commands have been entirely disabled.</p>
<a id="a1.5.1"></a>
@@ -658,7 +667,7 @@
<p>These commands are further explained in file <a href="noveldocs-07-documentbody.html">noveldocs-07-documentbody.html</a>.</p>
-<p>Note that standard font size commands, such as \small and \Large, are disabled. Also, the dollar sign is a dollar, not math mode.</p>
+<p>Note that standard font size commands, such as \small and \Large, are disabled.</p>
<a id="a1.6.1"></a>
@@ -786,9 +795,6 @@
<pre class="noindentcmd">\memo{<em>text</em>}</pre>
<p>Ignores its argument, which does not print.</p>
-<pre class="noindentcmd">$ (dollar symbol)</pre>
-<p>In document body: <code>$</code> means dollar, not math mode.</p>
-
<pre class="noindentcmd">\nfs<br>\nbs</pre>
<p>These are abbreviations for the lengths <em>normal font size</em> and <em>normal baseline skip</em>.</p>
@@ -862,9 +868,6 @@
<p>These commands are disabled or ineffective. Depending on the command, it may silently do nothing, or simply echo its argument, or generate a Warning or Error. Some of these commands are part of standard LaTeX document classes, but others are part of widely-used packages.</p>
<p>There are other commands that <em>should</em> be disabled, but it is difficult to keep track of all of them. This list only includes some popular commands.</p>
-<pre class="noindentcmd">$ (dollar symbol)</pre>
-<p>A dollar is a dollar, not math mode.</p>
-
<pre class="noindentcmd">\small \LARGE and other font sizes</pre>
<p>You may use <code>\charscale</code> or the <code>parascale</code> environment.</p>