diff options
Diffstat (limited to 'systems/msdos/dviware/xdvi-dos/readme')
-rw-r--r-- | systems/msdos/dviware/xdvi-dos/readme | 268 |
1 files changed, 268 insertions, 0 deletions
diff --git a/systems/msdos/dviware/xdvi-dos/readme b/systems/msdos/dviware/xdvi-dos/readme new file mode 100644 index 0000000000..8f07ff7d51 --- /dev/null +++ b/systems/msdos/dviware/xdvi-dos/readme @@ -0,0 +1,268 @@ +INSTALLATION INSTRUCTIONS + +To install, do the following: + 1. Read the ENVIRONMENT section of xdvi_man.sed to determine the correct + default values for the XDVIFONTS and XDVISIZES environment variables. + Edit the Imakefile or Makefile and change the values of the make + variables DEFAULT_FONT_PATH and DEFAULT_FONT_SIZES to these values. + If your site uses virtual fonts, do the same thing with the + DEFAULT_VF_PATH variable. Note that support of virtual fonts in xdvi + does not include support of built-in Postscript<tm> fonts. + + (Note: for X10 compilation, use Makefile_10 instead of Makefile.) + + You may also wish to change other compilation options; they are + described later in this file. + + 2. make xdvi and try it out. If the settings in step one are incorrect, + you can use the corresponding environment variables to quickly try out + different values. If the values set in step 1 were incorrect, + rm font_open.o and go back to step 1. + + If you get the error that the #include file <stdlib.h> does not exist, + then you should include -DX_NOT_STDC_ENV in the DEFS variable in the + Makefile or Imakefile. In X11R5 or later this problem should not + come up. + + 3. make xdvi.man. + + 4. Install xdvi and xdvi.man. + + + The X10 flag only affects xdvi.c (and the flags MSBITFIRST, BMSHORT, + and BMLONG, see below). + + Note in particular the compilation flags USE_PK, USE_GF, and USE_PXL, + which can be set to reflect which font formats are actually used at + your site. + +Other compilation flags are: + SYSV (dvi_init.c font_open.c xdvi.c) Set for System V + compilation. + VMS Set for VMS compilation. + MSBITFIRST (X11 only; xdvi.c dvi_draw.c gf.c pk.c pxl.c) Store + bitmaps internally with the most significant bit at + the left. For performance reasons, it would be best + to set this to coincide with what your server uses. + Use the keystroke '^P' to find information in this + regard. Generally, you should use MSBITFIRST if and + only if '^P' reports bitord = 1, and BMSHORT/BMLONG + (below) should be set to match whatever '^P' reports + under "Unit =". But, if bitord = byteord, then the + latter setting should not matter much. + BMSHORT (X11 only; xdvi.c dvi_draw.c gf.c pk.c pxl.c) Store + bitmaps in short integers instead of bytes. See + MSBITFIRST for other relevant comments. To check + performance, you can use: + time xdvi -d 8 file.dvi + BMLONG (X11 only; xdvi.c dvi_draw.c gf.c pk.c pxl.c) Store + bitmaps in long integers instead of bytes. + ALTFONT (xdvi.c) Default font to use if the font named in the + dvi file cannot be found. Can be set to NULL. By + default, it is "cmr10". + SEARCH_SUBDIRECTORIES (font_open.c) Enable recursive searching of + subdirectories for font files (* and ** specifiers). + This also enables the TEXFONTS_SUBDIR environment + variable and the DEFAULT_SUBDIR_PATH makefile variable. + XDVIFONTS_ONLY (font_open.c) Never check the TEXFONTS environment + variable. Normally xdvi checks TEXFONTS if the + XDVIFONTS variable is not set. This option is + recommended if the version of TeX in use requires + that the TEXFONTS variable be set. See the relevant + paragraph in xdvi_man.sed for more details. This + option turns off that paragraph. + NOTOOL (X11 only; xdvi.c) Compile using raw X calls. + BUTTONS (xdvi.c) Put radio buttons on the right side of the + window for commonly used commands. + A4 (xdvi.c) Use European size paper by default. + NOQUERY (xdvi.c) Set this if you have trouble compiling the + definition of drawingWidgetClass. + TEXXET (everything) Enables op-codes 250 and 251 (used for + right-to-left languages). + BDPI (xdvi.c) Default number of pixels per inch to use. + GREY (everything) Use greyscale anti-aliasing for + displaying shrunken bitmaps. + MAKEPK (font_open.c) If a font is not found, then try to + call Metafont to create the font. When using this + option, remember to set the paths in MakeTeXPK + correctly for your site, and be sure that the + destination directory for MakeTeXPK appears in your + DEFAULT_FONT_PATH variable. + MAKEPKCMD=\"/usr/local/tex/bin/MakeTeXPK\" (font_open.c) Same as the + above, but this variant explicitly declares which + command to use to create the font. + +All flags should be set in the appropriate Makefile via the variable ``DEFS''. + +================================================================ + + This program is the combined work of many people, including but not +restricted to: + Eric Cooper, CMU + Bob Scheifler, MIT LCS + Paal Kvamme, Norwegian Institute of Technology + H\aa vard Eidnes, Norwegian Institute of Technology + Mark Eichin, MIT SIPB + Paul Vojta, UC Berkeley + Jeffrey Lee, U of Toronto + Donald Richardson, Clarkson Univ. +At the present time, the person to send bug reports to is Paul Vojta, + vojta@math.berkeley.edu. + +In addition to the various comp.sources.x archives, current versions of this +program can also be obtained via anonymous ftp from the following location: + export.lcs.mit.edu [18.24.0.12] file contrib/xdvi.tar.Z +To ease the load on export, you may also check other X archives, for example: + gatekeeper.dec.com [16.1.0.2] file pub/X11/contrib/xdvi.tar.Z + +Paul Vojta, 17 March 1992 + +================================================================ + +Note for IBM RS6000 users: some of the libraries are in non-obvious places: + + libXmu /usr/lpp/X11/Xamples/lib/Xmu/libXmu.a + libXaw /usr/lpp/X11/Xamples/lib/Xaw/libXaw.a + +These should be moved to /usr/lib or some more reasonable place (or use +symlinks), and ditto for the include files, which are initially placed +in /usr/lpp/X11/Xamples/include. + +================================================================ + +Notes of historical nature follow. Most recent changes are listed at the end +of the file. + +================================================================ + +This directory contains a version of xdvi capable of reading GF, PXL +and PK font files. This version of xdvi is based on the source that +"came with" X v10r3. Xdvi was modified by Paal Kvamme at the Norwegian +Institute of Technology, based on the modifications I had made to +dviimp (a dvi to ImPress converter). This code was again more or less +directly translated from the web source of PKtoPX. + +If you discover (and fix) any bugs in this code, please notify me, so +I can make the corresponding changes myself. + +--------- +H}vard Eidnes (TeXish: H\aa vard Eidnes) +Division of Computer Science +Norwegian Institute of Technology + +E-Mail: h_eidnes%vax.runit.unit.uninett@nta-vax.arpa +================================================================ +Also has path search added by Mark Eichin, looks in TEXFONTS +================================================================ + +================================================================ +Additional notes: + X11 version now works on the IBM PC/RT as well as VAX. + [eichin:19880313.1330EST] +================================================================ +*MORE* fixes (for athena release locker) [eichin:19880722.2058EST] +Fixes: + narrow vertical and horizontal lines no longer disappear. + bogus underlining (which usually occured on even sample sizes +of odd sized characters) no longer occurs. + -S number (or typing number followed by S) will adjust the +sampling fraction; 0 is special cased to mean if anything in the +sampled zone is set, set the sample, else clear it. Interesting to +experiment with, though not useful for reading (the default value of 3 +is just right.) + -display and -geometry arguments work (so do old style forms, +though they were broken before) + fixed one of the PK debugging messages to print the correct +font name instead of printing the pointer as text. + included Ken Raeburn <raeburn>'s changes to support multiple +screens. +================================================================ +More changes: + + 1. Incorporated the bitmap under a viewport widget using the toolkit + (X11 only); + 2. Added an icon and icon geometry arguments (X11 only); + 3. Supported window resizing; + 4. Added a 'c' option to move whatever is currently under the cursor to + the center of the window; + 5. Added an 'R' option to reread the .dvi file, and added logic to make + 'R' happen automatically whenever any part of the window is exposed + and the dvi file changes (so that you can iconify xdvi, run tex, + deiconify xdvi, and voila!); + 6. Added a 'magnifying glass': when you push a button, a window pops + up, showing the region of the page, unshrunk; + 7. Added support for gf fonts; + 8. Upgraded font searching (at our site we use /usr/custom/tex82/gf + for gf fonts, /usr/custom/tex82/pk for pk fonts, etc.); + 9. Made numerous internal changes (removed all the lint I could, + made unshrunk bitmaps permanently resident, which speeds up size + changing, made table.h necessary only for pxl.h, split up the source + file into xdvi.c, dvi.c, gf.c, pxl.c, and pk.c, made shrinking occur + relative to the character's hot point, etc.) + 10. The program reads SIGIO signals and processes incoming events + immediately, so that it can stop displaying things that would be + erased anyway. If these interrupts are not coming through, then + it also checks for incoming events every several dozen characters + displayed. + 11. Further split up dvi.c into dvi_init.c and dvi_draw.c; added + compilation options for various internal bitmap representations. + Fixed it so gcc won't give warnings, and so it works with R3 toolkit. +-- Patchlevel 2: -- + 12. Added MAXCHARS compilation option. Eliminated the nonsense with + generating table.h. +-- Patchlevel 3: -- + 13. Added -altfont command line option and SYSV compilation option. +================================================================================ + +4/1989 Modified for System V boxes. -DSYSV compiler option. + +Donald Richardson, donr@crystal.mie.clarkson.edu + +================================================================================ +-- Patchlevel 4: -- + 14. Removed MAXCHARS compilation option. It's automatic now. Made X10 + scrolling smoother. Implemented the moving magnifying glass. +-- Patchlevel 5: -- + 15. Implemented compilation without the toolkit, as well as scrollbars + and tpic support in X10. Also this version should work with color + VAXstations, although overstrike characters will come out incorrectly. + 16. Fixed a bug in gf reading routines: specials at the beginning of + a character def. were not being processed. Thanks to + kevin@amath.washington.edu for a bug report and fix. + 17. Added 'k' keystroke. +-- Patchlevel 6: -- + 18. Added buttons on the right side of the window. + 19. Added -pagewidth and -pageheight command line options and A4 + compilation option. + 20. Added a yet more robust font finding algorithm. +-- Patchlevel 7: -- + 21. Replaced -pagewidth and -pageheight options with -paper. +-- Patchlevel 8: -- + 22. Added compatibility for X11R4 and VMS. Fixed up alignment of rules. +-- Patchlevel 9: -- + 23. Removed obsolete '#' and '=' options from the X11 version: they + interfere with emacs. +-- Patchlevel 10: -- + 24. Implemented arrow keys, expert mode, searching for the font's actual + size first, the -[xy]offset and -sw options, and numerous bug fixes. +-- Patchlevel 11: -- + 25. Implemented recursive searching for font files in subdirectories. + 26. Changed +sw to -hushspecials and implemented -hush. + 27. Modified mksedscript so that the man page comes out neater. + 28. Added a -keep option and resource to match the `k' keystroke. +-- Patchlevel 12: -- + 29. Implemented virtual fonts (this does not include built-in + Postscript<tm> fonts!!!). + 30. X11R5 support, and numerous bug fixes. +-- Patchlevel 13: -- + 31. Added support for TeXXeT. +-- Patchlevel 14: -- + 32. Added support for greyscale anti-aliasing. +-- Patchlevel 15: -- + 33. Added support for MakeTeXPK, as in dvips. +-- Patchlevel 16: -- + 34. In the code for greyscale anti-aliasing, try to allocate a colormap + so that GXor operations can be used for drawing. Also interpolate + between foreground and background colors. + +Paul Vojta, vojta@math.berkeley.edu |