summaryrefslogtreecommitdiff
path: root/dviware/screenview/vms/screenview.hlp
blob: 19343d5df8fc8e04e1f567a5644e5ee9171330b8 (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
! This help file assumes the SCREENVIEW symbol has been created.
1 SCREENVIEW

USAGE:     SCREENVIEW input_file [first_page max_pages magnification]

EXAMPLE:   $ tex foo               ! or latex foo
           $ screenview foo.dvi
           $ set term/width=132    ! depending on the text width
           $ type foo.txt

The SCREENVIEW command translates a given DVI file into a text file
suitable for viewing on any sort of terminal.  It can be useful for
generating on-line documentation from a TeX or LaTeX source.
To try and fit the output lines within 80 columns you will probably
need to change the text width in the TeX or LaTeX source file.
To do this in TeX simply include some commands near the top of your file:

    \hoffset=0in    % for a 1in left margin
    \hsize=4.5in

For LaTeX, a new style called "screen" can be used; simply add it after
any other styles you use:

    \documentstyle[uacs,screen]{article}

The "screen" style sets up appropriate margins and text width, redefines
all the type size commands to \normalsize and all the type style commands
to \tt, then switches to \tt and uses \raggedright.

The file created by SCREENVIEW can also be used to check line-breaks
and page-breaks.  Note that the horizontal and vertical positioning of
text is only roughly approximated.  In particular, the right margin
of paragraphs will usually appear ragged.  Also, characters from non-text
fonts (such as math symbols) will appear incorrect.

If you want to use the parameters after the file name then they must
appear in the right order.  For example, to select pages 5 and 6
you would have to type "SCREENVIEW FOO 5 2".

The magnification parameter is given as a percentage (default is 100)
and controls the horizontal spacing of words.  If the predominant type
size is large, the magnification may need to be reduced, or else the
words will be       badly       spread       out.