home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Meeting Pearls 3
/
Meeting_Pearls_III.iso
/
Pearls
/
texmf
/
config
/
ShowDVI.help.engl
< prev
next >
Wrap
Text File
|
1993-03-03
|
22KB
|
630 lines
#menu (0, 63, 31) Project
This menu includes all facilities
concerning DVI-file access and
handling of other programs.
#menu (0, 0, 31) about
opens an inforation window.
After displaying the copyright
notice it gives access to a set
of help pages.
Pressing the 'OK' gadget of the
<RETURN> key will close the window.
shortcut character: HELP-Taste
#menu (0, 1, 31) ""
formatting blank line
#menu (0, 2, 31) open again
An allready loaded DVI-file will be
reloaded. This will normally by used
for restauring a recompiled file.
shortcut character: a (ARexx: loadagain)
#menu (0, 3, 31) open new
Opens a file requester for selecting
a new DVI-file.
Uses the 'req.library'.
shortcut character: AMIGA-O (ARexx: loadnew)
#menu (0, 4, 31) auto load again
Toggles the "auto load again" feature.
With "auto load again" set on, every time the
ShowDVI window becomes active, it will test
if the current DVI-file has been recreated.
In that case it will be reloaded.
shortcut character: AMIGA-A
#menu (0, 5, 31) save as iff
Save the current page as IFF file.
If you use as file name "CLIP.2", the
page will be saved into clipboard unit 2.
#menu (0, 6, 31) ""
formatting blank line
#menu (0, 7, 31) shell commands -->
This submenu includes all actions concerning
extern programs.
#menu (0, 7, 0) new cli
Opens a CLI window on the ShowDVI screen.
Using OS2.0 the new shell will be started
asynchronously. That means, that you can
proceed using ShowDVI even when the CLI
window is open.
shortcut character: !
#menu (0, 7, 1) Execute Command
Opens a string requester for entering a
CLI comand, that will be executed. For
its IO a window will be opened on the
ShowDVI-Screen, which can be closed by
using the close-button or typing CTRL-\.
This facility requires OS 2.0.
shortcut character: AMIGA-E
#menu (0, 7, 2) TeX-script
Executes the shell script of the name defined in the file
'ShowDVI.config'. Setting now is '%s'.
If the environment variable TEXFORMATS is not set, ShowDVI
will ask for a format file. (If this function is called by pressing
the 'R' key, the format file will be asked every time.) The
shell script is called with three comand line options
(.key filename/a,directory/a,screenname/k): the name of the
currently loaded TeX file, its directory and the name of the
public screen (%s) on which the IO window will
be opened. This window can be closed by using the close-button
or typing CTRL-\.
This facility requires OS 2.0.
shortcut character: r oder R
#menu (0, 7, 3) ARexx TeX-Shell
Invoces an ARexx script of the name defined in the file
'ShowDVI.config'. Setting now is '%s'.
This script drives the comunication between the editor,
TeX and ShowDVI.
First one will be asked for the name of a public screen.
Using the default '%s' an window on ShowDVIs screen
will come up. Entering 'Workbench' will
open a window on the Workbench screen. The name of the
screen will be passed to the ARexx script as comand line
parameter.
This facility requires OS 2.0.
The ARexx-Script can also be invoced in a CLI window
on the workbench using OS 1.3.
#menu (0, 7, 4) change ENV:TEXFORMAT
Asks for a format-file name and assigns the
environment variable TEXFORMATS to it.
This variable is evaluated by the 'r'
comand, the ARexx scripts as well
as by 'virtex'.
This facility requires OS 2.0.
#menu (0, 7, 5) SpecialHost
Starts the program 'SpecialHost', that handles
the \special TeX directive. Depending on the
configuration of the program it will open
a window on the ShowDVI screen or on the
workbench.
This facility requires OS 2.0.
#menu (0, 8, 31) ""
formatting blank line
#menu (0, 9, 31) print page
This selection prints the currently displayed
page (of course a DVI-file must be loaded).
It will use the printer driver selected in
the prefences.
An allready printed page will be interrupted
by a second invocation of this menu item.
The printing process will be indicated by a 'P'
on the right handside of the titlebar. In that
case the current page cannot be switched.
shortcut character: p (ARexx: printpage)
#menu (0, 10, 31) ""
formatting blank line
#menu (0, 11, 31) WB to front
Switches to the workbench screen.
shortcut character: d (ARexx: wbtofront)
#menu (0, 12, 31) Hide
Drops back the ShowDVI screen.
shortcut character: ESC (ARexx: toback)
#menu (0, 13, 31) Save config
Saves the current settings (actual resolution,
color values etc.) in the file 'ShowDVI.config'.
This file will usually be located in the
directory 'TeX:config' unless the environment
variable 'TEXCONFIG' overrides this.
shortcut character: AMIGA-W (Arexx: saveconfig)
#menu (0, 14, 31) ""
formatting blank line
#menu (0, 15, 31) Quit
Leaves the program after acknowledgement.
To do this, all windows created by ShowDVI
(like a CLI window) must be closed before.
The program SpecialHost is special, in that
it receives a message from ShowDVI to inform
it to quit. Hence it need not be closed
explicitely.
CTRL-C leaves the program without
acknowledgement.
shortcut character: AMIGA-Q (ARexx: exit)
#
#menu (1, 63, 31) Outfit
This menue deals with the
outfit of ShowDVI.
#menu (1, 0, 31) copy
Copy the current page into the clipboard.
#menu (1, 1, 31) ""
formatting blank line
#menu (1, 2, 31) lace
Toggles between interlace and
non interlace mode.
shortcut character: i (ARexx: togglelace)
#menu (1, 3, 31) scroll bar
Toggles the scrollbars at the
right and lower edge of the window.
shortcut character: o (ARexx: togglescrollbar)
#menu (1, 4, 31) full page
Toggles between 'full-page' and
normal display mode.
In 'full-page' mode the actual page is
shrinked to fit on the ShowDVI screen.
The character 'F' on the right of the
titlebar indicates the 'full-page' mode.
shortcut character: f (ARexx: fullpage)
#menu (1, 5, 31) measure window
Opens and closes the 'Measure Window', in
which the page size, the mouse position
and the scale factors are displayed.
To get numbers corresponding to the
lengths of the printed page, one must
multily them with the magnification (/1000).
Dragging the mouse with the left button pressed
will display the distance form the current
mouse position to the place where the
button was pressed.
The used unit can be set with the 'Unit'
menu item.
shortcut character: m
#menu (1, 6, 31) border line
Toggles the dispaly of the 'border-line'.
These lines mark the margins set up
by 'hoffset' and 'voffset' (default:
1 inch) and the security bounaries
for 'overfull box'es (allways 1 inch).
shortcut character: l
#menu (1, 7, 31) ""
formatting blank line
#menu (1, 8, 31) "Set margins"
Set a margin point with the mouse
after activating of the menu entry.
You can set the top left point of
your DVI-file.
You can cancel this with acivating
the point again.
shortcut character: M
#menu (1, 9, 31) 4 color screen
Switches between a two and
four color screen.
#menu (1, 10, 31) ""
formatting blank line
#menu (1, 11, 31) unit -->
This submemu allows the user to select
the unit in which any size will be
displayed.
#menu (1, 11, 0) inch
Selects as unit 1'' (inch).
1 inch = 72.27 pt = 2.54 cm
#menu (1, 11, 1) cm
Selects as unit 1cm (centimeter).
1 cm = 28.54 pt
#menu (1, 11, 2) pt
Selects as unit 1pt (point).
This unit is not often used in common
life. For typsetting purposes may be
very helpful though. In TeX the default
fontsize is 10pt.
1 pt = 0.0351 cm = 65536 sp (intern TeX unit)
#menu (1, 12, 31) color
A color requestor will pop up.
One can now select the colors of the
ShowDVI screen. To save the choise
invoce the menu item 'save-config'.
Requires the 'req.library'.
shortcut character: AMIGA-C
#menu (1, 13, 31) clone wb color
Set the colors of the ShowDVI screen
to the colors of the workbench screen.
#menu (1, 14, 31) Screen Prefs
Opens a window, in which you can change
the size of the ShowDVI screen.
This facility requires OS 2.0 (KS 37.x).
shortcut character: AMIGA-X
#
#menu (2, 63, 31) Move
Main menu handling page switches
of the currently loaded DVI-file.
#menu (2, 0, 31) prev page
Switches to previous page.
BACKSPACE will display the same part of
the page as of the current page, whereas
'-' will allways go to the end of the page.
shortcut character: BACKSPACE, - (ARexx: prev)
#menu (2, 1, 31) next page
Switches to next page.
RETURN will display the same part of
the page as of the current page, whereas
'+' will allways go to the start of the page.
shortcut character: RETURN, ENTER, + (ARexx: next)
#menu (2, 2, 31) first page
Jumps to the first page of the document.
shortcut character: SHIFT pressed with BACKSPACE or -
(ARexx: first)
#menu (2, 3, 31) last page
Jumps to the last page of the document.
shortcut character: SHIFT pressed with RETURN, ENTER or +
(ARexx: last)
#menu (2, 4, 31) ""
formatting blank line
#menu (2, 5, 31) "--page jump counter--"
The following two menu items deal with the
'page-jump-counter'. This is a 4digit number
that can be entered with the numerical keys
0-9 and is displayed in the right of the
titlebar. If it is set up by entering a
number it will be used for page switching.
#menu (2, 6, 31) jump to PJC
The 'page-jump-counter' is a 4digit number
that can be entered with the numerical keys
0-9 and is displayed in the right of the
titlebar. If it is set up by entering a
number it will be used for page switching.
For example the keystrokes '4' '+' will
increment the pagenumber by 4.
Using 'jump-to-PJC' will cause to jump to
the entered mumber. Hence '4' '.' will
display page 4.
shortcut character: . oder g (ARexx: goto <nr>)
#menu (2, 7, 31) clear PJC
Clears the 'page-jump-counter' PJC.
For information about the PJC confer
help text for menu item 'jump-to-PJC'.
shortcut character: c
#menu (2, 8, 31) ""
formatting blank line
#menu (2, 9, 31) "--use phy numbers--"
Usually ShowDVI uses 'logical' page numbers. These are the
numbers that TeX printes on the pages. In some cases there
may be textes that use the same (logical) pagenumber for
different slices of paper. (ShowDVI will display the number
of this logical page number after the gadget '#' that shows
the logical number.)
To properly handle those types of text ShowDVI can be told
to use physical numbering. I.e. the first page in the DVI-file
becomes page number 1 whatever pagenumber is printed on it.
This mode will be marked by the character 'Y' on the right
of the titelbar.
#menu (2, 10, 31) use order of dvi-file
This menu item toggles between the two numbering method supported
by ShowDVI. In 'logical' numbering ShowDVI learns the pagenumbers
that are set up in the DVI file, whereas in 'physical' numbering
the pagenumbers are derived from the order of the pages in the
DVI file. In 'physical' numbering it is assured that every
pagenumber is uniq, but these numbers may differ from the numbers
on the actual pages.
The 'physical' numbering is indicated by the character 'Y' on the
right of the titelbar. One may save this setting in the
configuration file.
For more information confer the help text about the page
numbering menu item (not selectable).
shortcut character: y
#menu (2, 11, 31) prev page
Jumps to the 'physically' previous page.
The 'physical' numbering will be invoced
only temporarily for this operation.
This temporary activation can be forced
for any page switching if the CTRL key
is pressed at the same time.
shortcut character: CTRL pressed with BACKSPACE or -
#menu (2, 12, 31) next page
Jumps to the 'physically' next page.
The 'physical' numbering will be invoced
only temporarily for this operation.
This temporary activation can be forced
for any page switching if the CTRL key
is pressed at the same time.
shortcut character: CTRL pressed with
RETURN ENTER or +
#menu (2, 13, 31) first page
Jumps to the 'physically' first page.
The 'physical' numbering will be invoced
only temporarily for this operation.
This temporary activation can be forced
for any page switching if the CTRL key
is pressed at the same time.
shortcut character: CTRL und SHIFT pressed
with BACKSPACE or -
#menu (2, 14, 31) last page
Jumps to the 'physically' last page.
The 'physical' numbering will be invoced
only temporarily for this operation.
This temporary activation can be forced
for any page switching if the CTRL key
is pressed at the same time.
shortcut character: CTRL und SHIFT pressed
with RETURN ENTER or +
#
#menu (3, 63, 31) resolution
The menu 'resolution' handles the
switching of the resoltion for
the displaying of the text.
The items of this menu are defined
in the file 'ShowDVI.config'.
#menu (3, 0, 31) reso menu
Changes the resolution of
the display to %ld DPI.
shortcut character: AMIGA-1
#menu (3, 1, 31) reso menu
Changes the resolution of
the display to %ld DPI.
shortcut character: AMIGA-2
#menu (3, 2, 31) reso menu
Changes the resolution of
the display to %ld DPI.
shortcut character: AMIGA-3
#menu (3, 3, 31) reso menu
Changes the resolution of
the display to %ld DPI.
shortcut character: AMIGA-4
#menu (3, 4, 31) reso menu
Changes the resolution of
the display to %ld DPI.
shortcut character: AMIGA-5
#menu (3, 5, 31) reso menu
Changes the resolution of
the display to %ld DPI.
shortcut character: AMIGA-6
#menu (3, 6, 31) reso menu
Changes the resolution of
the display to %ld DPI.
shortcut character: AMIGA-7
#menu (3, 7, 31) reso menu
Changes the resolution of
the display to %ld DPI.
shortcut character: AMIGA-8
#menu (3, 8, 31) reso menu
Changes the resolution of
the display to %ld DPI.
shortcut character: AMIGA-9
#menu (3, 9, 31) reso menu
Changes the resolution of
the display to %ld DPI.
#menu (3, 10, 31) reso menu
Changes the resolution of
the display to %ld DPI.
#menu (3, 11, 31) reso menu
the display to %ld DPI.
zu %ld DPI.
#
#helpwindow 12
#help 0, 12
10 5 "Welcome to the On-Line Help of ShowDVI!"
10 6 "_______________________________________"
10 20 "The goal of this page and the following ones is to give"
10 30 "the user a short overview to the functions of the program."
10 45 "Nevertheless it is recommended to read the documentation"
10 55 "of the program, that comes with it."
10 70 "The first 9 help pages can be accessed directly with the"
10 80 "keys 1-9."
10 95 "If you are using Kickstart Version 37.x, you can take"
10 105 "advantage of more On-Line help:"
10 120 "Just select one menu item and realeas the mousebutton"
10 130 "while pressing the HELP key."
#help 1, 14
10 5 "Importand hot keys"
10 7 "___________________"
10 20 "f - displays the full page on one screen"
10 30 "i - toggles the interlace mode"
10 40 "o - toggles the scrollbars"
10 50 "s - toggles the mode of the richt scrollbar"
10 60 "c - clears the 'page jump counter' (PJC)"
10 70 "g/. - jumps to the page set up by the (PJC)"
10 80 "a - reloads the actual DVI file"
10 90 "p - invoces/stops the printing of the current page"
10 100 "[0-9] - sets the (PJC)"
10 110 "ENTER/RETURN - jumps (PJC) pages vorward"
10 120 "-/BACKSPACE - jumps (PJC) pages back"
10 130 "AMIGA q/^C - quits the program"
#help 2, 12
10 5 "Page switching"
10 7 "______________"
10 20 "The following keys will switch to the next page:"
10 30 "RETURN, + and ENTER. The keys of the numeric pad will"
10 40 "jump to the beginning of the next page."
10 55 "The following keys will switch to the previous page:"
10 65 "BACKSPACE and -. The keys of the numeric pad will"
10 75 "jump now to the end of the previous page."
10 90 "The keys SPACE and 'b' allow you to scroll within one"
10 100 "page (like the utility more). Pressing those keys when"
10 110 "the border of a page was reached will cause ShowDVI"
10 120 "to switch to the next (or previous) page"
#help 3, 13
10 5 "Page switching using the 'PJC'"
10 7 "_______________________________"
10 20 "The PJC (page-jump-counter) enables one to easily perform"
10 30 "long jumps in a DVI file."
10 45 "The numeric keys 0-9 are used to set up the PJC. Its"
10 55 "value will be displayed on the right of the titlebar."
10 65 "Clearing the counter is done with the 'c' key."
10 80 "Any page switching will take use of the PJC. Is the"
10 90 "PJC for example set to 15, RETURN will cause to go"
10 100 "15 pages further."
10 110 "The keys 'g' and '.' will display the page that has"
10 120 "been set up in the PJC. If it was for example again"
10 130 "15 pressing 'g' will take you to page 15."
#help 4, 13
10 5 "Physical page numbering"
10 7 "_______________________"
10 20 "ShowDVI knows two types of page numbering."
10 30 "In the 'logical' mode (default) ShowDVI learns the numbers"
10 40 "of the DVI file, i.e. the \pageno on the TeX pages."
10 50 "In the 'physical' mode ShowDVI renumbers the pages"
10 60 "following their order in the DVI file."
10 75 "One can switch between both modes with the key 'y'."
10 85 "If the mode is set to 'physical' the letter 'Y' will be"
10 95 "displayed in the titlebar."
10 110 "Pressing CTRL together with any page changing key will"
10 120 "temporarilly switch to the 'physical' numbering for this"
10 130 "change of page."
#help 5, 14
10 5 "Special features of the right scrollbar"
10 7 "_______________________________________"
10 20 "The right scrollbar allows to change the pagenumber in"
10 30 "two different ways."
10 43 "One way is to drag the scrollbar to the very bottom and"
10 53 "doubleclick the arrow-down gadget."
10 63 "The same will work for the opposite direction."
10 75 "The other possibility is called the page-scroll mode."
10 85 "It is selected by pressing the 's' key. Draging the"
10 95 "scrollbar will no longer affect the displayed part of"
10 105 "the page. Instead pagenumbers will appear on the scoll"
10 115 "body. So just select the desired page and press RETURN,"
10 125 "'+', ENTER etc. Pressing 's' another time will leave"
10 135 "this mode."
#help 6, 13
10 5 "Evaluation of \special strings"
10 7 "______________________________"
10 20 "\special strings are used to implement for example graphics"
10 30 "in TeX or other special things. These strins must be"
10 40 "evaluated by the drivers for the DVI files. ShowDVI and"
10 50 "DVIprint use their own way of doing this: They send the"
10 60 "unchanged string to the program 'SpecialHost', which"
10 70 "does the actual evaluation and returns the result back."
10 80 "To do this the program 'SpecialHost' must run in the"
10 90 "background."
10 105 "Up to the time of writing 'SpecialHost' can copy IFF"
10 115 "images into the text and evaluate TPIC specials,"
10 125 "which might have been generated by EEPIC."
#help 7, 14
10 5 "The (ARexx) TeX-Server"
10 7 "______________________"
10 20 "The TeX-Server can be started via the menu entry"
10 30 "'Shell Commands -> ARexx TeX Shell'"
10 40 "(You can start this server in every CLI window with"
10 50 "the command 'rx TeX:rexx/TeX-Server'."
10 60 "Now it is possible to call virtex with one function key"
10 70 "from ShowDVI or from your editor."
10 80 "But first you must configure ShowDVI und your editor."
10 90 "E.g. write in the 'ShowDVI.config' file:"
98 103 "f2 TeX:rexx/Start_TeX.sd"
98 113 "F2 TeX:rexx/Start_TeX.sd ?"
10 126 "(In the 2. case you will always asked always which format"
10 136 "file you want to use.) See the docs to the ARexx scripts."
#help 8, 12
10 5 "Used files"
10 6 "__________"
10 20 "The following files are used by ShowDVI:"
10 35 "ShowDVI.config This is the configuration file that can be"
170 45 "saved with AMIGA-w. Some items like the"
170 55 "function key definitions must be changed"
170 65 "via editor, though."
10 75 "ShowDVI.fnt informs ShowDVI where to seek pk fonts."
10 85 "ShowDVI.help contains the help textes like the one you"
170 95 "are currently reading."
10 105 "ShowDVI.log logfile usually created by ShowDVI. Can"
170 115 "be omitted via comand line options."
#help 9, 12
10 5 "Environment variables"
10 7 "_____________________"
10 20 "The following ENV: variables are used by ShowDVI:"
10 35 "SHOWDVI for setting up default comandline options"
10 45 "TEXCONFIG directory to use instead of 'Tex:config'."
10 55 "FLIBDIR list of directories for font libraries."
10 65 "PKDIR list of directories for pk-files."
10 80 "Using OS 2.0 ShowDVI additionally sets up the local"
10 90 "variables 'ShowDVI-file' and 'ShowDVI-dir'. They are set"
10 100 "to the name of the actual DVI-file and its directory."
10 115 "Finaly ShowDVI might set up the variable 'TEXFORMAT',"
10 125 "which is used by some TeX scripts."
#help 10, 14
10 5 "The ARexx-Port:"
10 6 "_______________"
10 20 "The name of the port is 'showdvi'. Hence a ARexx script"
10 30 "may contact ShowDVI with "address 'showdvi'"."
10 40 "The extension for ARexx scripts that are called from"
10 50 "ShowDVI is '.sd'."
10 63 "Presently ShowDVI knows about the following ARexx comands:"
10 75 "first, last, prev, next, goto, tofront, toback, wbtofront,"
10 85 "fullpage, printpage, setdir, loadnew, loadagain, getdir,"
10 95 "getfile, getpage, togglelace, togglescrollbar, setcolor,"
10 105 "setresolution, beep, message, refresh, screen, spawn,"
10 115 "version, saveconfig, activate, getstring, getnumber,"
10 125 "getpubscreenname, okay1, okay2, menu, exit."
10 136 "For more information confer the documentation."
#help 11, 9
10 5 "Miscellanous:"
10 7 "_____________"
10 20 "ShowDVI catches three signals:"
10 35 "CRTL-C immediat end of program."
10 45 "CTRL-E put ShowDVI screen to front."
10 55 "CTRL-F put ShowDVI screen to front and reload"
120 65 "the current DVI-File."
10 80 "Leaving the program with the 'Q' key will realease the"
10 90 "memory for this text."
#end