From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- dviware/textool/textool.l | 224 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 224 insertions(+) create mode 100644 dviware/textool/textool.l (limited to 'dviware/textool/textool.l') diff --git a/dviware/textool/textool.l b/dviware/textool/textool.l new file mode 100644 index 0000000000..9ae203ddeb --- /dev/null +++ b/dviware/textool/textool.l @@ -0,0 +1,224 @@ +.TH TEXTOOL 1 +.SH NAME +textool \- TeX previewer for suntools +.SH SYNOPSIS +.B textool +[ +.B \-p +] [ +.B \-P +] [ +.B \-b +] [ +.B \-m +.I +] [ \+n ] [dvifile[.dvi]] +.SH DESCRIPTION +.LP +The +.I textool +program displays a TeX DVI file in a SunView window. +It is an enhanced version of the old "dvisun" command. +It can be driven either by keyboard commands typed into its window +or by using the mouse and various menus. +The label along the top of the window gives the current working directory, +the current filename and the current page number. +If invoked with no filename argument it will just display an empty +window. +If given a file it will read the preamble, postamble and page backpointers +so that it can go straight to a given page. +This means that it will only display files, it will not read stdin. +After each page of the +output is displayed the program will wait for a response from the user. +.SH OPTIONS +.TP +.B \-p +Pre-load all the font descriptions for fonts mentioned in the DVI file. +Normally only the information from the DVI postamble is loaded and the +various PK files are opened on demand. +This option loads all the character information except the actual character +bitmaps before displaying the first page. +.TP +.B \-P +A stronger version of the above. +In this case the character bitmaps are pre-loaded as well. +If this option is used no PK files will need to be accessed after the first +page is displayed. +The penalty is extra memory used for characters that may not be printed. +.TP +.BI \-m mag +This option gives a magnification factor (in the TeX form with +1000 for a magnification of 1) which will over-ride any magnification factor +specified in the DVI file. +The program may be compiled with this option disabled as it is uncommon +to have a set of PK files at several different magnifications. +.TP +.B \-b +This turns off SunView batching. +This slows page display down by a factor of about three but you get the +top lines of the screen displayed more quickly. +.TP +.BI \+ number +Skip +.I number +pages before displaying anything. +.LP +As well as those options described above +.I textool +will also consume the standard suntools options of the form \-W*, +for example the command "textool -Wi &" will start an instance +of +.I textool +in its iconic state in the background. +This can be used as a tool as and when required. +.SH "KEYBOARD COMMANDS" +.LP +Keyboard commands are provided to go forward and backwards 1 or n pages in +the file and to provide basic scrolling. +They are: +.TP +.B return +Go to next page in file. +.TP +.B space +Same as return. +.TP +.B b +Go to previous page in file. +.TP +.B p +Same as b. +.TP +.BI \+ nn +Skip forward +.I nn +pages. +The number is terminated with return. +.TP +.BI \- nn +Go back +.I nn +pages. +The number is again terminated with return. +.TP +.B h +Scroll over to the left edge of the page. +.TP +.B j +Scroll to bottom of page. +.TP +.B k +Scroll to top of page. +.TP +.B l +Scroll over to right edge of page. +.TP +.B c +Scroll to initial position, which is one inch down from the top and +half an inch in from the left edge. +.SH "MOUSE COMMANDS" +.LP +Both horizontal and vertical scrollbars are provided and these work in the +standard Sun fashion. +In particular the middle mouse button in either of the vertical bar's +page bottons will go to the next page and a shifted middle button will +go back a page. +.LP +Pressing the left mouse button changes the cursor to a set of cross-hairs +so alignment can be checked. +The arrow cursor is restored by releasing the button. +.LP +A menu is provided, popped up with the right mouse button, to do more +complex things. +Selections from this menu which require user text input will pop up a +text input panel with an appropriate prompt. +This panel is also used for error messages. +An error message can be removed by clicking on the panel with the left +mouse button. +Operations are interlocked to prevent impossible or inadvisable choices; +for example if there is no current file you cannot select the +"restart dvi file" or "go to page" choices. +.LP +The various selections are described below: +.TP +.B "restart dvi file" +This is a complete restart with the current file. +The DVI file is closed, font storage is freed and all PK files closed. +The file is then reopened and processed from scratch. +.TP +.B "go to page" +This allows direct access to any page in the file. +For documents of 10 pages or less a pullright menu is provided to select +the actual page. +For longer documents you must enter the page number into the pop up +panel. +.TP +.B "new file" +This closes the current file, as in the restart case, and then prompts for +a new file to process. +A leading ~ on the file name is interpreted in the same way as +.IR csh . +.TP +.B "change directory" +This prompts for a directory to replace the current working directory. +Leading ~ is allowed as in the "new file" case. +.TP +.B "run tex" +This creates a new window and runs tex on the .tex file with the same +basename as the current DVI file. +Only one extra window is allowed so all the other selections which +would require one are dimmed while the tex window is open. +As the DVI file is assumed to be changing the restart and page choices are +also dimmed. +To remove the window select "done" from its frame menu. +.TP +.B "run latex" +This is the same as the "run tex" case but runs latex instead. +.TP +.B "edit .tex file" +This runs an editor on the .tex file. +The EDITOR from the environment is used if there is one, otherwise +/usr/ucb/vi is used. +.TP +.B shell +This creates a window running whatever shell SunView finds for you. +.SH ENVIRONMENT +.LP +The following things are taken from the environment: +.TP +.B PKPATH +A comma separated list of directories to search for the font PK files +in place of the default described below. +.TP +.B HOME +Used for expanding tilde expressions of the form ~/dir. +.TP +.B EDITOR +The editor to use for the "edit .tex file" menu choice. +.SH FILES +.TP 2.5i +*.dvi +TeX DeVice Independent output file +.TP +/usr/local/lib/tex/fonts/pk/*.*pk +TeX default font rasters +.TP +/etc/passwd +Used for expanding tilde expressions of the form ~name/dir. +.SH "SEE ALSO" +dvitype(1), +dvisun(1), +tex(1) +.SH BUGS +When using fonts with decent resolution only part of a page appears +on the screen. +.SH AUTHORS +Mark Senn wrote the early versions of this program for the BBN BitGraph. +Stephan Bechtolsheim, Bob Brown, Richard Furuta, James Schaad +and Robert Wells improved it. +Norm Hutchinson ported the program to the Sun, becoming dvisun. +Yves Ledru did the initial suntools port, making texview. +Peter Ilieve re-did the suntools part, +tidied up and changed the font cacheing in the DVI part +and changed it to use PK files for fonts. + -- cgit v1.2.3