diff options
Diffstat (limited to 'Build/source/texk/windvi/INSTALL')
-rw-r--r-- | Build/source/texk/windvi/INSTALL | 126 |
1 files changed, 126 insertions, 0 deletions
diff --git a/Build/source/texk/windvi/INSTALL b/Build/source/texk/windvi/INSTALL new file mode 100644 index 00000000000..ce57c0f4c1b --- /dev/null +++ b/Build/source/texk/windvi/INSTALL @@ -0,0 +1,126 @@ +THIS IS ALPHA QUALITY SOFTWARE! + +Did you read the README file? + +How to install: +1. ./configure --prefix=/texmf-prefix +2. make +3a. If you dare (I wouldn't): make install +3b. If you don't: + cp texk/xdvik/xdvi.bin libs/t1lib/type1afm/type1afm /path/for/bin +4. cp texk/xdvik/texmf/* /usr/local/texmf/share/lib/xdvi + That might not be the right path for you though ( + /usr/local/teTeX/share/texmf/xdvi is another likely path). + See point 5. + PLEASE NOTE that these enc files are different from the ones used + by dvips so they should not be in dvips' way. Please review xdvi.cfg + to see what font maps are appropriate for you. Update the texk + file database (teTeX users run 'texhash'). +5. Ensure that you have a XDVIINPUTS variable in your texmf.cnf or + environment which names the directory you installed the above files + in so xdvi can find them. +6. Read XDVIFONTS to install type1 fonts for xdvi. Probably not needed + in a recent teTeX installation. + +Here is the normal INSTALL file: +------------- + +Installing xdvik is essentially the same as installing any other +Kpathsea-using program. Therefore, for the basic steps involved, the +file `kpathsea/INSTALL'. + +For common problems and information on how to report a bug, see +`kpathsea/BUGS'. + +xdvi-specific items and a terse summary of the steps: + +0.1. If you want the hypertext support (recognition of url specials and +clicking on links), install the W3C reference library and header files +if necessary: http://www.w3.org/pub/WWW/Library/w3c-libwww.tar.gz. The +.h files must be visible to the compiler, so you may have to set the +environment variable CPPFLAGS=-I/usr/local/include/wwwherever. (You may +also be interested in the Java previewer IDVI, available at +@url{http://www.win.tue.nl/~dickie/idvi}.) + +0.2. If you have Aladdin Ghostscript 4.0 or 4.01, get 4.02. Otherwise, +xdvi will not be able to run gs to show included eps files. (You can +fix this bug by adding a line + .clearerror +before the `% Close up systemdict.' comment.) + +1. Run `configure' (in the top-level directory, the one with +subdirectories `kpathsea' and `xdvi'). This guesses system +dependencies. configure --help lists all available options. See +../kpathsea/CONFIGURE for options to the configure script; also run +configure --help. + +By default, Ghostscript is used to render PostScript specials. +To disable this, specify `--without-ps' to configure. +To use Display PostScript instead of gs, specify `--with-ps=dps'. +To use NeWS instead of gs, specify `--with-ps=news'. +(Naturally you must have the dps and news libraries for these to work!) +You can specify more than one --with-ps option if desired; then Ghostscript + is used last. + +To use only Xlib routines, specify `--with-x-toolkit=no' to configure. +Functionality is necessarily reduced. If you are using an HP, IBM, or +other system that does not include the Xaw library by default, consider +installing the freely available X11 distribution, available from +ftp://ftp.x.org and mirrors. + +2. If necessary, change the default paths or other definitions. +See kpathsea/INSTALL for details. + +Things you might want to add to the DEFS or CFLAGS or XCFLAGS Make variables: +-DA4 to get A4 size windows by default. +-DALTFONT=\"myfont\" to change the fallback font from cmr10. +-DBDPI=num to change default resolution to num from 600. +-DMFMODE=\"mode\" to set the default mode. +-DSHRINK=\"num\" to change the default shrink factor (yes, a string) from 6. +-DNOBUTTONS to disable radio buttons for common commands. +-DNOGREY to disable using grayscale to display shrunken bitmaps + (which also works on monochrome monitors). +-DNOQUERY if you have trouble compiling drawingWidgetClass? +-DNOSELFILE to disable SelFile widget support. +-DNOTEXXET to disable DVI opcodes 250 and 251. + +The following can be set according to what xdvi's CONTROL-P command +reports for `bitord' and `Unit' for your most common display: + bitord = 1 => -DMSBITFIRST + Unit = 32 => -DBMLONG + Unit = 16 => -DBMSHORT +If this makes any substantial performance difference in your +environment, please let me know. + +3. `make'. + +4. `make install' (by default, files will be installed under /usr/local). +(Or `make install-exec', to install just the executables, +or `make install-data', to install just the architecture-independent files.) + +5. `make distclean' (or `mostlyclean', or `clean', or `realclean', +depending on how clean you want to be). + +If you wish to preview documents using PostScript fonts, you may find +ftp://ftp.tug.org/tex/psfonts.tar.gz (Ghostscript-generated bitmaps for +the standard 35 PS fonts at multiples of 600dpi) useful. The gsftopk +program that comes with xdvik can generate such bitmaps on the fly; the +distributed MakeTeXPK attempts to do this. + +If problems: + +* See kpathsea/INSTALL for common system-dependent problems. + +* If you run out of file descriptors (``Too many open files''), +typically when MakeTeXPK is invoked, you may need to recompile the +kernel on your system (e.g., SunOS). Alternatively, the ulimit command +might allow you to increase this limit (e.g., Solaris). xdvi tries to +close files as necessary to avoid this, but if you use lots of fonts on +one page, it's unavoidable. + +* SCO: download libXaw from sosco.sco.com:/TLS/tls005.tar.Z. +--lieder@skyler.mavd.honeywell.com + +* Tadpole Sparcbook: Comes with obsolete X11 libraries in + /usr/openwin/lib. You must install more recent libraries. +--ato@bellcore.com |