File: INSTALL

package info (click to toggle)
tmview 98.06-1
  • links: PTS
  • area: main
  • in suites: slink
  • size: 1,440 kB
  • ctags: 1,903
  • sloc: ansic: 11,865; makefile: 43
file content (162 lines) | stat: -rw-r--r-- 7,364 bytes parent folder | download
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*****************************************************************