Find a file
Stefan Kebekus eee67d3fe5 source code cleanup
svn path=/trunk/kdegraphics/kdvi/; revision=118480
2001-10-18 16:40:34 +00:00
doc improved documentation 2001-10-01 05:21:51 +00:00
examples New example for bad DVI-File 2000-11-26 12:43:01 +00:00
make somehow make-3.77 doesn't like the stuff out of tetex's Makefiles 1999-06-08 12:15:48 +00:00
pix -> hi 2001-05-11 21:09:29 +00:00
AUTHORS Implemented Hyperlinks 2000-06-11 07:04:57 +00:00
bigEndianByteReader.cpp source code cleanup 2001-10-18 16:40:34 +00:00
bigEndianByteReader.h source code cleanup 2001-10-18 16:40:34 +00:00
c-openmx.h it compiles (and works) under Debian now too 2000-11-25 19:06:22 +00:00
ChangeLog Bernd: KDvi uses KFileDialog now 1998-06-29 06:42:15 +00:00
configure.in.in it compiles (and works) under Debian now too 2000-11-25 19:06:22 +00:00
dvi.h imported kdvi 1997-10-18 11:34:02 +00:00
dvi_init.cpp source code cleanup 2001-10-18 16:40:34 +00:00
dvi_init.h source code cleanup 2001-10-18 16:40:34 +00:00
dviwin.cpp source code cleanup 2001-10-18 16:40:34 +00:00
dviwin.h source code cleanup 2001-10-18 16:40:34 +00:00
dviwin_draw.cpp source code cleanup 2001-10-18 16:40:34 +00:00
font.cpp includemocs kdegraphics 2001-05-04 01:40:07 +00:00
font.h added some warning dialogs; minor bugfixing and enhancements 2001-04-08 09:21:27 +00:00
fontpool.cpp source code cleanup 2001-08-08 12:50:03 +00:00
fontpool.h QList -> QPtrList 2001-09-22 15:34:15 +00:00
fontprogress.cpp includemocs kdegraphics 2001-05-04 01:40:07 +00:00
fontprogress.h added export functionality (DVI -> PS or PDF) 2001-05-03 08:45:04 +00:00
glyph.cpp minor bugfixing 2001-04-14 13:47:21 +00:00
glyph.h kpsewhich now runs concurrently 2001-03-02 21:02:45 +00:00
infodialog.cpp Compile with Qt3 2001-08-31 13:20:42 +00:00
infodialog.h added export functionality (DVI -> PS or PDF) 2001-05-03 08:45:04 +00:00
kdvi - let the shell expand the arguments, if necessary 2001-05-04 21:16:41 +00:00
kdvi.desktop CVS_SILENT 2001-09-22 02:04:40 +00:00
kdvi.h Fixes bugs #21936, #22187, #21997, #21594, #20836, #20619 and #15074 2001-03-15 15:11:36 +00:00
kdvi.lsm * Qt v1.3x etc -> Qt 1999-04-13 16:35:48 +00:00
kdvi_multipage.cpp source code cleanup 2001-10-18 16:40:34 +00:00
kdvi_multipage.h - more kparts factory cleanup 2001-09-12 17:35:46 +00:00
kdvi_part.rc added export functionality (DVI -> PS or PDF) 2001-05-03 08:45:04 +00:00
Makefile.am source code cleanup 2001-10-18 16:40:34 +00:00
oconfig.h QT-ification and C++-ification 2000-02-29 11:27:53 +00:00
optiondialog.cpp CVS_SILENT: fixincludes 2001-10-10 17:57:49 +00:00
optiondialog.h minor bugfixes and improved docu 2001-10-01 05:24:23 +00:00
pk.cpp kpsewhich now runs concurrently 2001-03-02 21:02:45 +00:00
psgs.cpp includemocs 2001-09-25 19:23:14 +00:00
psgs.h kdvi uses the statusbar now 2001-06-11 13:40:16 +00:00
psheader.txt added PSGraphics-cache, source cleanup 2000-06-23 00:22:44 +00:00
README.kdvi * kfm is actually konqueror (more or less). 2000-05-19 20:45:35 +00:00
special.cpp further implementation of inverse search 2001-09-03 08:57:03 +00:00
squeeze.c WABA: Fixed compiler warning 1999-07-24 21:08:11 +00:00
TODO minor bugfixes and improved docu 2001-10-01 05:24:23 +00:00
util.cpp Oops - I forgot these two. 2001-05-08 02:45:03 +00:00
vf.cpp further source code cleanup 2001-08-09 07:35:46 +00:00
xdvi.h further source code cleanup 2001-08-09 07:35:46 +00:00

