Directory dviware/dvii

This is the README file for dvii [version 0.44]

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

1. INTRODUCTION

dvii is a utility written in C that extracts information from a TeX
dvi file and displays it on the command line. Information displayed
can include a summary:

  File comment (usually the date file was compiled)
  File size
  Number of (physical) pages
  Number of fonts

as well as more detailed information: 

  Font names for all fonts used
  List of physical page number/TeX page number pairs
  List of all \specials and the page on which they appear
  List of all fonts on a per page basis


More information can be found at the dvii home page

         http://www.macrotex.net/dvii/dvii.html

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

2. INSTALLATION

   2a. Executables

   Currently, the following executables are available at the dvii web
   site http://www.macrotex.net/dvii/dvii.html

      * DOS
      * Win32   (Windows 95/98/ME/NT/2000)
      * Solaris (Sparc)
      * Solaris (x86)
      * Linux   (x86)

   2b. Compiling (if you cannot find an appropriate executable)

     1. What you need

        To compile, you need to have a C compiler along with the
        standard C libraries, in particular, 

             stdio.h
             sys/types.h
             sys/stat.h
             stdlib.h
             string.h
             limits.h

        These libraries are standard and should be on any system
        with an ANSI C compiler installed (e.g. gcc). 

     2. Do the compile
 
       Example. If you have gcc, type

           gcc dvii.c -o dvii.exe   (assuming DOS/Windows platform)
           gcc dvii.c -o dvii       (assuming Unix platform)


       If you are compiling on a 64-bit machine, do the following: 

           gcc -DSIXTY_FOUR_BIT dvii.c -o dvii

     3. Problems with compiling

       Here are some problems you may encounter when trying to
       compile: 

       * You get an error message that ...

   2c. Installing the executable

     Place the executable file (dvii.exe in the case of DOS/Windows,
     dvii in the case of Unix) anywhere in the execution PATH. That's
     it! 


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

3. TO DO

* Write better read_*_byte routines (use fread()?)

* Output fonts in ascending (rather than descending) order.


CTAN: put all files in tex-archive/dviware/dvii