home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume3 / xdvi / part01 / README < prev    next >
Encoding:
Text File  |  1989-03-07  |  5.3 KB  |  118 lines
  1. Latest comments are at the end of the file. Add changes there.
  2. ===$Header: README,v 1.2 88/07/22 21:00:33 eichin Exp $===
  3. ================================================================
  4. This directory contains a version of xdvi capable of reading GF, PXL
  5. and PK font files. This version of xdvi is based on the source that
  6. "came with" X v10r3. Xdvi was modified by Paal Kvamme at the Norwegian
  7. Institute of Technology, based on the modifications I had made to
  8. dviimp (a dvi to ImPress converter). This code was again more or less
  9. directly translated from the web source of PKtoPX.
  10.  
  11. If you discover (and fix) any bugs in this code, please notify me, so
  12. I can make the corresponding changes myself.
  13.  
  14. Makefile was modified slightly to suit local conventions (CONFDIR and
  15. INCLUDES).
  16.  
  17. [I threw in an Imakefile, but it's only a guess, as they don't have imake
  18. at our site]--PV
  19.  
  20. ---------
  21. H}vard Eidnes    (TeXish: H\aa vard Eidnes)
  22. Division of Computer Science
  23. Norwegian Institute of Technology
  24.  
  25. E-Mail: h_eidnes%vax.runit.unit.uninett@nta-vax.arpa
  26. ================================================================
  27. Also has path search added by Mark Eichin, looks in XTEXFONTS then TEXFONTS
  28. ================================================================
  29.  
  30. Compilation notes:
  31.     To compile for X10 (non athena, assumes NORMAL X10 system)
  32.         make -f Makefile_10
  33.     To compile for X11 (athena environment)
  34.         make
  35.             _Mark Eichin
  36.             <eichin@athena.mit.edu>
  37.     The X10 flag only affects xdvi.c (and the flags MSBITFIRST, BMSHORT,
  38.     and BMLONG, see below)
  39.  
  40.     You can also change the `make' variables FONTFORMATS_C and FONTFORMATS_O
  41.     to reflect which font formats are actually used at your site.
  42.  
  43. Other compilation flags are:
  44.     FONT_PATH    (xdvi.c)  Name of the environment variable to use when
  45.             searching for the font path
  46.     DEFAULT_FONT_PATH  (xdvi.c)  Name of the default font path to use when
  47.             the above environment variable is not set.
  48.     MSBITFIRST    (X11 only; xdvi.c dvi_draw.c gf.c pk.c pxl.c)  Store
  49.             bitmaps internally with the most significant bit at
  50.             the left.  For performance reasons, it would be best
  51.             to set this to coincide with what your server uses.
  52.             Use the keystroke '^P' to find information in this
  53.             regard.
  54.     BMSHORT        (X11 only; xdvi.c dvi_draw.c gf.c pk.c pxl.c)  Store
  55.             bitmaps in short integers instead of bytes.  See
  56.             MSBITFIRST for other relevant comments.  To check
  57.             performance, you can use:
  58.                 time xdvi -d 8 file.dvi
  59.     BMLONG        (X11 only; xdvi.c dvi_draw.c gf.c pk.c pxl.c)  Store
  60.             bitmaps in long integers instead of bytes.
  61. All flags should be set in the appropriate Makefile.
  62. ================================================================
  63. Additional notes:
  64.     X11 version now works on the IBM PC/RT as well as VAX.
  65.             [eichin:19880313.1330EST]
  66. ================================================================
  67. *MORE* fixes (for athena release locker) [eichin:19880722.2058EST]
  68. Fixes:
  69.     narrow vertical and horizontal lines no longer disappear.
  70.     bogus underlining (which usually occured on even sample sizes
  71. of odd sized characters) no longer occurs.
  72.     -S number (or typing number followed by S) will adjust the
  73. sampling fraction; 0 is special cased to mean if anything in the
  74. sampled zone is set, set the sample, else clear it. Interesting to
  75. experiment with, though not useful for reading (the default value of 3
  76. is just right.)
  77.     -display and -geometry arguments work (so do old style forms,
  78. though they were broken before)
  79.     fixed one of the PK debugging messages to print the correct
  80. font name instead of printing the pointer as text.
  81.     included Ken Raeburn <raeburn>'s changes to support multiple
  82. screens.
  83. ================================================================
  84. More changes:
  85.  
  86.     1.  Incorporated the bitmap under a viewport widget using the toolkit
  87.     (X11 only);
  88.     2.  Added an icon and icon geometry arguments (X11 only);
  89.     3.  Supported window resizing;
  90.     4.  Added a 'c' option to move whatever is currently under the cursor to
  91.     the center of the window;
  92.     5.  Added an 'R' option to reread the .dvi file, and added logic to make
  93.     'R' happen automatically whenever any part of the window is exposed
  94.     and the dvi file changes (so that you can iconify xdvi, run tex,
  95.     deiconify xdvi, and voila!);
  96.     6.  Added a 'magnifying glass':  when you push a button, a window pops
  97.     up, showing the region of the page, unshrunk;
  98.     7.  Added support for gf fonts;
  99.     8.  Upgraded font searching (at our site we use /usr/custom/tex82/gf
  100.     for gf fonts, /usr/custom/tex82/pk for pk fonts, etc.);
  101.     9.  Made numerous internal changes (removed all the lint I could,
  102.     made unshrunk bitmaps permanently resident, which speeds up size
  103.     changing, made table.h necessary only for pxl.h, split up the source
  104.     file into xdvi.c, dvi.c, gf.c, pxl.c, and pk.c, made shrinking occur
  105.     relative to the character's hot point, etc.)
  106. --  Patchlevel 1:  --
  107.    10.  The program reads SIGIO signals and processes incoming events
  108.     immediately, so that it can stop displaying things that would be
  109.     erased anyway.  If these interrupts are not coming through, then
  110.     it also checks for incoming events every several dozen characters
  111.     displayed.
  112. --  Patchlevel 2:  --
  113.    11.  Further split up dvi.c into dvi_init.c and dvi_draw.c; added
  114.     compilation options for various internal bitmap representations.
  115.     Fixed it so gcc won't give warnings, and so it works with R3 toolkit.
  116.  
  117. Paul Vojta, vojta@math.berkeley.edu
  118.