kdvi 0.4 - Alpha release
~~~~~~~~~~~~~~~~~~~~~~~~

This is a port of xdvik version 18f by many authors (see files AUTHORS)
to the K Desktop Environment. kdvi is used to view TeX DVI files. It is
a replacement of xdvi from tetex-distribution and uses the kpathsea
library to find the needed pk-font files. If you have tetex you should be
able to run kdvi. It requires also Ghostcript to render any postscript
specials in dvi files. kdvi uses the Qt toolkit.

This version is quite useable.


Note.	The make step currently runs configure in the kpathsea subdirectory.
	I may eliminate this in a later version.

If xdvi from tetex works for you then so should kdvi.
However, it has only been tested on Linux. The support for handling the xdvi
command line arguments and X application defaults is missing (partly replaced
by KConfig, see below and online help).
Postscript special handling only supported with Ghostscript.


CONFIGURATION
~~~~~~~~~~~~~

Version 0.4 can be configured through dialogs.

Before giving kdvi a file to open you should set the following entries in Fonts
page of Preferences:

o Resolution	Set this to the base resolution of your printer if you
		have already PK-fonts for printer available.

o MetafontMode  This you can set to match the definition of your printer or
		use the default mode '/'.

It is necessary to set the Resolution as required by your TeX installation.
(tetex stores this usually in /usr/lib/texmf/texmf/xdvi/XDvi). MetafontMode is
needed when you want to enable automatic pk-font generation (menu option).
See online help for more info.

These variables should preferably be set in the system wide configuration file.
The system administrator can set the proper values ( and other settings as
desired ) with kdvi and copy the config file ~/.kde/share/config/kdvirc
to $KDEDIR/share/config/kdvirc. 

You can also specify the paths where your pk-fonts are located, if
kdvi does not find them automatically, by setting entry 'PK Font Path' to
the list of directories to be searched:

/var/lib/texmf/fonts/pk/ljfour/:/some/other/place

You can make kdvi search recursively by adding an extra / at the end of
directory name:

/var/lib/texmf/fonts//

This works like xdvi's XDVIFONTS environment variable.
There is also good (gnu info) documentation available for the kpathsea library
that kdvi uses for font searching.

USAGE:
~~~~~~

The dvi viewer may be started using a file name to display a file, e.g:

	kdvi somepath/paper.dvi

or without a file name as

	kdvi

kdvi will then allow a file to be opened from a dialog or when dropped from
file manager (konqueror).

The usual parameters handled by Qt should also work:

	kdvi -style windows -display :0 -geometry 400x400+0+0


CHANGES:
~~~~~~~~

Version 0.4
~~~~~~~~~~~

-	Antialiased PostScript specials

-	Support session management

-	Changes menu accelerators according to KKeyConfig settings.
	Shortcuts should follow KDE standard.
	
-	Statusbar shows the coordinates of a clicked point in millimeters.

-	Changed build to use automake (not for kpathsea yet)

-	Better print dialog + print setup dialog. Support for dvilj4 and dvips.

-	Automatic reload when dvi file is updated

-	Uses KToolbar, KStatusbar and KTopLevelWidget

-	Command line option '-caption'

-	Uses KIconLoader and KDebugDialog

-	Partial support for translations

-	Many bug fixes

-	Internal changes

-	Miscellanous other changes


Version 0.3
~~~~~~~~~~~

-	Preferences dialog

-	Paper type selectable

-	Configurable key bindings with kkeyconfig (first cut)

-	Works with kdisplay

-	Uses KMsgBox dialogs

-	Sticky popup menus

-	Needs Qt 1.2 ( check marks in menus )

-	Many bug fixes

-	More KDE conforming


Version 0.2	
~~~~~~~~~~~

-	Configuration file uses different variables

-	Status bar and vertical toolbar

-	Added a page list for selecting the current page and marking pages
	for printing.

-	Initial print dialog. Does not support printing of marked pages that
	have page numbers different from the sequence number (pages are not
	numbered as 1,2,3...). Requires dvips for converting dvi to PostScript,
	gv for previewing PS and mpage for printing multiple pages per sheet.
	(These should be replaced by kprogs.)

-	A scroller widget that can also select the next or previous page.

-	Support for new TeX config file format of tetex 4

-	File drops accepted (local files only)

-	Many bug fixes

-	Builds using configure

-	Screen updating reduced and scrolling made smoother.
	This results in kdvi allocating huge amounts of memory when using large
	magnifications.

Version 0.1
~~~~~~~~~~~

First release. Should be quite usable, with some problems on error handling
(bad dvi etc.) and postscript special handling. All enabled menu entries and
toolbar buttons are operational, many keybindings are available (see help)
allthough probably not KDE-conformant (expect changes).