README.Debian for whizzytex 
===========================

[Debian LaTeX is now PDFeTex-based]
================================

Debian LaTeX is using PDFeTeX instead of TeX since 3.0

Using the following configuration for .whizzytexrc will 
allow use of PDFeTeX.

INITEX="pdfetex -ini "
LATEX=latex
FORMAT=latex
FMT=fmt

[Default operation requires ADVI]
=================================

whizzytex requires ADVI to operate by default.
It will work with xdvi and other tools. The result is best with ADVI.

If you do not have ADVI installed on your system, whizzytex
will give out an error unless configured. Please consult the manual
on how to change the viewer.

[Recommended reading]
=====================

FAQ is updated quite frequently and documents some workarounds for known
bugs.

  http://cristal.inria.fr/whizzytex/FAQ.html

A copy is included as /usr/share/doc/whizzytex/FAQ.html

[Using Japanese]

You can use Japanese tex files with specifying in ~/.whizzy/whizzy.sh
or ./whizzy.sh (relative to .tex file) (the file names used to be
~/.whizzytexrc and ./.whizzytexrc) as:

INITEX="platex -ini"
LATEX=platex
FORMAT=platex
BIBTEX=jbibtex 
FMT=fmt

or specifying the following in the tex source 
(should work, but does not in v1.1.3 and 1.2.2, should be fixed later)

%; whizzy chapter -initex iniptex -latex platex -format platex -bibtex jbibtex -fmt fmt


Changing color of the cursor
============================

From Bug# 173429:

> The following part is the relevant portion of whizzytex.sty:
> 
> \g@addto@macro \whizzy@beforeauxhook
>    {\@ifundefined {Whizzysafe}
>        {\usepackage{color}\def \whizzy@fbox {\colorbox {yellow}}}
>        {\let \whizzy@fbox \fbox \whizzy@tricksfalse}}
> 
> 
> Changing the above to following will make the cursor red.
> \g@addto@macro \whizzy@beforeauxhook
>    {\@ifundefined {Whizzysafe}
>        {\usepackage{color}\def \whizzy@fbox {\colorbox {red}}}
>        {\let \whizzy@fbox \fbox \whizzy@tricksfalse}}
> 
> 
> It is currently not possible to reconfigure this dynamically, I think.
> It is something I probably would want to make configurable.
> Ideas ?

If you add a file whizzy.sty somewhere in the load path, it will be 
loaded after whizzytex.sty, so it can be used to enrich whizztex.sty
or override some bindings. 

I will add an indirection \WhizzyCursorColor 
to ease such redefinition in the future. Meanwhile, you can used the
formular above. 

Cheers,

        Didier


Configuration compatibility with 1.1.x releases
===============================================

To retain compatibility with 1.1.x releases, Debian package for 1.2 series
is patched to read configuration file from

  /etc/whizzytex/whizzytex.conf
  ~/.whizzytexrc
  ./.whizzytexrc

They are aliases for whizzy.sh; please use whizzy.sh in the future,
the compatibility patch may be dropped from future releases.


LEVEL
=====

From 1.2.x, there is a new undocumented configuration variable LEVEL,
which is set if options such as -advi, -ps are specified.

It is 2 if full-fledged application such as advi is used.
Set it to lower value if cursor position information is 
redundant on the viewer (such as other viewer than advi).


 -- Junichi Uekawa <dancer@debian.org>, Wed,  3 Dec 2008 08:56:47 +0900
