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
|
*****************************************************************************
******these are the INSTALLation hints for tmview v98.06*********************
*****************************************************************************
Part 1: linux/svgalib
Part 2: Unix/X
Part 3: OS2/PM (removed)
*****************************************************************************
******linux/svgalib**********************************************************
*****************************************************************************
To install tmview on a linux/svgalib system you may follow the steps ...
1. Get svgalib running.
For the case your svgalib supports standard-vga only, you may want
to use the 640x480x16 mode. For that case use the compile-time
option "MECK". This option makes tmview use the mentioned mode only,
so the -d command-line option will be ignored. It also makes tmview
a bit slow. So do use "MECK" only if neccersary. See below about
compiling tmview.
Since tmview normaly uses 256-color-modes only, and since you want
more than a 320x200-pixel screen, standard vga won't be very
usefull. There is a program called vgatest which comes with
svgalib. It tells you, which modi are available on your system. Make
sure, that your favorite 256-color-mode works. To make tmview use
that mode, set the variable $GSVGAMODE or use the
command-line-option '-dXxY' where X is the width and Y the hight,
both in pixels.
NOTE: higher resolutions result in slower viewing. So even if I'm
proud off 1024x768x256 running on my old fashioned 14"-screen-
386SX-machine, it does not make much sence to use this mode with tmview.
2. Use the precompiled binary dvisvga.linux
To do so, just copy the precompiled ./tmview/dvisvga.linux to a suitable
directory, that is /usr/bin or /usr/local/bin by my opinion. Since the
binary is in ELF-format it won't run on a.out systems. So on those systems
recompiling is neccersary (see step 3.) !
Take some dvi-file and enjoy. To be sure, try with the '-d320x200' option
first, which uses only standard (no super) vga capabilities. If you get
warnings about wrong lib-versions, you have to compile tmview at your site,
to get linked to your dlls. See step 3. for how to compile tmview. You may
now find the command-line-options of tmview to go with your TeX-setup,
i.e. pk-file naming, pk-file-paths and tfm-file-paths. Since tmview saves
any options to a startup-file (default "~/.dvisvga") just play along until
you are satisfied, then set the startup-file to read-only and/or copy it
to somewhere save. See README for details. To be shure, you may want to
edit the defaults in ./tmview/svga/defsavga.h and recompile.
3. Compiling tmview.
All compile-time-options can be found in ./tmview/svga/defssvga.h. But be
careful, only change those which are marked therefore. There are some
options in defssvga.h which make tmview go with linux/svgalib in general, so
they must not be changed. To compile, copy the file ./tmview/MakeSVGA to
./tmview/Makefile, make ./tmview the current directory and run 'make'. This
should result in a new executable binary ./tmview/dvisvga. Like with any
other program using svgalib, the superuser flag has to be set. The 'make'
will try to do this for you, so you have to be 'root' at compile-time.
*****************************************************************************
******Unix/X*****************************************************************
*****************************************************************************
I just found a book about Xlib and played along ... the only possible reason
for you to use tmview with X (instead of xdvi) is "searching with regular
expressions", "setting bookmarks" and such. Do not even think about tmview,
if you are using eps pictures and other postscript stuff. Do not try to
get tmview running under X on a Unix which is not Linux/XFree or Solaris/Openwindows,
unless you are an expert. However, since tmview only uses the Xlib routines it should
not be too hard to get it running on other systems. If you've managed this, let me
know and send your patches for a true X support of tmview.
To install tmview on a X system you may follow the steps ...
1. Compiling tmview.
There are two Makefiles, namely MakeLX (linux/XFree) and MakeSolaris (Solaris/Openwindows)
which I've tested on the indicated plattforms. There should be no problem for the linux stuff
(everything GNU = evereything fine?). On Solaris some requirements are need to be checked:
a.) I only tried GNU gcc, GNU binutils etc.
b.) get the GNU regex-package since others wont do.
Copy regex.o to ./tmview/obj/sol.regex.o
Copy regex.h to ./tmview/lX/regex.h
c.) get kpathsea headers & libs (contained in the teTeX sources)
d.) carefully check the directories specified in the Makefile
Most compile-time-options can be found in ./tmview/lX/defslx.h or
./tmview/lX/defssolaris.h But be careful, only to change those which are marked therefore.
There are some options in defs*.h which make tmview going with Xlib in general, so
they must not be changed. To compile, copy the file ./tmview/Make* to
./tmview/Makefile, make ./tmview the current directory and run 'make'. This
should result in a new executable binary ./tmview/dvilx.linux or ./tmview/dvilx.solaris
Note: tmview runs fine, if the depth of your screen is known at
compiletime. Because of my poor equipment (linux on a pc, no fancy
X-terminals) this is only tested for 8bit and 16bit screens.
See the file ./tmview/lX/writelx.c to set things up for your needs.
To watch the what's going on, when tmview tries to find its way to the
XServer, setting up colors, asking for fonts and so, set DEBUGX in
writelx.c .
2. Running tmview
Take some dvi-file and enjoy ... for the case it shows up a window at all.
This will be on the default display/screen, set in the environmente
variable DISPLAY. Sorry, for not having a commandline option. This will
be done soon.
If you don't get a tmview-window, use the DEBUGX option in
./tmview/lX/writelx.c (see step 1.) .
The following resources are asked by tmview:
DviLX.geometry: standard geometry, f.e. 600x300+10+20
DviLX.foreground: dvi foreground, f.e. black
DviLX.background: dvi backgrounf, f.e. white
DviLX.sforeground: statusline foreground, f.e. tomato4
DviLX.sbackground: statusline background, f.e. OldLace
DviLX.sfont: statusline font, f.e.
-b&h-lucidatypewriter-medium-*-*-*-14-*-*-*-*-*-*-*
Note: The sfont should be a fixed-width-font.
The file ./tmview/lX/DviLX is an example for tmview app-defaults.
*****************************************************************************
******OS2/PM*****************************************************************
*****************************************************************************
The OS2/PM part of tmview was removed in V 98.06, since I dont have any
machine runnuing OS2 anymore.
*******************************************************************************
End of INSTALL*****************************************************************
|