Master/texmf-doc/doc/english/FAQ-en/html/FAQ-entercompmode.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

<head>
<title>UK TeX FAQ -- question label entercompmode</title>
</head><body>
<h3>Entering compatibility mode</h3>
<p/>You run your LaTeX job, and it starts by saying
<blockquote>
<pre>
Entering LaTeX 2.09 COMPATIBILITY MODE
</pre>
</blockquote><p>
followed by lines of asterisks and <code>!!WARNING!!</code>.
<p/>This means that the document is not written in &ldquo;current&rdquo; LaTeX
syntax, and that there is no guarantee that all parts of the document
will be formatted correctly.
<p/>If the document is someone else&rsquo;s, and you want no more than a copy to
read, ignore the error.  The document may fail elsewhere, but as often
as not it will provide a <code>.dvi</code> or <code>.pdf</code> that&rsquo;s
adequate for most purposes.
<p/>If it&rsquo;s a new document you have just started working on, you have been
misled by someone.  You have written something like:
<blockquote>
  <code>\</code><code>documentstyle{article}</code>
</blockquote><p>
or, more generally:
<blockquote>
  <code>\</code><code>documentstyle[</code><em>options</em><code>]{</code><em>class</em><code>}</code>
</blockquote><p>
These forms are (as the warning says) LaTeX 2.09 syntax, and to get rid
of the warning, you must change the command.
<p/>The simple form is easy to deal with:
<blockquote>
  <code>\</code><code>documentstyle{article}</code>
</blockquote><p>
should become:
<blockquote>
  <code>\</code><code>documentclass{article}</code>
</blockquote><p>
The complex form is more difficult, since LaTeX 2.09 &ldquo;options&rdquo;
conflate two sorts of things &mdash; options for the class (such as
<code>11pt</code>, <code>fleqn</code>), and packages to be loaded.
So:
<blockquote>
  <code>\</code><code>documentstyle[11pt,verbatim]{article}</code>
</blockquote><p>
should become:
<blockquote>
  <code>\</code><code>documentclass[11pt]{article}</code><br>
  <code>\</code><code>usepackage{verbatim}</code>
</blockquote><p>
because <code>11pt</code> happens to be a class option, while
<i>verbatim</i> is a package.
<p/>There&rsquo;s no simple way to work out what are class options under
LaTeX 2.09; for <i>article</i>, the list includes <code>10pt</code>,
<code>11pt</code>, <code>12pt</code>, <code>draft</code>,
<code>fleqn</code>, <code>leqno</code>, <code>twocolumn</code> and
<code>twoside</code> &mdash; anything else must be a package.
<p/>Your document may well &ldquo;just work&rdquo; after changes like those above;
if not, you should think through what you&rsquo;re trying to do, and consult
documentation on how to do it &mdash; there are lots of 
<a href="FAQ-tutorialstar.html">free tutorials</a> to help you on your way, if you
don&rsquo;t have access to a LaTeX manual of any sort.
<p/>
<p/><p/><p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=entercompmode">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=entercompmode</a>
</body>