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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>
<TITLE>WhizzyTeX Frequently Asked Questions</TITLE>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.08+9 of 2006-01-30">
<STYLE type="text/css">
.toc{list-style:none;}
.title{margin:auto;text-align:center}
.center{text-align:center;margin-left:auto;margin-right:auto;}
.flushleft{text-align:left;margin-left:0ex;margin-right:auto;}
.flushright{text-align:right;margin-left:auto;margin-right:0ex;}
DIV TABLE{margin-left:inherit;margin-right:inherit;}
PRE{text-align:left;margin-left:0ex;margin-right:auto;}
BLOCKQUOTE{margin-left:4ex;margin-right:4ex;text-align:left;}
.part{margin:auto;text-align:center}
</STYLE>
</HEAD>
<BODY >
<!--HEVEA command line is: hevea -o FAQ.html -fix -exec xxdate.exe FAQ.tex -->
<!--HTMLHEAD-->
<!--ENDHTML-->
<!--PREFIX <ARG ></ARG>-->
<!--CUT DEF section 1 -->
<BR>
<TABLE CLASS="title">
<TR><TD>
<H1 CLASS="titlemain"><FONT COLOR="blue">WhizzyTeX</FONT> Frequently Asked Questions</H1>
<H3 CLASS="titlerest">Didier Rmy</H3>
<H3 CLASS="titlerest">Last Modified: April 13, 2006</H3></TD>
</TR></TABLE><BR>
<!--TOC section Contents-->
<H2 CLASS="section">Contents</H2><!--SEC END -->
<UL CLASS="toc"><LI CLASS="li-toc">
<A HREF="#htoc1">1 Where to find it</A>
<LI CLASS="li-toc"><A HREF="#htoc2">2 Is this a Bug?</A>
<LI CLASS="li-toc"><A HREF="#htoc3">3 Known problems</A>
<LI CLASS="li-toc"><A HREF="#htoc4">4 Using WhizzyT<sub>E</sub>X with platex</A>
<LI CLASS="li-toc"><A HREF="#htoc5">5 Using WhizzyT<sub>E</sub>X under Windows</A>
<LI CLASS="li-toc"><A HREF="#htoc6">6 Using Virtual Fonts with Active-DVI</A>
<LI CLASS="li-toc"><A HREF="#htoc7">7 Known bogus latex packages</A>
<UL CLASS="toc"><LI CLASS="li-toc">
<A HREF="#htoc8">7.1 ieee.cls [2000/01/11]</A>
</UL>
</UL>
<!--TOC section Where to find it-->
<H2 CLASS="section"><A NAME="htoc1">1</A> Where to find it</H2><!--SEC END -->
The URL is <A HREF="http://cristal.inria.fr/whizzytex/"><TT>http://cristal.inria.fr/whizzytex/</TT></A><BR>
<BR>
The last major release is 1.3.0
and the stable version is 1.3.0<BR>
<BR>
The last version of the FAQ can be found at
<A HREF="http://cristal.inria.fr/whizzytex/FAQ.html"><TT>http://cristal.inria.fr/whizzytex/FAQ.html</TT></A><BR>
<BR>
<A NAME="isitabug"></A>
<!--TOC section Is this a Bug?-->
<H2 CLASS="section"><A NAME="htoc2">2</A> Is this a Bug?</H2><!--SEC END -->
Before reporting a bug, have you checked that the source file correctly
compiles and previews with the <EM>latex</EM>, <EM>previewer</EM>
and <EM>options</EM> used in WhizzyT<sub>E</sub>X?
(In recent versions of WhizzyT<sub>E</sub>X you may see the previewer's command from
<TT>Emacs</TT> using the menu <TT>View log...</TT> and selecting
<TT>command</TT>.) <BR>
<BR>
You may also check the latex log files (<TT>format</TT>, and
<TT>latex</TT>, <TT>slice</TT>). In particular, <TT>format</TT> will show
you the version of <TT>whizzytex.sty</TT> that has been loaded. Loading an
old version will likely not work! (You may also check the Emacs version of
whizzytex (from the <TT>Help</TT> entry of <TT>Whizzy</TT> menu). <BR>
<BR>
Since the latex <TT>color</TT> package is implicitly loaded, you
should also check the compatibility with this package by
by explicitly including <CODE>\usepackage{color}</CODE> right before the
<CODE>\begin{document}</CODE> (because whizzytex would load this package last)
and checking that it still compiles with <EM>latex</EM>.<BR>
<BR>
In <TT>advi</TT> mode (when option <TT>-advi</TT> is used), the
<TT>advi</TT> package is also implicitly loaded. So you should then also try
to latex your source with the package <TT>advi</TT> explicitly loaded before
all other packages, since some errors may be indirectly due to this
<TT>advi</TT> and not to WhizzyT<sub>E</sub>X itself—then send your bug report
to <A HREF="http://cristal.inria.fr/advi/">Active-DVI</A>.<BR>
<BR>
Also, do not forget to check your version number before repporting a bug.
See the value of variable <TT>whizzytex-mode</TT> in Emacs manually or
through the Emacs on-line documentation of <TT>whizzytex-mode</TT>.
This version number should be identical to the one of
<TT>whizzytex.sty</TT>, which is displayed on the welcoming page when
starting WhizzyTeX, and also to the one of the script <TT>whizzytex</TT>,
which you can check with the shell command <TT>whizzytex -version</TT>.
If these three version numbers do not match, you have a broken
installation, maybe a file of old version takes priority, which you can
solve by deleled the old file or adjusting the corresponding PATH variable.<BR>
<BR>
<!--TOC section Known problems-->
<H2 CLASS="section"><A NAME="htoc3">3</A> Known problems</H2><!--SEC END -->
Fixed refers to last stable version.
<OL CLASS="enumerate" type=1><LI CLASS="li-enumerate">WhizzyT<sub>E</sub>X uses hard links and hence does not work on file systems that do
not support them, such as VFAT.<BR>
<BR>
<LI CLASS="li-enumerate">It has been reported with old versions that sometimes the cursor jumps to the
end of the buffer while typing fast, and the mark is left a few characters
before where the point was when the cursor jumped.<BR>
<BR>
The problem should be <I>Fixed in versions ≥ 1.3.0</I>. <BR>
<BR>
Otherwise, an (imperfect) workaround is to reduce the slicing speed
<EM>e.g.</EM> by the follow setting (you may need to adjust the value):
<PRE CLASS="verbatim">
(setq whizzy-load-factor 0.1)
</PRE><BR>
<BR>
<LI CLASS="li-enumerate">Its does not work with the <CODE>x-symbol</CODE> package.<BR>
<BR>
The <CODE>x-symbol</CODE> package may now work together with WhizzyT<sub>E</sub>X, provided
you have a version of <TT>x-symbol</TT> greater than v4.3.3. However, the
option Page-to-point may still not work (under <CODE>x-symbol</CODE>, the cursor
would be inserted at the end of the buffer instead of at the
current-position). Then, you may use the following alternative.<BR>
<BR>
Alternatively, with (X)Emacs version 21 and above, you may set
<CODE>whizzy-write-annotate</CODE> to nil to tell WhizzyT<sub>E</sub>X not to use
<CODE>write-region-annotation-functions</CODE>. The slice will be write slower, but
in a way so that the <CODE>x-symbol</CODE> package should always be compatible with
WhizzyT<sub>E</sub>X. <BR>
<BR>
You may also wish to set <CODE>'x-symbol-auto-conversion-method</CODE> to
<CODE>'fast</CODE>.<BR>
<BR>
<LI CLASS="li-enumerate">How can a click in the <CODE>advi</CODE> window reposition the point
in the emacs window?<BR>
<BR>
First, you should be using the <CODE>advi</CODE> previewer. Then, check the
documentation of <CODE>advi</CODE>, since bindings may depend on versions. This is
likely to be <CODE>shift-left-mouse</CODE> or <CODE>left-mouse</CODE>.<BR>
<BR>
There might also be a short-cut that temporarily rebinds
<CODE>shift-xxx-mouse</CODE> to <CODE>xxx-mouse</CODE>. This can be toggled by typing
<CODE>e</CODE> in the <CODE>advi</CODE> or by calling <CODE>advi</CODE> with the option
<CODE>-edit</CODE>.
Note that <CODE>shift-midddle-click</CODE> and <CODE>shift-right-click</CODE> (or their
shortcut versions) are used for <CODE>move</CODE> and <CODE>resize</CODE> commands when
WhizzyEditting.</OL>
<!--TOC section Using WhizzyT<sub>E</sub>X with platex-->
<H2 CLASS="section"><A NAME="htoc4">4</A> Using WhizzyT<sub>E</sub>X with platex</H2><!--SEC END -->
WhizzyT<sub>E</sub>X has been designed to work with standard LaTeX.
However, it should also work with other implementations of LaTeX, as long
as they allow the creation of new formats. <BR>
<BR>
As an example, to make it work with <CODE>platex</CODE> you can edit
the script <CODE>whizzytex</CODE> and change some findings as follows
(in the experimental version):
<PRE CLASS="verbatim">
INITEX="platex -ini"
LATEX=platex
FORMAT=platex
BIBTEX=jbibtex
FMT=fmt
</PRE>
<A NAME="cygwin"></A>
<!--TOC section Using WhizzyT<sub>E</sub>X under Windows-->
<H2 CLASS="section"><A NAME="htoc5">5</A> Using WhizzyT<sub>E</sub>X under Windows</H2><!--SEC END -->
WhizzyT<sub>E</sub>X is designed for <CODE>Unix</CODE> plateforms. However, Marciano
Siniscalchi reported that it successfully worked on his
Window plateform under Cygwin (1.5.5-1), using <TT>Cygwin/Xfree 4.3</TT> and
<TT>xdvi</TT> from <TT>tetex 2.0.2-13</TT>.<BR>
<BR>
The following modifications to the <TT>whizzytex</TT> script are
necessary:
<UL CLASS="itemize"><LI CLASS="li-itemize">Fix the <CODE>xdvi</CODE> script by replacing <CODE>xdvi.bin</CODE>
by <CODE>exec xdvi.bin</CODE> on the last line of the script
(as in some Linux distribs).<BR>
<BR>
<LI CLASS="li-itemize">Fix the <CODE>whizzytex</CODE> script by replacing the line
<PRE CLASS="verbatim">
preview() {mv $WHIZZY.dvi $WHIZZY.$VIEW; }
</PRE>with
<PRE CLASS="verbatim">
preview() {cp $WHIZZY.dvi $WHIZZY.$VIEW; rm $WHIZZY.dvi}
</PRE>(Permission to rename the .wdvi file is denied while
<CODE>xdvi</CODE> is displaying it).<BR>
<BR>
<LI CLASS="li-itemize">Replace all occurrences of <TT>ulimit</TT> with <TT>true</TT> as
<TT>ulimit</TT> is not implemented on Cygwin. Then, when WhizzyT<sub>E</sub>X falls
into a loop during latex-ing, which is possible on some input, WhizzyT<sub>E</sub>X
will not be able to get it out. (When such cases occur, you'll have to quit
and restart whizzytex by hand—after your source file has been fixed.)<BR>
<BR>
<LI CLASS="li-itemize">Replace all instances of <TT>wdvi</TT> with <TT>w.dvi</TT>
(as <TT>Yap</TT> automatically adds <TT>.dvi</TT> to a file name
not ending with <TT>.dvi</TT> and then complains about not finding the
file).</UL>
Unfortunately, Cygwin/XFree86 is quite slow compared to XFree86 under
Linux, etc. An alternative is to use a commercial X server, such as
XWin32 from StarNet (www.xwin32.com). MI/X from Microimages
(www.microimages.com) is another alternative, but since it is
XFree86-based, it is not as fast as XWin32.
Performance, even with XWin32, is still inferior to Linux.<BR>
<BR>
<!--TOC subsection Using <TT>yap</TT> instead of <TT>xdvi</TT> under Cygwin-->
<H3 CLASS="subsection">Using <TT>yap</TT> instead of <TT>xdvi</TT> under Cygwin</H3><!--SEC END -->
Gregory Borota has reported much better performances with
<TT>yap</TT> than with <TT>xdvi</TT> under Cygwin.
He has written a small wrapper interface around <TT>yap</TT> to make it look
like <TT>xdvi</TT> for WhizzyT<sub>E</sub>X and patched the source of WhizzyTeX
accordingly. See the README and INSTAL file coming with his
<A HREF="whizzytex-yap-1.1.3-1.0.tgz"><TT>whizzytex-yap-1.1.3-1.0.tgz</TT></A> patch,
<EM>coming with absolutely no warranty</EM>. <BR>
<BR>
See also the detailed
<A HREF="http://hellmund.dk/whizzy.html">installation guide</A> written by
Gunnar Hellmund.<BR>
<BR>
<!--TOC section Using Virtual Fonts with Active-DVI-->
<H2 CLASS="section"><A NAME="htoc6">6</A> Using Virtual Fonts with Active-DVI</H2><!--SEC END -->
<A HREF="http://cristal.inria.fr/advi/">Active-DVI</A>
does not currently handle virtual fonts (when called with virtual fonts, it
usually shows a more or less blank screen). This can be fixed by expanding
virtual fonts with <TT>dvicopy</TT> prior to display as explained on the
Active-DVI FAQ.<BR>
<BR>
In WhizzyT<sub>E</sub>X, this can be done automatically by passing the option
<TT>-dvicopy dvicopy</TT> or equivalently setting
<PRE CLASS="verbatim">
DVICOPY=dvicopy
</PRE>in <TT>.whizzytexrc</TT> configuration file in the working directory.<BR>
<BR>
<!--TOC section Known bogus latex packages-->
<H2 CLASS="section"><A NAME="htoc7">7</A> Known bogus latex packages</H2><!--SEC END -->
<!--TOC subsection ieee.cls [2000/01/11]-->
<H3 CLASS="subsection"><A NAME="htoc8">7.1</A> ieee.cls [2000/01/11]</H3><!--SEC END -->
This package introduced a bug in the redefinition of <CODE>\@xfloaf</CODE>
that makes it incompatible with the <TT>color</TT> package<BR>
<BR>
To fix it, your must redefine it as follows:
<PRE CLASS="verbatim">
\def\@xfloat#1#2{\ifhmode \@bsphack\@floatpenalty -\@Mii\else
\@floatpenalty-\@Miii\fi\def\@captype{#1}\ifinner
\@parmoderr\@floatpenalty\z@
\else\@next\@currbox\@freelist{\@tempcnta\csname ftype@#1\endcsname
\multiply\@tempcnta\@xxxii\advance\@tempcnta\sixt@@n
\@tfor \@tempa :=#2\do
{\if\@tempa h\advance\@tempcnta \@ne\fi
\if\@tempa t\advance\@tempcnta \tw@\fi
\if\@tempa b\advance\@tempcnta 4\relax\fi
\if\@tempa p\advance\@tempcnta 8\relax\fi
}\global\count\@currbox\@tempcnta}\@fltovf\fi
\global\setbox\@currbox \color@vbox \normalcolor \vbox\bgroup
\def\baselinestretch{1}\small\normalsize
\hsize\columnwidth \@parboxrestore}
</PRE>
<!--HTMLFOOT-->
<!--ENDHTML-->
<!--FOOTER-->
<HR SIZE=2><BLOCKQUOTE CLASS="quote"><EM>This document was translated from L<sup>A</sup>T<sub>E</sub>X by
</EM><A HREF="http://pauillac.inria.fr/~maranget/hevea/index.html"><EM>H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A</EM></A><EM>.</EM></BLOCKQUOTE></BODY>
</HTML>
|
