summaryrefslogtreecommitdiff
path: root/dviware/dvii/README
blob: 61030d722afde756e319b4d912bc3e46e579d87b (plain)
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
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