.chars {}:=
.topic General=0
  TeXShell
  
This program simplifies the use of the
emTeX 3.0 package. It is menu-driven and
offers {online help:Help} (press Enter
to read more about this).

Use F10 to access the menu bar in
the first line of the screen; the arrow
keys and Enter or the Alt key together
with the highlighted letter in the menu
entry selects a submenu (e.g. Alt-T
selects the TeX menu), or entries in
submenus. Each menu has its own help:

  {File}
  {Edit-functions:EdFu}
  {TeX}
  {Options}
  {Windows}
  {User}

All texts found in the menus and dialogs
are read from a file, so the actual names
may differ from the ones used in these help
texts.

It is faster to use {function keys:Hotkeys} to
select functions. The most important are listed
in the status line at the bottom of the
screen, others can be found in the menus.

TeXShell can be started with parameters in
the {command line:CmdL}, and it is no longer
necessary to provide a large environment space.

.topic Hotkeys=2
  Hotkeys I
  
Here is a list of functions available on hotkeys:
 F1          Help
 F2          Save editor text
             (see {internal editor:InEd})
 F3          Select edit file
             (see {FileOpen:FiOp})
 F4          Edit the edit file   ({TeXEdit:TeEd})
 F5          Call TeXcad          ({TeXTeXcad:Teca})
 F6          TeX the primary file ({TeXCompose:TeCo})
 F7          View log file        ({TeXLogview:TeLo})
 F8          View TeX document    ({TeXView:TeVi})
 F9          Print TeX document   ({TeXPrint:TePr},
                                   {Print file dialog:PrFi})
 F10         Select menu bar
 Alt-X       Quit TeXShell        ({FileExit:FiEx})

see: {more hotkeys:HotkeyII}
     {General}

.topic HotkeyII
  more hotkeys
  
 Shift-F2    Save As, using a different name
                                    ({internal editor:InEd})
 Shift-F3    Select primary file    ({FilePrimary:FiPr})
 Ctrl-F3     Set primary file to file
             in actual edit window
 Alt-F3      Close window           ({WindowsClose:WiCl})
 Shift-F4    Edit primary file
 Alt-F4      Edit using the other editor
                                    ({internal editor:InEd})
 Shift-F5    Zoom window            ({WindowsZoom:WiZo})
 Ctrl-F5     Resize/Move window with the
             arrow keys             ({WindowsSize/Move:WiSM})
 Alt-F5      Show DOS output-screen ({WindowsOutput:WiOu})
 Shift-F6    Select next window     ({WindowsNext:WiNe},
                                     {Window list:WiLi})
 Ctrl-F6     Select previous window ({WindowsPrevious:WiPr},
                                     {Window list:WiLi})
 Alt-F9,
 Ctrl-F9     TeX the primary file   ({TeXCompose:TeCo})
 Alt-1 .. 9  Select window 1 .. 9
 Alt-0       Window list

The selected window has a double frame
(), the other windows a single ().
The primary file name is used for the
TeX formatter, log viewer, TeX viewer
and TeX printer driver; the edit file
name is used for the external editor.
If no primary file is set, the edit file
is used instead.

see: {General}

.topic CmdL
  Command line options
  
TeXShell accepts up to two file names on
command line; the first name is used as
primary file name, the second one as
edit file name. If the second is omitted,
the name is taken as edit file.
If no name at all is given, no edit or
primary file is preset. If a given
filename has no extension, .TEX will be
appended. As with {FilePrimary:FiPr},
TeXShell first loads the standard option file
TEXSHELL.CFG and then the option file for the
primary file.

If no filename is given in the command line,
TeXShell loads the last TEXSHELL.DSK file,
thus restoring the state when it was last
used -- just as if you had not stopped working.
Other command line options are:

 -N
.endpara
start a new session from scratch, that is,
without loading TEXSHELL.DSK
(there must be no filename on the command line)
 -E
.endpara
call editor immediately (there must be at
least one filename on the command line)
 -Ccfgfile
.endpara
loads the option file cfgfile after TEXSHELL.CFG;
cfgfile is then treated as if it's part of the
standard configuration.
 -Ttmpdir
.endpara
set the path for the initial TEXSHELL.DSK.

see: {OptionsSave options:OpSa}
     {General}

.topic Help
  Using online help
  
Each function has an associated help
text which can be displayed in a window
by pressing F1. There is one minor
exception, the resize/move mode for
windows -- in this case a short message
appears in the status line.

Each help text contains cross references
to other texts, which are displayed in a
different colour. One of these is always
selected: use Tab or Shift-Tab to move
the selection to the cross reference of
interest and then press Enter to display
that text. Alternatively you can double
click on the reference. With Alt-F1 you
can go back through the last 9 help texts
selected.

Use the arrow keys or scroll bars to
scroll through the text. All hotkeys for
windows apply to this one as well.
In addition, pressing Esc will close it.

All texts for menus, dialogs etc. are
read from a file, so the actual names of
menus or dialog items may differ from
that used in the help texts.

In edit windows you can request help for
TeX and LaTeX macros and notions. Just
position the cursor to the word or char
in question and press Ctrl-F1; this will
display the associated help text. If the
word could not be found in the index, the
index is shown with the reference matching
it best selected. Pressing Shift-F1 at any
time will give you the syntax help index.

see: {General}

.topic File
  File
  
This menu contains all functions related
to files or the operating system:

  {Open:FiOp}
  {New:FiNe}
  {Save:FiSa}
  {Save As:FiAs}
  {Primary:FiPr}
  {Clean up:FiCl}
  {Change dir:FiCh}
  {DOS shell:FiDO}
  {Exit:FiEx}

see: {General}

.topic FiOp
  FileOpen F3
  
calls a {File select:FiSe} dialog. If you
don't cancel it, the selected file becomes
the edit file and the editor is called.
If there is no primary file selected, the edit
file will be used instead; so, the standard
option file and an option file with the same
name but extension .CFG (if it exists) will
be read as with {Primary:FiPr}. To create a
new file, just type a new filename.

see: {TeXEdit:TeEd}
     {WindowsInfo:WiIn}
     {File menu:File}

.topic FiNe
  FileNew
  
calls the editor with the file 'Untitled'.
This file does not become the edit file, so
it is better to use {Open:FiOp} with a new
filename. Anyway, before you can save the
'Untitled' file, you will have to christen
it in the {Save As:FiAs} dialog.

see: {internal editor:InEd}
     {File menu:File}

.topic FiSa
  FileSave F2
  
stores the contents of the current edit
window in the file shown in the window
title.

see: {Save As:FiAs}
     {OptionsEditorBackup files:BackupFiles}
     {OptionsEditorAutosave modified:Autosave}
     {internal editor:InEd}
     {File menu:File}

.topic FiAs
  FileSave As
  
allows you to save the contents of the
current edit window like {Save:FiSa}, but
to a different file. The window title will
be updated. If this file was the edit file,
this name will be updated, too; if it was
the primary file, the {Primary:FiPr} function
will be called with the new name.

see: {Save:FiSa}
     {OptionsEditorBackup files:BackupFiles}
     {internal editor:InEd}
     {File menu:File}

.topic FiPr
  FilePrimary
  
allows you to specify the primary file
via a {File select:FiSe} dialog. This
file is the one which \input's or
\include's all the other files of your
document (if there are more than one).
If your document consists of only one
file, there is no need to set a primary
file; the edit file is then used. Use
the Clear button of the File select
dialog to clear the primary file setting.

If no edit file is set, this function will
set it to the same file.

If a primary file is selected, the standard
option file TEXSHELL.CFG will be read
from the directory ..\DATA, relative to the
TeXShell home directory, and then from the
directory of the primary file. If the TeXShell
had a -C option in its command line, it will
load that option file. Then an option file with
the same name as the primary file, but with the
extension CFG, will be loaded if it exists.
Options can thus be linked to documents.
Here is an example:

The file \USER\TEX\MAIN.TEX is selected
as the primary file. TeXShell then loads
\EMTEX\DATA\TEXSHELL.CFG and \USER\TEX\TEXSHELL.CFG,
if they exist. Then, a file
\USER\TEX\MAIN.CFG is loaded as an option
file, if it exists. if -Cos2.cfg is given in
the TeXShell command line, OS2.CFG is loaded
immediately before \USER\TEX\MAIN.CFG.

see: {TeXCompose:TeCo}
     {TeXLogview:TeLo}
     {TeXBibTeX:TeBi}
     {TeXMakeIndex:TeIn}
     {TeXView:TeVi}
     {TeXPrint:TePr}
     {OptionsSave options:OpSa}
     {OptionsLoad options:OpLo}
     {Clean up:FiCl}
     {File menu:File}

.topic FiCl
  FileClean up
  
With this function all temporary files
can be deleted. With the {Delete what:Clean}
dialog you can select the files to be
deleted.

see: {OptionsTeX optionsAuxiliary files:OpFoEx}
     {File menu:File}

.topic FiCh
  FileChange dir
  
The {Change directory:ChDi} dialog lets
you change the current directory.

see: {File menu:File}

.topic FiDO
  FileDOS shell
  
invokes a temporary MSDOS shell
(COMMAND.COM). Typing EXIT at the DOS
prompt terminates the shell and returns
control to TeXShell. Please don't start
programs which remain resident after
the end of the DOS shell (TSRs).

see: {File menu:File}

.topic FiEx
  FileExit Alt-X
  
terminates TeXShell. Depending on the
setting of the switch
{OptionsEditorAutosave modified:Autosave},
you will be asked whether you want to save
modified files in edit windows. If it is on,
all files in edit windows are saved; if it is
off, you are prompted for every changed file
separately.

The actual state is stored into the file
TEXSHELL.DSK so there is no need to care
about changed options.

see: {OptionsSave options:OpSa}
     {OptionsEditorBackup files:BackupFiles}
     {Command line:CmdL}
     {File menu:File}

.topic EdFu
  Edit-functions
  
This menu offers functions for the internal
editor and log viewer only:

  {Undo:EdUn}
  {Cut:EdCu}
  {Copy:EdCo}
  {Paste:EdPa}
  {Clear:EdCl}
  {Find:EdFi}
  {Replace:EdRe}
  {Search again:EdSe}

see: {OptionsEditorInternal:OpEdIn}
     {OptionsEditor:OpEd}
     {OptionsSave options:OpSa}
     {OptionsLoad options:OpLo}
     {The internal editor:InEd}
     {Internal editor key codes:EdTa}
     {General}

.topic EdUn
  Edit-funcsUndo Ctrl-Backspace
  
undoes all changes made since the last
explicit cursor movement.

see: {Edit-functions menu:EdFu}

.topic EdCu
  Edit-funcsCut Shift-Del
  
moves the marked block into the {clipboard:WiCb}
and marks it there.

see: {Internal editor key codes:EdTa}
     {The internal editor:InEd}
     {Copy:EdCo}
     {Paste:EdPa}
     {Clear:EdCl}
     {Edit-functions menu:EdFu}

.topic EdCo
  Edit-funcsCopy Ctrl-Ins
  
copies the marked block into the {clipboard:WiCb}
and marks it there.

see: {Internal editor key codes:EdTa}
     {The internal editor:InEd}
     {Copy:EdCo}
     {Paste:EdPa}
     {Clear:EdCl}
     {Edit-functions menu:EdFu}

.topic EdPa
  Edit-funcsPaste Shift-Ins
  
copies the marked block in the {clipboard:WiCb}
into the actual editor. Usually, this
is the last block copied or moved into
the clipboard, but marking any text in
the clipboard will work, too.

see: {Internal editor key codes:EdTa}
     {The internal editor:InEd}
     {Copy:EdCo}
     {Paste:EdPa}
     {Clear:EdCl}
     {Edit-functions menu:EdFu}

.topic EdCl
  Edit-funcsClear Ctrl-Del
  
deletes the marked block.

see: {Internal editor key codes:EdTa}
     {The internal editor:InEd}
     {Copy:EdCo}
     {Paste:EdPa}
     {Clear:EdCl}
     {Edit-functions menu:EdFu}

.topic EdFi
  Edit-funcsFind
  
The {Find} dialog allows you to search
for text in the actual edit window.

see: {Internal editor key codes:EdTa}
     {The internal editor:InEd}
     {Replace:EdRe}
     {Search again:EdSe}
     {Edit-functions menu:EdFu}

.topic EdRe
  Edit-funcsReplace
  
The {Replace} dialog lets you replace
text in the actual edit window.

see: {Internal editor key codes:EdTa}
     {The internal editor:InEd}
     {Find:EdFi}
     {Search again:EdSe}
     {Edit-functions menu:EdFu}

.topic EdSe
  Edit-funcsSearch again Ctrl-L
  
searches for the next occurrence of the
search text. If the last operation was
{Replace:EdRe}, replacement will be
offered again.

see: {Internal editor key codes:EdTa}
     {The internal editor:InEd}
     {Find:EdFi}
     {Replace:EdRe}
     {Edit-functions menu:EdFu}

.topic InEd
  The internal editor
  
TeXShell offers as many editor windows
as there is memory to hold them. Each
of them can hold a file up to 64Kbytes
and supports a mouse, an undo function,
cut, copy, paste, read and write for blocks
of text, automatic indentation, word wrap, an
overwrite mode, search/replace facilities,
(La)TeX syntax help, and syntax highlighting.
Many functions can be called by WordStar-like
key sequences. The maximum line length
is 256 chars.

see: {Internal editor key codes:EdTa}
     {FileNew:FiNe}
     {FileSave:FiSa}
     {FileSave As:FiAs}
     {Edit-functions menu:EdFu}

.chars ô=
.topic EdTa
  Internal editor key codes
  
Many functions of the internal editor can
be called by WordStar-like key sequences.
Because these editors do not support
fixed blocks, all block operations are
simulated using a special editor called
the clipboardWiCl:
  Ctrl-K Ctrl-B sets the beginning of the block
  Ctrl-K Ctrl-K copies the marked text to the clipboard
  Ctrl-K Ctrl-C inserts the text marked in the clipboard
                into the current edit window

Here is a list of all the functions
and their key codes:
  Ctrl-A or Ctrl-left arrow   word left
  Ctrl-C or PgDn              page down
  Ctrl-D or right arrow       char right
  Ctrl-E or up arrow          line up
  Ctrl-F or Ctrl-right arrow  word right
  Ctrl-G or Del               delete char/delete marked text
  Ctrl-H or Backspace         delete last char/delete marked text
  Ctrl-J                      goto line number (using a dialog)
  Ctrl-L                      search/replace again
  Ctrl-M or Enter             new line
  Ctrl-O                      toggle automatic indentation
  Ctrl-P                      literal
  Ctrl-R or PgUp              page up
  Ctrl-S or left arrow        char left
  Ctrl-T                      delete word
  Ctrl-V or Ins               toggle insert/overwrite
  Ctrl-W                      toggle word wrap
  Ctrl-X or down arrow        line down
  Ctrl-Y                      delete line
  Ctrl-Backspace              undo
  Ctrl-Home                   goto first line of window
  Ctrl-End                    goto last line of window

  Ctrl-Q Ctrl-A               replace (with dialog)
  Ctrl-Q Ctrl-C or Ctrl-PgDn  goto end of file
  Ctrl-Q Ctrl-D or End        goto end of line
  Ctrl-Q Ctrl-E               goto next error
  Ctrl-Q Ctrl-F               search (with dialog)
  Ctrl-Q Ctrl-H               clear line up to cursor
  Ctrl-Q Ctrl-M               set right margin for word wrap
  Ctrl-Q Ctrl-R or Ctrl-PgUp  goto beginning of file
  Ctrl-Q Ctrl-S or Home       goto beginning of line
  Ctrl-Q Ctrl-W               goto last error
  Ctrl-Q Ctrl-X               toggle Syntax highlightingSyntax
  Ctrl-Q Ctrl-Y               clear line up to end of line
  Ctrl-Q [                    goto next matching parenthesis
  Ctrl-Q ]                    goto last matching parenthesis
  Ctrl-Q 0 .. 9               goto label 0 .. 9

  Ctrl-K Ctrl-B               set begin of block
  Ctrl-K Ctrl-C               copy block from clipboard
  Ctrl-K Ctrl-H               toggle block marker on/off
  Ctrl-K Ctrl-K               copy block to clipboard
  Ctrl-K Ctrl-R               read block from file
  Ctrl-K Ctrl-W               write block to file
  Ctrl-K Ctrl-Y               move block to clipboard
  Ctrl-K 0 .. 9               set label 0 .. 9

  Ctrl-Z D                    define key mapping
  Ctrl-Z 0 .. 9               insert associated text

  Ctrl-F1                     get syntax help

Instead of using Ctrl-K sequences a
block can be marked by pressing down a
Shift key and moving the cursor, or
moving the mouse while holding down the
mouse button.

To find a matching parenthesis the
cursor has to be on one of the chars
(){}[]<>|"'$. The first 8 chars form 4
pairs; if the cursor is on one of them,
the search direction is determined by
the char, and therefore Ctrl-Q [ and
Ctrl-Q ] are equivalent. These chars can
be nested. The other 4 chars do not imply
a search direction, so Ctrl-Q [ searches
towards the end of the file and Ctrl-Q ]
towards the beginning of the file for the
next occurrence of this char.

The 10 key sequences Ctrl-Z 0 .. 9 can
be associated with text using the
OptionsEditorOpEd dialog. Pressing
Ctrl-Z followed by a number will then
insert the associated text.

Using Ctrl-Q E and Ctrl-Q W moves the
cursor to the next TeX error or warning;
this requires a LOG file. If there is
none, a message is displayed; otherwise
the first Ctrl-Q E or Ctrl-Q W analyses
the LOG file, so the analysis need not
be repeated at a subsequent Ctrl-Q E or
Ctrl-Q W. You don't have to be in the
editor with the primary file to use this
feature. Ctrl-Q E searches for an error or
warning towards the end of the file,
Ctrl-Q W towards the beginning. Since TeX
doesn't give a line number for warnings,
the cursor cannot be set to the offending
text.

The switches Trace sourceTrSrc and
Trace logfileTrLog affect the choice
of the next/previous error.

If there is no view window with the
LOG file, TeXShell will create it. In
this window the error text is shown.

The clipboard is always available and
can be made visible via
WindowsClipboardWiCl.

The internal logviewer reacts to
Ctrl-Q F and Ctrl-L (and the functions of
the Edit-functions menuEdFu)
like an editor.

see: The internal editorInEd
     OptionsEditorOpEd

.chars {}:=
.topic Windows
  Windows
  
This menu contains almost all window
functions:

  {Size/Move:WiSM}
  {Zoom:WiZo}
  {Tile:WiTi}
  {Cascade:WiCa}
  {Next:WiNe}
  {Previous:WiPr}
  {Close:WiCl}
  {Output:WiOu}
  {Info:WiIn}
  {Clipboard:WiCb}
  {List:WiLi}

There is always one window selected; it
has a double frame (), the other
windows a single (). A mouse can be
used and makes the use of windows much
easier. For example, clicking on a
window selects it, instead of repeatedly
pressing Shift-F6.
The frame of the selected (active)
window shows a number of symbols:

 The close symbol [] in the upper left
corner. Clicking on it closes the window.
.endpara
 The zoom symbol [] in the upper right
corner. The first click zooms the window
to maximum size, changing the symbol to
[]. The next click zooms it back to its
original size, toggling the symbol back
to [].
.endpara
 The scroll bars to the left and below.
They consist of the scroll page, one
arrow on each end  and an slider
box  showing the relative position in
the file of the currently displayed
portion of text.  To move up or down
the file by one line, click on  or ;
to move up or down by one page, click
on the scroll bar above or below the
slider.  You can move up and down
through the file by a variable amount
by dragging the slider up and down the
scroll bar.
.endpara
 The resize symbol  in the lower left
corner. To resize the window, drag this
symbol with the mouse until it has the
desired size.
.endpara
 The title bar at the top, that is, the
upper frame except for the other symbols.
A double click with the mouse button
in this area is like a click on the
zoom symbol. You can move the window by
placing the mouse pointer on any part
of the title bar and dragging the window
to the new position.
.endpara
 A window number, shown between title
and zoom symbol -- only the first 9
windows are given a number. Pressing
the Alt-key and a number will select
the associated window. Pressing the
Alt-key together with 0 displays the
{window list:WiLi} dialog, from which you
can select the unnumbered windows as
well as the numbered ones.

Not every window has all these symbols,
furthermore the window menu functions
do not apply to dialog windows, since
the whole menu bar is locked while a
dialog is displayed. The hotkeys are,
however, still active, though they only
apply to windows with the corresponding
symbols in their frame.

see: {General}

.topic WiSM
  WindowsSize/Move Ctrl-F5
  
allows you to move and/or resize the
selected window. Pressing Enter or Esc
terminates this mode.

  Size
  
Using the arrow keys while holding down
a Shift key changes the size of the
selected window. With the resize symbol
in the frame you can do the same.

  Move
  
Use the arrow keys to move the selected
window, or drag it with the mouse by
the title bar.

see: {Zoom:WiZo}
     {Tile:WiTi}
     {Cascade:WiCa}
     {Next:WiNe}
     {Previous:WiPr}
     {Close:WiCl}
     {List:WiLi}
     {Windows menu:Windows}

.topic WiZo
  WindowZoom Shift-F5
  
expands the selected window to maximum
size. The next use of this function
shrinks it back to its original size.
A double click in the title bar or a
click on the zoom symbol does the same.

see: {Size/Move:WiSM}
     {Tile:WiTi}
     {Cascade:WiCa}
     {Next:WiNe}
     {Previous:WiPr}
     {Close:WiCl}
     {List:WiLi}
     {Windows menu:Windows}

.topic WiTi
  WindowTile
  
places all the windows side by side, so
that they do not overlap:

 Ŀ
  1ͻ2Ŀ 
                                 
                                 
                                 
                                 
  ͼ 
  3Ŀ4Ŀ 
                                 
                                 
                                 
                                 
   
 

see: {Size/Move:WiSM}
     {Zoom:WiZo}
     {Cascade:WiCa}
     {Next:WiNe}
     {Previous:WiPr}
     {Close:WiCl}
     {List:WiLi}
     {Windows menu:Windows}

.topic WiCa
  WindowsCascade
  
puts all windows one upon another, the
first full size, the rest smaller and
smaller. The selected window will then
be top of that stack:

 1Ŀ
 2Ŀ
 3Ŀ
 4ͻ
                          
                          
                          
                          
                          
 ͼ

see: {Size/Move:WiSM}
     {Zoom:WiZo}
     {Tile:WiTi}
     {Next:WiNe}
     {Previous:WiPr}
     {Close:WiCl}
     {List:WiLi}
     {Windows menu:Windows}

.topic WiNe
  WindowsNext Shift-F6
  
selects the next window.

see: {Size/Move:WiSM}
     {Zoom:WiZo}
     {Tile:WiTi}
     {Cascade:WiCa}
     {Previous:WiPr}
     {Close:WiCl}
     {List:WiLi}
     {Windows menu:Windows}

.topic WiPr
  WindowsPrevious Ctrl-F6
  
selects the previous window.

see: {Size/Move:WiSM}
     {Zoom:WiZo}
     {Tile:WiTi}
     {Cascade:WiCa}
     {Next:WiNe}
     {Close:WiCl}
     {List:WiLi}
     {Windows menu:Windows}

.topic WiCl
  WindowsClose (Alt-F3)
  
closes the selected window. If it is
an edit window and the file has been
changed, you are asked whether to save
it or not. A click on the close symbol
does the same.

see: {Size/Move:WiSM}
     {Zoom:WiZo}
     {Tile:WiTi}
     {Cascade:WiCa}
     {Next:WiNe}
     {Previous:WiPr}
     {List:WiLi}
     {Windows menu:Windows}

.topic WiCb
  WindowsClipboard
  
shows the clipboard used by the
internal editor.

see: {The internal editor:InEd}
     {Edit-functions menu:EdFu}
     {Output:WiOu}
     {Info:WiIn}
     {Size/Move:WiSM}
     {Zoom:WiZo}
     {Tile:WiTi}
     {Cascade:WiCa}
     {Next:WiNe}
     {Previous:WiPr}
     {Close:WiCl}
     {List:WiLi}
     {Windows menu:Windows}

.topic WiIn
  WindowsInfo
  
displays the File information window
with the names of the {edit:FiOp} and
{primary:FiPr} file. If
{OptionsEditorkeep info window:keepInfowin}
is selected, this window comes up whenever
any of the two filenames change.

see: {Output:WiOu}
     {Clipboard:WiCb}
     {Size/Move:WiSM}
     {Zoom:WiZo}
     {Tile:WiTi}
     {Cascade:WiCa}
     {Next:WiNe}
     {Previous:WiPr}
     {Close:WiCl}
     {List:WiLi}
     {Windows menu:Windows}

.topic WiOu
  WindowsOutput Alt-F5
  
displays the saved DOS screen. It is
captured at startup and after every
return from an external program. This
is just a display window: strike any
key to return to the TeXShell.

see: {Info:WiIn}
     {Clipboard:WiCb}
     {Windows menu:Windows}

.topic TeX
  TeX
  
This menu offers the main functions of
TeXShell so most of them are also
accessible via function keys. Almost
all the functions are inaccessible when
there is no primary or edit file selected.

  {Edit:TeEd}
  {TeXcad:Teca}
  {Compose:TeCo}
  {BibTeX:TeBi}
  {MakeIndex:TeIn}
  {Logview:TeLo}
  {View:TeVi}
  {Print:TePr}

see: {General}

.topic TeEd
  TeXEdit F4
  
calls the editor with the edit file.
This makes less sense if you use the
internal editor, since all edit windows
are directly available. So this function
opens a new one, if there is none with
the edit file, otherwise selects that
one.
.endpara
If {OptionsEditorOpen new window:OpenNewWin}
is deselected, an existing edit window
will be used instead of opening a new
one.

The editor used is determined by
{OptionsEditorEditor:OpEdEd} and
{OptionsEditorInternal:OpEdIn}.

see: {The internal editor:InEd}
     {TeXcad:Teca}
     {Compose:TeCo}
     {BibTeX:TeBi}
     {MakeIndex:TeIn}
     {Logview:TeLo}
     {View:TeVi}
     {Print:TePr}
     {TeX menu:TeX}
     {Edit-functions menu:EdFu}

.topic Teca
  TeXTeXcad F5
  
starts the TeXcad program written by
Georg Horn. It makes it possible to
design LaTeX picture environments
easily and has its own documentation
in TCMAN.DVI.

see: {Edit:TeEd}
     {Compose:TeCo}
     {BibTeX:TeBi}
     {MakeIndex:TeIn}
     {Logview:TeLo}
     {View:TeVi}
     {Print:TePr}
     {TeX menu:TeX}

.topic TeCo
  TeXCompose F6/Alt-F9/Ctrl-F9
  
starts the TeX formatter with the
primary file. Depending on
{OptionsTeX optionsUse BigTeX:OpFoUs},
the {OptionsTeX optionsTeXprg:OpFoTe}
or {OptionsTeX optionsBigTeXprg:OpFoBT}
is used; TeXShell changes temporarily
to the working directory of the program.
The {OptionsFormats:OpFo} dialog lets you
choose the macro package to be used.

If TeX reports errors, the log file will be
analysed and, if you typed 'e' on an error
prompt, the editor called with the file in
question. The internal editor will position
the cursor and show the error text, as with
the Ctrl-Q W/E functions of the
{internal editor:InEd}.

see: {OptionsFormats:OpFo}
     {Edit:TeEd}
     {TeXcad:Teca}
     {BibTeX:TeBi}
     {MakeIndex:TeIn}
     {Logview:TeLo}
     {View:TeVi}
     {Print:TePr}
     {TeX menu:TeX}

.topic TeBi
  TeXBibTeX
  
calls the {OptionsFormatBibTeX:OpFoBi}
program to create a bibliography for
your document. Directories for BibTeX style
files can be given in
{OptionsDirectoriesTeX input:OpDiIn},
for the data bases in
{OptionsDirectoriesBibTeX input:OpDiBi}.
There is separate documentation for
BibTeX.

see: {OptionsDirectories:OpDi}
     {Edit:TeEd}
     {TeXcad:Teca}
     {Compose:TeCo}
     {MakeIndex:TeIn}
     {Logview:TeLo}
     {View:TeVi}
     {Print:TePr}
     {TeX menu:TeX}

.topic TeIn
  TeXMakeIndex
  
calls the {OptionsTeX optionsIndexer:OpFoIn}
program to create an index for your
document. MakeIndex style files are sought
in {OptionsDirectoriesIndex styles:OpDiIx}.
There is separate documentation for
MakeIndex.

see: {OptionsDirectories:OpDi}
     {OptionsFormats:OpFo}
     {Edit:TeEd}
     {TeXcad:Teca}
     {Compose:TeCo}
     {BibTeX:TeBi}
     {Logview:TeLo}
     {View:TeVi}
     {Print:TePr}
     {TeX menu:TeX}

.topic TeLo
  TeXLogview F7
  
asks in the {View Logfile:LogV} dialog
for the log file to be displayed. Selecting
other... in the select box lets you select
any file you want; just type its name into
the input line.

The functions {Edit-funcsFind:EdFi}
(Ctrl-Q F) and {Edit-funcsSearch again:EdSe}
(Ctrl-L) work with the logviewer, too.

see: {Edit:TeEd}
     {TeXcad:Teca}
     {Compose:TeCo}
     {BibTeX:TeBi}
     {MakeIndex:TeIn}
     {View:TeVi}
     {Print:TePr}
     {TeX menu:TeX}

.topic TeVi
  TeXView F8
  
starts the {OptionsOutputPreviewer:OpOuVi}
to display your document on the screen.

see: {OptionsOutput:OpOu}
     {Edit:TeEd}
     {TeXcad:Teca}
     {Compose:TeCo}
     {BibTeX:TeBi}
     {MakeIndex:TeIn}
     {Logview:TeLo}
     {Print:TePr}
     {TeX menu:TeX}

.topic TePr
  TeXPrint F9
  
In the {Print file:PrFi} dialog you can
set the page range to be printed,
adjust the margins, give additional options
and select the printer driver from the
list of the {OptionsOutput:OpOu} dialog:
The selected one in the list will be used
for printing.

see: {Edit:TeEd}
     {TeXcad:Teca}
     {Compose:TeCo}
     {BibTeX:TeBi}
     {MakeIndex:TeIn}
     {Logview:TeLo}
     {View:TeVi}
     {TeX menu:TeX}

.topic User
  User menu
  
This menu holds all tool entries. If no
tool is registered, the only entry is
'No tools defined'. Use {OptionsTools:OpTo}
to modify the contents of this menu.
Selecting an entry in this menu will
start the associated program with its
command line in which all variables
have been replaced by their actual
values, and its environment.

Use {OptionsSave options:OpSa} to save
the set of registered tools and
{OptionsLoad options:OpLo} to restore a
previously saved set.

see: {OptionsTools:OpTo}
     {General}

.topic Options
  Options
  
Many things can be adjusted, they have been
grouped as follows:

  {Directories:OpDi}
  {TeX options:OpTe}
  {Formats:OpFo}
  {Output:OpOu}
  {Tools:OpTo}
  {Environments:OpEn}
  {Editor:OpEd}
  {Mouse:OpMo}
  {Colors:OpCo}
  {Language:OpLa}

All options can be written to and
restored from option files with

  {Save options:OpSa}
  {Load options:OpLo}

The option file TEXSHELL.CFG is read
automatically at {startup:CmdL}.
Almost all options of the first four
dialogs are available as
{templates:Templates}.

see: {General}

.topic OpDi
  OptionsDirectories
  
offers several paths in a list box:

  {emTeX-directory:OpDiDr}
  {Path list:OpDiPa}
  {TeX input:OpDiIn}
  {Graphics files:OpDiGr}
  {TeX fonts:OpDiFo}
  {Font metrics:OpDiMe}
  {BibTeX input:OpDiBi}
  {Index styles:OpDiIx}

Use the mouse or the cursor keys to select
a path and press the {Edit:OpDiEd} button to change
its setting.

The associated section [Directories] in
option files offers three additional settings:
TempDir to set the directory for TEXSHELL.DSK,
OS/2-Pipe to set the pipe used for communication
with {os2:OS2}execd, and MFjobFile to set the
expansion of the %sm {template:Templates}.

see: {TeX options:OpTe}
     {Formats:OpFo}
     {Output:OpOu}
     {Tools:OpTo}
     {Environments:OpEn}
     {Editor:OpEd}
     {Mouse:OpMo}
     {Colors:OpCo}
     {Language:OpLa}
     {Templates}
     {Options menu:Options}

.topic OpDiDi
  OptionsDirectoriesDirectories
  
lists all directories that can be manipulated from within
TeXShell. You can position the selection bar to any entry
by pressing the entry's highlighted character.

see: {OptionsDirectories:OpDi}

.topic OpDiEd
  OptionsDirectoriesEdit directory
  
starts a dialog that lets you type in a new path or directory.

see: {OptionsDirectories:OpDi}

.topic OpDiDr
  OptionsDirectoriesemTeX-directory
  
This is the directory where emTeX is installed; in a standard
installation, it would be 'c:\emtex'. It is the expansion of
the {template:Templates} %dt. Former versions of TeXShell offered
only a drive letter, in the template %r --- this is now defined
as %Ddt, giving the drive letter of this directory, to keep
compatibility.

see: {Path list:OpDiPa}
     {TeX input:OpDiIn}
     {Graphics files:OpDiGr}
     {TeX fonts:OpDiFo}
     {Font metrics:OpDiMe}
     {BibTeX input:OpDiBi}
     {Index styles:OpDiIx}
     {OptionsDirectories:OpDi}

.topic OpDiPa
  OptionsDirectoriesPath list
  
is the expansion of the {template:Templates} %dp. It is
intended to hold the search path for binary and data files
and can be used for the PATH variable in {environments:OpEn}.

see: {emTeX-directory:OpDiDr}
     {TeX input:OpDiIn}
     {Graphics files:OpDiGr}
     {TeX fonts:OpDiFo}
     {Font metrics:OpDiMe}
     {BibTeX input:OpDiBi}
     {Index styles:OpDiIx}
     {OptionsEnvironments:OpEn}
     {OptionsDirectories:OpDi}

.topic OpDiIn
  OptionsDirectoriesTeX input
  
is the expansion of the {template:Templates}
%di. Usually these directories are used as value for
the {environment:OpEn} variable TEXINPUT, i.e. they
contain TeX style files or macros.

In addition to this list, each {format:OpFo} has its
own list of input directories.

see: {emTeX-directory:OpDiDr}
     {Path list:OpDiPa}
     {Graphics files:OpDiGr}
     {TeX fonts:OpDiFo}
     {Font metrics:OpDiMe}
     {BibTeX input:OpDiBi}
     {Index styles:OpDiIx}
     {OptionsEnvironments:OpEn}
     {OptionsDirectories:OpDi}

.topic OpDiGr
  OptionsDirectoriesGraphics files
  
is the expansion of the {template:Templates}
%dg. Usually it is used as {environment:OpEn}
variable DVIDRVGRAPH, i.e. the emTeX drivers
search for graphics files in these directories.

see: {emTeX-directory:OpDiDr}
     {Path list:OpDiPa}
     {TeX input:OpDiIn}
     {TeX fonts:OpDiFo}
     {Font metrics:OpDiMe}
     {BibTeX input:OpDiBi}
     {Index styles:OpDiIx}
     {OptionsEnvironments:OpEn}
     {OptionsDirectories:OpDi}

.topic OpDiFo
  OptionsDirectoriesTeX fonts
  
is the expansion of the {template:Templates}
%df. All drivers need fonts for their
task, so it is wise to use this template
as DVIDRVFONTS or TEXFONTS in the
appropriate {environments:OpEn}.

see: {emTeX-directory:OpDiDr}
     {Path list:OpDiPa}
     {TeX input:OpDiIn}
     {Graphics files:OpDiGr}
     {Font metrics:OpDiMe}
     {BibTeX input:OpDiBi}
     {Index styles:OpDiIx}
     {OptionsEnvironments:OpEn}
     {OptionsDirectories:OpDi}

.topic OpDiMe
  OptionsDirectoriesFont metrics
  
is the expansion of the {template:Templates}
%dm. TeX font metric files (TFM files) hold
information about the symbols in fonts; TeX
needs this information to calculate the size
of symbols. It usually gets this directory
via the TEXTFM {environment:OpEn} variable.

see: {emTeX-directory:OpDiDr}
     {Path list:OpDiPa}
     {TeX input:OpDiIn}
     {Graphics files:OpDiGr}
     {TeX fonts:OpDiFo}
     {BibTeX input:OpDiBi}
     {Index styles:OpDiIx}
     {OptionsEnvironments:OpEn}
     {OptionsDirectories:OpDi}

.topic OpDiBi
  OptionsDirectoriesBibTeX input
  
is the expansion of the {template:Templates}
%db. {BibTeX:TeBi} generates bibliographies
for TeX documents using database files;
the {environment:OpEn} variable BIBINPUT
holds a list of directories for these
files and this template should be used
for it.

see: {emTeX-directory:OpDiDr}
     {Path list:OpDiPa}
     {TeX input:OpDiIn}
     {Graphics files:OpDiGr}
     {TeX fonts:OpDiFo}
     {Font metrics:OpDiMe}
     {Index styles:OpDiIx}
     {OptionsEnvironments:OpEn}
     {OptionsDirectories:OpDi}

.topic OpDiIx
  OptionsDirectoriesIndex styles
  
The program {MakeIndex:TeIn} generates indices
for TeX documents, the form of the output
being determined by a style file. These
style files are sought in the directories
given in the INDEXSTYLES {environment:OpEn} variable.
This input line is the expansion of the
{template:Templates} %ds, so the variable can
be set to it.

see: {emTeX-directory:OpDiDr}
     {Path list:OpDiPa}
     {TeX input:OpDiIn}
     {Graphics files:OpDiGr}
     {TeX fonts:OpDiFo}
     {Font metrics:OpDiMe}
     {BibTeX input:OpDiBi}
     {OptionsEnvironments:OpEn}
     {OptionsDirectories:OpDi}

.topic OpTe
  OptionsTeX options
  
contains options for the TeX formatter:

  {TeXprg:OpFoTe}
  {BigTeXprg:OpFoBT}
  {BibTeX:OpFoBi}
  {Indexer:OpFoIn}
  {Use BigTeX:OpFoUs}
  {fmt-Directories:OpFoFM}
  {Bigfmt-Directories:OpFoBF}
  {Auxiliary files:OpFoEx}

Use Tab or Shift-Tab to select a dialog
element (or press the highlighted char
in its name together with the Alt-key).
With Enter or selecting the Ok-button
you accept the changes, selecting the
Reset-button undoes all changes in all
input lines, and cancelling the dialog
discards all changes. If an element of
the dialog contains invalid data, you will
not be able to end the dialog with the
Ok button: instead, the first such element
will be selected. Cancelling the dialog
is always possible.

see: {Directories:OpDi}
     {Formats:OpFo}
     {Output:OpOu}
     {Tools:OpTo}
     {Environments:OpEn}
     {Editor:OpEd}
     {Mouse:OpMo}
     {Colors:OpCo}
     {Language:OpLa}
     {Options menu:Options}

.topic OpFo
  OptionsFormats
  
contains options for macro packages:

  {Format:OpFoFo}
  {Scan lines:OpFoSc}

Use Tab or Shift-Tab to select a dialog
element (or press the highlighted char
in its name together with the Alt-key).
With Enter or selecting the Ok-button
you accept the changes; cancelling the
dialog will undo all changes made to
its contents (but not those of the list
elements).

see: {Directories:OpDi}
     {TeX options:OpTe}
     {Output:OpOu}
     {Tools:OpTo}
     {Environments:OpEn}
     {Editor:OpEd}
     {Mouse:OpMo}
     {Colors:OpCo}
     {Language:OpLa}
     {Options menu:Options}

.topic OpFoFo
  OptionsFormatsFormat
  
offers several macro packages or formats. They
are sought in the {fmt-Directories:OpFoFM} or
{Bigfmt-Directories:OpFoBF}, depending on the
TeX-formatter used.

The file name of the selected format is the expansion
of the {template:Templates} %ff, so '&%ff' can be used
to give it to the TeX formatter. The options of the selected
format are the expansion of the {template:Templates} %fo.

Use the arrow keys, the mouse or the shortcuts
to select the desired macro package.

If {Scan lines:OpFoSc} is >0, every time you
set the primary file (or the edit file, if no
primary file is set) this amount of lines from
the beginning of the file is scanned for the
text '%Format:' (line 276 of the {textfile:OpLa}).
If it is followed by the menu name of a format,
the associated macro package is automatically
selected in this list; if there is no package
with that name, a warning comes up. If the
text cannot be found, nothing is changed.

see: {TeXCompose:TeCo}
     {OptionsFormats:OpFo}

.topic OpFoEd
  OptionsFormatsEdit format
  
This button starts an {Edit format:EdFo}
dialog with the data of the selected
format.

see: {Format:OpFoFo} list
     {Add format:OpFoAd}
     {Delete format:OpFoDe}
     {Clear list:OpFoCl}
     {OptionsFormats:OpFo}

.topic OpFoAd
  OptionsFormatsAdd format
  
Using the {Add format:EdFo} dialog,
you can specify the menu name and file
name of the new format. It will be
inserted before the one selected in the
{Format:OpFoFo} list.

see: {Format:OpFoFo} list
     {Edit format:OpFoEd}
     {Delete format:OpFoDe}
     {Clear list:OpFoCl}
     {OptionsFormats:OpFo}

.topic OpFoDe
  OptionsFormatsDelete format
  
removes the selected format from
the list.

see: {Format:OpFoFo} list
     {Edit format:OpFoEd}
     {Add format:OpFoAd}
     {Clear list:OpFoCl}
     {OptionsFormats:OpFo}

.topic OpFoCl
  OptionsFormatsClear list
  
removes all formats from the
{Format:OpFoFo} list.

see: {Format:OpFoFo} list
     {Edit format:OpFoEd}
     {Add format:OpFoAd}
     {Delete format:OpFoDe}
     {OptionsFormats:OpFo}

.topic OpFoSc
  OptionsFormatsScan lines
  
Whenever you set a new primary file (or
a new edit file, with no primary file set),
this amount of lines of the file is scanned
for the text '%Format:' (line 276 of the
{textfile:OpLa}). If it is followed by the
menu name of a format, the associated macro package
is automatically selected in the {Format:OpFoFo}
collection; if there is no package with that
name, a warning comes up. If the text cannot
be found, nothing is changed.

The same lines are scanned for the text '%Options:'
(line 278 of the textfile), too. Behind it, you can
list option files (komma delimited), which will
then be loaded. If no path is specified, the directories
of {OptionsDirectoriesTeX input:OpDiIn} are sought; if the
extension is omitted, .CFG is appended automatically.

see: {Format:OpFoFo}
     {OptionsFormats:OpFo}

.topic EdFo
  Edit/Add format
  
This dialog offers the data of a format
for editing. A format registers the FMT file
of a macro package for use in TeXShell; these
FMT files are generated by iniTeX.
.endpara
Both functions {Add format:OpFoAd} and
{Edit format:OpFoEd} call this dialog under a
different name. It has five input lines:

  {Menu name:EdFoNa}
  {File name:EdFoFi}
  {Options:EdFoOp}
  {Input directories:EdFoIn}
  {Masks:EdFoMa}

Cancelling this dialog leaves the
edited format unchanged; {Add format:OpFoAd}
then won't insert a new format.

see: {OptionsFormats:OpFo}

.topic EdFoNa
  Edit/Add formatMenu name
  
holds the menu name, i.e. the line
which will appear in the {Format:OpFoFo} list.
The menu names are used to identify a format,
so a new format with an already existing menu
name will redefine the existing entry.

see: {Edit format:EdFo}

.topic EdFoFi
  Edit/Add formatFile name
  
takes the name of the FMT file, usually only the base name and
extension (usually '.FMT'); the extension is not automatically
appended. The contents of this input line is the expansion of
the {template:Templates} %ff, if this format is selected in
the {Format:OpFoFo} list.

see: {Edit format:EdFo}

.topic EdFoOp
  Edit/Add formatOptions
  
can take options needed to use this macro
package. The contents of this input line is the
expansion of the {template:Templates} %fo,
if this format is selected in the {Format:OpFoFo}
list.

see: {Edit format:EdFo}

.topic EdFoIn
  Edit/Add formatInput directories
  
takes the list of format-specific input directories. If the
input files for this format are of no use for other formats,
then list them here instead of in {OptionsDirectoriesTeX input:OpDiIn}.
This list is the expansion of the {template:Templates} %fi, if the
format is selected in the {list:OpFoFo}. It is usually used for the
TEXINPUT {environment:OpEn} variable, in addition to {%di:OpDiIn}.

see: {Edit format:EdFo}

.topic EdFoMa
  Edit/Add formatMasks
  
takes a list of file name masks. Each mask can be arbitrary long,
and use the wildcard character '*' and '?' as used in MS-DOS.
Masks are separated by ',' or ';'. The list is used in the
{Masks:FiSeMa} list box of the {File select:FiSe} dialog, if
this format is selected in the {list:OpFoFo}; masks that are
followed by a ';' will be selected in the list box.

see: {Edit format:EdFo}

.topic OpFoTe
  OptionsTeX optionsTeX prg
  
Using this {Tool button:ToolButton} you can
specify the program to be used as TeX-formatter,
if {Use BigTeX:OpFoUs} is not selected. It's
{template:Templates} is %nt.

see: {TeXCompose:TeCo}
     {BigTeX prg:OpFoBT}
     {Use BigTeX:OpFoUs}
     {BibTeX:OpFoBi}
     {Indexer:OpFoIn}
     {fmt-Directories:OpFoFM}
     {Bigfmt-Directories:OpFoBF}
     {Auxiliary files:OpFoEx}
     {OptionsTeX options:OpTe}

.topic OpFoBT
  OptionsTeX optionsBigTeX prg
  
With this {Tool button:ToolButton} you can
specify the program to be used as TeX-formatter,
if {Use BigTeX:OpFoUs} is selected. It's
{template:Templates} is %ng.

see: {TeXCompose:TeCo}
     {TeX prg:OpFoTe}
     {Use BigTeX:OpFoUs}
     {BibTeX:OpFoBi}
     {Indexer:OpFoIn}
     {fmt-Directories:OpFoFM}
     {Bigfmt-Directories:OpFoBF}
     {Auxiliary files:OpFoEx}
     {OptionsTeX options:OpTe}

.topic OpFoUs
  OptionsTeX optionsUse BigTeX
  
If this switch is selected [X], the {BigTeX prg:OpFoBT}
will be used with {TeXCompose:TeCo}, otherwise
{TeX prg:OpFoTe}.

see: {TeXCompose:TeCo}
     {TeX prg:OpFoTe}
     {BigTeX prg:OpFoBT}
     {BibTeX:OpFoBi}
     {Indexer:OpFoIn}
     {fmt-Directories:OpFoFM}
     {Bigfmt-Directories:OpFoBF}
     {Auxiliary files:OpFoEx}
     {OptionsTeX options:OpTe}

.topic OpFoBi
  OptionsTeX optionsBibTeX
  
Using this {Tool button:ToolButton} you can
specify the program to be used with {TeXBibTeX:TeBi}
to create a bibliography for your document.
It's {template:Templates} is %nb.
BIBTEX.EXE is usually used for this purpose.

see: {TeXBibTex:TeBi}
     {TeX prg:OpFoTe}
     {BigTeX prg:OpFoBT}
     {Use BigTeX:OpFoUs}
     {Indexer:OpFoIn}
     {fmt-Directories:OpFoFM}
     {Bigfmt-Directories:OpFoBF}
     {Auxiliary files:OpFoEx}
     {OptionsTeX options:OpTe}

.topic OpFoIn
  OptionsTeX optionsIndexer
  
With this {Tool button:ToolButton} you can
specify the program to be used with {TeXMakeIndex:TeIn}
to create an index for your document. It's
{template:Templates} is %ni.
MAKEINDX.EXE is usually used for this task.

see: {TeXMakeIndex:TeIn}
     {TeX prg:OpFoTe}
     {BigTeX prg:OpFoBT}
     {Use BigTeX:OpFoUs}
     {BibTeX:OpFoBi}
     {fmt-Directories:OpFoFM}
     {Bigfmt-Directories:OpFoBF}
     {Auxiliary files:OpFoEx}
     {OptionsTeX options:OpTe}

.topic OpFoFM
  OptionsTeX optionsfmt-Directories
  
holds the directory list, where the
files for the macro packages are
sought, if {Use BigTeX:OpFoUs} is not
selected; usually, they have the
extension FMT. This is the expansion
of the {template:Templates} %fd,
therefore the environment variable
TEXFMT should be set to it in the
environment for the {TeX prg:OpFoTe}.

Caution: emTeX386 is a BigTeX version,
so it uses the {BTEXFMT:OpFoBF} variable.

see: {TeXCompose:TeCo}
     {TeX prg:OpFoTe}
     {BigTeX prg:OpFoBT}
     {Use BigTeX:OpFoUs}
     {BibTeX:OpFoBi}
     {Indexer:OpFoIn}
     {Bigfmt-Directories:OpFoBF}
     {Auxiliary files:OpFoEx}
     {OptionsTeX options:OpTe}

.topic OpFoBF
  OptionsTeX optionsBigfmt-Directories
  
holds the directory list, where the
files for the macro packages are
sought, if {Use BigTeX:OpFoUs} is
selected; usually, they have the
extension FMT. This is the expansion
of the {template:Templates} %fg,
therefore the environment variable
BTEXFMT should be set to it in the
environment for the {BigTeX prg:OpFoTe}.

see: {TeXCompose:TeCo}
     {TeX prg:OpFoTe}
     {BigTeX prg:OpFoBT}
     {Use BigTeX:OpFoUs}
     {BibTeX:OpFoBi}
     {Indexer:OpFoIn}
     {fmt-Directories:OpFoFM}
     {Auxiliary files:OpFoEx}
     {OptionsTeX options:OpTe}


.topic OpFoEx
  OptionsTeX optionsAuxiliary files
  
In this input line the files are listed, which
are offered by {FileClean up:FiCl} for deletion.
Files are separated by ',' or ';', where the
latter will select the file in the Clean up list.
{Templates} are ok, while the MS-DOS wild cards
'*' and '?' are not allowed here.

see: {TeX prg:OpFoTe}
     {BigTeX prg:OpFoBT}
     {Use BigTeX:OpFoUs}
     {BibTeX:OpFoBi}
     {Indexer:OpFoIn}
     {fmt-Directories:OpFoFM}
     {Bigfmt-Directories:OpFoBF}
     {OptionsTeX options:OpTe}

.topic OpOu
  OptionsOutput
  
combines all the options dealing with
the output of TeX documents. Here are
the elements of this dialog:

  {Printer:OpOuPr}
  {Previewer:OpOuVi}
  {MFjob:OpOuMF}

All the programs in this dialog should be
drivers (except MFjob), and for any one of
them that supports emTeX's automatic font
generation mechanism, you should select its
{auto font generation:EdToOpAutoFont} flag.

Use Tab or Shift-Tab to select a dialog
element (or press the highlighted char
in its name together with the Alt-key).
With Enter or selecting the Ok-button
you accept the changes. Selecting the
Cancel-button undoes all changes made
to the Printer list, but not that made
to its elements. If an element of the dialog
contains invalid data, you will not be
able to end the dialog with the Ok button:
instead, the first such element will be
selected. Cancelling the dialog is always
possible.

see: {Directories:OpDi}
     {TeX options:OpTe}
     {Formats:OpFo}
     {Tools:OpTo}
     {Environments:OpEn}
     {Editor:OpEd}
     {Mouse:OpMo}
     {Colors:OpCo}
     {Language:OpLa}
     {Options menu:Options}

.topic OpOuPr
  OptionsOutputPrinter
  
This list shows all printer drivers by their
menu names. With the mouse, the arrow keys or
by typing the highlighted character in its name
you can select a driver to edit or delete, or
a position to add a new one. The selected driver
will be used by {TeXPrint:TePr}. It's
{template:Templates} is %np.

To access the data of the {Print file:PrFi}
dialog, you can use the templates %sl, %st,
%ss, %se and %so (and all others, of course)
in the CmdLine of these programs. Be careful
not to overfill that input line: 127 chars
are allowed for it. So standard and hardware
dependent options should be put into a
configuration file like the ones shipped with
emTeX 3.0 (extension CNF).

see: {Edit printer:OpOuEd}
     {Add printer:OpOuAd}
     {Delete printer:OpOuDe}
     {Clear list:OpOuCl}
     {Previewer:OpOuVi}
     {MFjob:OpOuMF}
     {OptionsOutput:OpOu}

.topic OpOuEd
  OptionsOutputEdit printer
  
This button starts an {Edit tool:EdTo}
dialog with the data of the selected printer.

see: {Printer:OpOuPr}
     {Add printer:OpOuAd}
     {Delete printer:OpOuDe}
     {Clear list:OpToCl}
     {Previewer:OpOuVi}
     {MFjob:OpOuMF}
     {OptionsOutput:OpOu}

.topic OpOuAd
  OptionsOutputAdd printer
  
Using the {Add tool:EdTo} dialog, you
can specify all necessary data for the
new printer driver. It will be inserted
before the one selected in the
{Printer:OpOuPr} list.

see: {Printer:OpOuPr}
     {Edit printer:OpOuEd}
     {Delete printer:OpOuDe}
     {Clear list:OpOuCl}
     {Previewer:OpOuVi}
     {MFjob:OpOuMF}
     {OptionsOutput:OpOu}

.topic OpOuDe
  OptionsOutputDelete printer
  
Removes the selected printer driver from
the {Printer:OpOuPr} list.

see: {Printer:OpOuPr}
     {Edit printer:OpOuEd}
     {Add printer:OpOuAd}
     {Clear list:OpOuCl}
     {Previewer:OpOuVi}
     {MFjob:OpOuMF}
     {OptionsOutput:OpOu}

.topic OpOuCl
  OptionsOutputClear list
  
Removes all printer drivers from the {Printer:OpOuPr}
list. Without a printer driver you will not be allowed
to print.

see: {Printer:OpOuPr}
     {Edit printer:OpOuEd}
     {Add printer:OpOuAd}
     {Delete printer:OpOuDe}
     {Previewer:OpOuVi}
     {MFjob:OpOuMF}
     {OptionsOutput:OpOu}

.topic OpOuVi
  OptionsOutputPreviewer
  
Use this {Tool button:ToolButton} to
specify the program used by {TeXView:TeVi}
to display the document on the screen.
It's {template:Templates} is %nv.

see: {Printer:OpOuPr}
     {MFjob:OpOuMF}
     {OptionsOutput:OpOu}

.topic OpOuMF
  OptionsOutputMFjob
  
The emTeX-3.0 device drivers since
version 1.4n are able to create a .mfj
file for MFjob if fonts are missing;
they then exit with errorlevel 8 and rely
on the external program dvidrv.exe to be
restarted after the fonts have been created.
The driver DVIPS adopted this convention in its
DOS version.

The TeXShell can act like dvidrv.exe, and does so
if a program has the
{Edit toolOptionsauto font generation:EdToOpAutoFont}
switch set. With this {Tool button:ToolButton}
you can specify the program to be started to generate the
fonts. It's {template:Templates} is %nm.

The .mfj filename should be unique to avoid
conflicts in networks, the TeXShell therefore
offers the {template:Templates} %sm; this file
will be deleted after the call. To use font creation
on the fly, you have to include '/pj:%sm' into
the driver options and '%sm' into the CmdLine
of this program. The expansion of the %sm template
can be set via [Directories]MFjobFile.

There is a minor problem with the MFjob logfile.
Usually, MFjob creates a temporary directory for
MetaFont and its logfile MFJOB.LOG can be found
there. Unfortunately, you don't know the name of
this directory, so you can't state the correct
logfile name for the {View logfile:LogV} dialog.
Since version 1.1m, MFjob offers a command
line option to preset the name of the logfile,
so the problem is solved.

For more information read DVIDRV.DOC.

see: {Previewer:OpOuVi}
     {Printer:OpOuPr}
     {OptionsOutput:OpOu}

.topic OpTo
  OptionsTools
  
In this dialog you can register your
favorite tools. They will appear in
the {User menu:User}. The dialog offers
these elements:

  {List of tools:OpToLi}
  {Edit tool:OpToEd}
  {Add tool:OpToAd}
  {Delete tool:OpToDe}
  {Clear list:OpToCl}

Use Tab or Shift-Tab to select a dialog
element (or press the highlighted char
in its name). If an element of the dialog
contains invalid data, you will not be
able to end the dialog with the Ok button:
instead, the first such element will be
selected. Cancelling the dialog is always
possible.

see: {Directories:OpDi}
     {TeX options:OpTe}
     {Formats:OpFo}
     {Output:OpOu}
     {Environments:OpEn}
     {Editor:OpEd}
     {Mouse:OpMo}
     {Colors:OpCo}
     {Language:OpLa}
     {Options menu:Options}

.topic OpToLi
  OptionsToolsList of tools
  
This list shows all tools actually available
by their menu names. With the mouse, the arrow
keys or by typing the selected character in
its name, you can select a tool to edit or
delete, or a position to add a new one.

see: {User menu:User}
     {Edit tool:OpToEd}
     {Add tool:OpToAd}
     {Delete tool:OpToDe}
     {Clear list:OpToCl}
     {OptionsTools:OpTo}

.topic OpToEd
  OptionsToolsEdit tool
  
This button starts an {Edit tool:EdTo}
dialog with the data of the selected tool.

see: {User menu:User}
     {List of tools:OpToLi}
     {Add tool:OpToAd}
     {Delete tool:OpToDe}
     {Clear list:OpToCl}
     {OptionsTools:OpTo}

.topic OpToAd
  OptionsToolsAdd tool
  
Using the {Add tool:EdTo} dialog, you
can specify all necessary data for the
new tool. It will be inserted before
the one selected in the
{tool list:OpToLi}.

see: {User menu:User}
     {List of tools:OpToLi}
     {Edit tool:OpToEd}
     {Delete tool:OpToDe}
     {Clear list:OpToCl}
     {OptionsTools:OpTo}

.topic OpToDe
  OptionsToolsDelete tool
  
Removes the tool from the {list:OpToLi}
and the {User menu:User}.

see: {User menu:User}
     {List of tools:OpToLi}
     {Edit tool:OpToEd}
     {Add tool:OpToAd}
     {Clear list:OpToCl}
     {OptionsTools:OpTo}

.topic OpToCl
  OptionsToolsClear list
  
Removes all tools from the {tool list:OpToLi}
and the {User menu:User}. The latter
will then show an entry titled 'No
tools defined'.

see: {User menu:User}
     {List of tools:OpToLi}
     {Edit tool:OpToEd}
     {Add tool:OpToAd}
     {Delete tool:OpToDe}
     {OptionsTools:OpTo}

.topic OpEn
  OptionsEnvironments
  
In this dialog you can edit or delete
environments, or add new ones. Each
environment has a unique name
(case-sensitive). Here are the dialog
elements:

  {Environment names:OpEnNa}
  {Edit environment:OpEnEd}
  {Add environment:OpEnAd}
  {Delete environment:OpEnDe}
  {Clear list:OpEnCl}

Use Tab or Shift-Tab to select a dialog
element (or press the highlighted char
in its name).

see: {Directories:OpDi}
     {TeX options:OpTe}
     {Formats:OpFo}
     {Output:OpOu}
     {Tools:OpTo}
     {Editor:OpEd}
     {Mouse:OpMo}
     {Colors:OpCo}
     {Language:OpLa}
     {Options menu:Options}

.topic OpEnNa
  OptionsEnvironmentsEnvironment names
  
is the list of all environments. With
the arrow keys or the mouse you can
select an environment.

see: {Edit environment:OpEnEd}
     {Add environment:OpEnAd}
     {Delete environment:OpEnDe}
     {Clear list:OpToCl}
     {OptionsEnvironments:OpEn}

.topic OpEnEd
  OptionsEnvironmentsEdit environment
  
This button starts an {Edit environment:EdEn}
dialog with the data of the selected
environment.

see: {Environment names:OpEnNa}
     {Add environment:OpEnAd}
     {Delete environment:OpEnDe}
     {Clear list:OpToCl}
     {OptionsEnvironments:OpEn}

.topic OpEnAd
  OptionsEnvironmentsAdd environment
  
Using the {Add environment:EdEn} dialog,
you can specify the name and content of
the new environment. It will be
inserted before the one selected in the
{environment list:OpEnNa}.

see: {Environment names:OpEnNa}
     {Edit environment:OpEnEd}
     {Delete environment:OpEnDe}
     {Clear list:OpEnCl}
     {OptionsEnvironments:OpEn}

.topic OpEnDe
  OptionsEnvironmentsDelete environment
  
removes the selected environment from
the list.

see: {Environment names:OpEnNa}
     {Edit environment:OpEnEd}
     {Add environment:OpEnAd}
     {Clear list:OpEnCl}
     {OptionsEnvironments:OpEn}

.topic OpEnCl
  OptionsEnvironmentsClear list
  
removes all environments from the
{list:OpEnNa}.

see: {Environment names:OpEnNa}
     {Edit environment:OpEnEd}
     {Add environment:OpEnAd}
     {Delete environment:OpEnDe}
     {OptionsEnvironments:OpEn}

.topic OpEd
  OptionsEditor
  
With this dialog the 10 key sequences
Ctrl-Z 0 .. 9 can be associated with
text of up to 79 characters per sequence,
the switches

  {Backup files:BackupFiles}
  {Autosave modified:Autosave}
  {Open new window:OpenNewWin}
  {Trace source:TrSrc}
  {Trace logfile:TrLog}
  {Autochange editfile:AutoChange}
  {Autoreload options:ReloadOptions}
  {initial wordwrap:InitialWordwrap}
  {initial indent:InitialIndent}
  {initial syntax:InitialSyntax}
  {reread file list:rereadFilelist}
  {keep info window:keepInfowin}

can be adjusted, and the programs for the
external editor and {TeXTeXcad:Teca} can
be given. Pressing Ctrl-Z D will call this
dialog from any editor window.

If an element of the dialog contains invalid
data, you will not be able to end the dialog
with the Ok button: instead, the first such
element will be selected. Cancelling the
dialog is always possible.

see: {The internal editor:InEd}
     {Internal editor key codes:EdTa}
     {Directories:OpDi}
     {TeX options:OpTe}
     {Formats:OpFo}
     {Output:OpOu}
     {Tools:OpTo}
     {Environments:OpEn}
     {Mouse:OpMo}
     {Colors:OpCo}
     {Language:OpLa}
     {Options menu:Options}

.topic BackupFiles
  OptionsEditorBackup files
  
If this switch is selected, an
exiting file will be renamed to
filename.BAK instead of overwriting
it with the file in the editor.

see: {FileSave:FiSa}
     {FileSave As:FiAs}
     {Autosave modified:Autosave}
     {Open new window:OpenNewWin}
     {OptionsEditor:OpEd}

.topic Autosave
  OptionsEditorAutosave modified
  
If the file in the editor has been
modified, the TeXShell will ask you
whether it should be saved before calling
an external program or exiting. If this
switch is selected, TeXShell will save
it without confirmation.

see: {FileSave:FiSa}
     {Backup files:BackupFiles}
     {Open new window:OpenNewWin}
     {OptionsEditor:OpEd}

.topic OpenNewWin
  OptionsEditorOpen new window
  
if this switch is selected, the TeXShell
opens an edit window for each new file.
Otherwise it tries to use an existing edit
window for the new file, saving the old
file in the window if it has been modified.

see: {TeXEdit:TeEd}
     {Backup files:BackupFiles}
     {Autosave modified:Autosave}
     {OptionsEditor:OpEd}

.topic TrSrc
  OptionsEditorTrace source
  
This switch determines whether TeX
errors in other files are recognized.
If selected, files with errors are loaded,
otherwise 'no more errors found' reported
instead.

see: {Trace source:TrLog}
     {The internal editor:InEd}
     {OptionsEditor:OpEd}

.topic TrLog
  OptionsEditorTrace logfile
  
This parameter determines the method to
be used in searching for TeX errors. If
selected, the next/previous error found
in the LOG file is reported, without
taking account of the actual editor file
and cursor position. Otherwise a
context sensitive search is used.

see: {Trace source:TrSrc}
     {The internal editor:InEd}
     {OptionsEditor:OpEd}

.topic AutoChange
  OptionsEditorAutochange edit file
  
If this switch is selected [X] and you change to an edit window,
the file in that window becomes automatically the {edit file:FiOp}.
If no {primary file:FiPr} is set, it depends on the switch
{Reload options:ReloadOptions} whether the appropriate option files
are loaded: If it is set, everything works as if you set the edit
file manually.

see: {OptionsEditor:OpEd}

.topic ReloadOptions
  OptionsEditorReload options
  
If the switch {Autochange edit file:AutoChange} is set, the
{edit file:FiOp} changes because of the selection of an edit window
and no {primary file:FiPr} is set, the options have to be set properly.
That means loading the standard option file TEXSHELL.CFG, the option
file of an -C command line option and any associated option file, and
that takes some time, especially on slow machines. Now, if this switch
is not set [X], nothing is loaded, speeding up the change; otherwise
the usual procedure is started...

see: {OptionsEditor:OpEd}

.topic InitialWordwrap
  OptionsEditorinitial wordwrap
  
If this switch is on [X], new editor windows start with wordwrap
enabled. Press Ctrl-W to change this for an existing editor window.

see: {initial indent:InitialIndent}
     {initial syntax:InitialSyntax}
     {Internal editor key codes:EdTa}
     {OptionsEditor:OpEd}

.topic InitialIndent
  OptionsEditorinitial indentation
  
If this switch is on [X], new editor windows start with autoindent
enabled. Press Ctrl-O to change this for an existing editor window.

see: {initial wordwrap:InitialWordwrap}
     {initial syntax:InitialSyntax}
     {Internal editor key codes:EdTa}
     {OptionsEditor:OpEd}

.topic InitialSyntax
  OptionsEditorinitial syntax highlight
  
If this switch is on [X], new editor windows start with syntax highlighting
enabled. Press Ctrl-Q X to change this for an existing editor window.

see: {initial wordwrap:InitialWordwrap}
     {initial indent:InitialIndent}
     {Internal editor key codes:EdTa}
     {OptionsEditor:OpEd}

.topic rereadFilelist
  OptionsEditorreread File list
  
If this switch is on [X], the {file list:FiSeFi} of the File dialog will
always present the filtered contents of the directory that is
selected in the {directory list:FiSeDi}. Otherwise, you have to press Enter
after moving the bar in the directory list to see the files.

see: the {File select:FiSe} dialog

.topic keepInfowin
  OptionsEditorkeep info window
  
If this switch is on [X], any change of the {edit:FiOp} or {primary:FiPr}
file setting will bring up the File information window. If it is off [ ],
you have to use {WindowsInfo:WiIn} to see it.

see: the {Windows menu:Windows}

.topic OpEdEd
  OptionsEditorEditor
  
With this {Tool button:ToolButton} you can
specify the external editor program. It's
{template:Templates} is %ne.

In it's CmdLine you can use the templates
%sc for the current filename and %sj; the
latter expands directly after the TeX run
to the line number of the TeX error
on which the user stopped TeX pressing 'e',
and to the empty string elsewhere.

see: {Internal:OpEdIn}
     {TeXcad:OpEdTe}
     {OptionsEditor:OpEd}

.topic OpEdIn
  OptionsEditorInternal
  
If this switch is selected, {TeXEdit:TeEd} uses
the {internal editor:InEd}, otherwise the
{external:OpEdEd} one.

see: {TeXEdit:TeEd}
     {Editor:OpEdEd}
     {OptionsEditor:OpEd}

.topic OpEdTe
  OptionsEditorTeXcad
  
With this {Tool button:ToolButton} you can
specify the program started by {TeXTeXcad:Teca}.

see: {Editor:OpEdEd}
     {OptionsEditor:OpEd}

.topic OpMo
  OptionsMouse
  
This dialog lets you alter your
mouse's behaviour patterns. With the
slider Mouse double click you modify the
maximum delay between two clicks to
count as a double click, and Reverse
mouse buttons adapts the buttons for
left-handers.

see: {Directories:OpDi}
     {TeX options:OpTe}
     {Formats:OpFo}
     {Output:OpOu}
     {Tools:OpTo}
     {Environments:OpEn}
     {Editor:OpEd}
     {Colors:OpCo}
     {Language:OpLa}
     {Options menu:Options}

.topic OpCo
  OptionsColors
  
With this dialog you can harmonize the
colours used by the TeXShell with your
shirt and/or monitor. It consists of
these elements:

 Group
  is the list of colour groups. Related
  objects are grouped together to help
  harmonize them with each other.
 Item
  lists the members of the selected group.
 Foreground/Background
  In these fields you can select the
  desired colour. Below them there is
  an example showing what the colour
  chosen looks like.

Depending on hardware, either the
colour version of this dialog or the
monochrome one will come up.

see: {Directories:OpDi}
     {TeX options:OpTe}
     {Formats:OpFo}
     {Output:OpOu}
     {Tools:OpTo}
     {Environments:OpEn}
     {Editor:OpEd}
     {Mouse:OpMo}
     {Language:OpLa}
     {Options menu:Options}

.topic OpLa
  OptionsLanguage
  
In this dialog you can decide which texts the
TeXShell displays in menus, dialogs, warnings
etc., and the file with the help texts. If you
leave the dialog with Ok, the new text file
will be read in, so you can see the changes
immediatly. If one of the files does not
exist, you will have to cancel the dialog to
leave it.

In both input lines you can press the Cursor down key
to get a {File select:FiSe} dialog, to assist your
search for the correct file name. If you left that dialog
with Ok, the file name that you select there is copied
into the input line.

Caution! Do not use any %-{template:Templates} for the
text file --- those are not defined when the file is
read in.

see: {Directories:OpDi}
     {TeX options:OpTe}
     {Formats:OpFo}
     {Output:OpOu}
     {Tools:OpTo}
     {Environments:OpEn}
     {Editor:OpEd}
     {Mouse:OpMo}
     {Colors:OpCo}
     {Options menu:Options}

.topic OpSa
  OptionsSave options
  
With this function {options:Options} can be
stored into files called option files. The
option file TEXSHELL.CFG contains the standard
options and should at least exist in the
directory ..\DATA, relative to the TeXShell
home directory. With the {File select:FiSe}
dialog you can select the option file
pathname. If it ends in TEXSHELL.CFG, all
options are stored in it. Otherwise you
can select the option groups to be stored
into this file with the {Save what:What}
dialog; the TeXShell will propose only
those option groups which have been changed
since a TEXSHELL.CFG has been saved or loaded.
If you deselect all options, nothing will be
done.

Note: the Programs group represents all programs
edited by tool buttons. If the Programs option
group is selected, you can select the programs
to be actually saved in a second, similar
dialog.

Option files can be attached to TeX documents.
Every time the {primary:FiPr} file is changed,
the TeXShell loads the standard option file
TEXSHELL.CFG, then the option file given with
the -C command line option and at last searches
for an option file with the name of the primary
file, but the extension CFG and (if it exists)
loads it.

see: {Load options:OpLo}
     {Options menu:Options}

.topic OpLo
  OptionsLoad options
  
loads options from an option file. You can select
the file with the {File select:FiSe} dialog. Only
options contained in the file are changed, all
others remain unchanged. The {tools:OpTo},
{formats:OpFoFo} and {environments:OpEn} are treated
as collections: new entries are inserted, replacing
entries with the same name if they exist.

see: {Save options:OpSa}
     {Options menu:Options}

.topic ToolButton
  Tool buttons
  
Pressing this button will start a {Edit tool:EdTo}
dialog with the data of the associated program.
The Menu name given in this dialog is shown on
the left side of the button.

The {OptionsSave options:OpSa} stores all
programs into the section [Programs], together
with the {tools:OpTo}; they are separated
from the options of the dialog which contains
the tool button.

see: {OptionsLoad options:OpLo}

.topic EdTo
  Edit/Add tool/printer
  
This dialog offers the data of a program
for editing. All the functions {Add tool:OpToAd},
{Edit tool:OpToEd}, {Add printer:OpOuAd} and
{Edit printer:OpOuEd} call this dialog under a
different name, and tool buttons use it, too.
It consists of six input lines and a set of
switches:

  {Menu name:EdToNa}
  {Program:EdToPr}
  {Command line:EdToCL}
  {Logfile:EdToLF}
  {Working directory:EdToWD}
  {Environment:EdToEn}
  {Options:EdToOp}

Cancelling this dialog leaves the
edited program unchanged; {Add tool:OpEnAd}
and {Add printer:OpOuAd} then won't insert
a new tool/printer. If either the program
name or the environment are invalid, the
dialog cannot be closed by pressing the Ok
button.

see: {OptionsTeX options:OpTe}
     {OptionsOutput:OpOu}
     {User menu:User}
     {OptionsTools:OpTo}

.topic EdToNa
  Edit/Add tool/printerMenu name
  
This input line holds the name that identifies the program
uniquely. It is shown in the {User menu:User}, with a
{tool button:ToolButton} or in the {printer driver list:OpOuPr}.

see: {Edit tool:EdTo}

.topic EdToPr
  Edit/Add tool/printerProgram
  
This input line takes the full name of the program. If the
given name does not specify an existing program, you cannot
close the dialog with the Ok button.

If you press the Cursor down key, you can use a {File select:FiSe}
dialog to find the program you want. If you end that dialog
with Ok, the file name that you select there is copied into the input
line.

see: {Edit tool:EdTo}

.topic EdToCL
  Edit/Add tool/printerCommand line
  
specifies the command line for the {program:EdToPr}. Be careful not to
overfill this input line: 127 chars are allowed. Specifying a suitable
{working directory:EdToWD} will help by allowing relative file names.
For drivers ({printer:OpOuPr} or {previewer:OpOuVi}) you can use CNF
files to shorten the command line.

see: {Edit tool:EdTo}

.topic EdToLF
  Edit/Add tool/printerLogfile
  
specifies the name of the log file, that the {program:EdToPr} may
generate. The {View logfile:LogV} dialog will then offer this file
for viewing. If no logfile will be created, leave the input line
empty.

see: {Edit tool:EdTo}

.topic EdToWD
  Edit/Add tool/printerWorking directory
  
is the working directory of the {program:EdToPr}. Before calling the program
TeXShell changes to that directory to help shorten the {command line:EdToCL}.
The contents of this input line may end with a '\'; TeXShell then appends a
'.' before using it.

see: {Edit tool:EdTo}

.topic EdToEn
  Edit/Add tool/printerEnvironment
  
is the name of the {environment:OpEn}, which is set for the {program:EdToPr}.
If there is no environment with this name, the startup environment will be
used. Press the Cursor down key to select an environment from the
{list:OpEnNa}.

see: {Edit tool:EdTo}

.topic EdToOp
  Edit/Add tool/printerOptions
  
offers four switches:

  {show output:EdToOpSO}
  {use command interpreter:EdToOpUseCMD}
  {auto font generation:EdToOpAutoFont}
  {OS/2 program:EdToOpOS2}

see: {Edit tool:EdTo}

.topic EdToOpSO
  Edit/Add tool/printershow output
  
If this switch is on [X], TeXShell will immediately after termination
of the {program:EdToPr} show the output it produced by selecting
{WindowsOutput:WiOu}. Any keystroke will then switch back to TeXShell.

see: {Edit tool:EdTo}

.topic EdToOpUseCMD
  Edit/Add tool/printeruse command interpreter
  
If this switch is on [X], TeXShell will start the {program:EdToPr}
indirectly via the {command shell:FiDO}; this allows to use input/output
redirection. This switch is not necessary for batch files, those are
always started via the shell.

see: {Edit tool:EdTo}

.topic EdToOpAutoFont
  Edit/Add tool/printerauto font generation
  
This switch should be set on [X] if the program supports the emTeX
auto font generation convention, i.e. generates a file for
{MFjob:OpOuMF} and stops with errorlevel 8. TeXShell will then first
start MFjob and then restart this program. If the switch is off [ ],
then errorlevel 8 is not treated specially.

see: {Edit tool:EdTo}

.topic EdToOpOS2
  Edit/Add tool/printerOS/2 program
  
If this switch is on [X], TeXShell will try to start this program
under {OS/2:OS2} via the {os2:OS2}execd daemon; for this, TeXShell
must be run in a DOS box of OS/2 2.0 or newer. If the switch is off
[ ], the program will be started via normal DOS functions.

see: {Edit tool:EdTo}

.topic EdEn
  Edit environment/Add environment
  
The functions {Add environment:OpEnAd} and {Edit environment:OpEnEd} both
call this dialog under a different name. In it you can edit the environment
name and the content, i.e. the variables it consists of. Here are the dialog
elements in detail:

  {Name:EdEnNa}
  {Variables:EdEnVa}

Caution! There cannot be two environments with the same name: if
there is already an environment with the same name, it will be replaced.
Cancelling this dialog leaves the edited environment unchanged;
{Add environment:OpEnAd} then won't insert a new one.

see: {OptionsEnvironments:OpEn}

.topic EdEnNa
  Edit environment/Add environmentName
  
is the name of the environment. Upper and lower case are distinct.

Caution! There cannot be two environments with the same name: if
there is already an environment with the same name, it will be
replaced.

see: {Edit environment:EdEn}

.topic EdEnVa
  Edit environment/Add environmentVariables
  
holds the list of variables of this environment, one in each line. The
names of the environment variables as well as their values may include
{templates:Templates}.

see: {Edit environment:EdEn}

.topic Templates
  Templates
  
Templates are a way to use contents of the {options menu:Options} in
command line options or environments. Here is a list of all templates and
their replacement texts (also called 'expansions'):

  template {Mod:Modifier}  replacement
  #EnvVar!       the content of the environment variable
                 EnvVar in the startup environment.
  %e        f    full {edit file:FiOp} name
  %p        f    full {primary file:FiPr} name
  %t             the directory for TEXSHELL.DSK
  %dt            {OptionsDirectoriesemTeX directory:OpDiDr}
  %dp            {OptionsDirectoriesPath list:OpDiPa}
  %di            {OptionsDirectoriesTeX input:OpDiIn}
  %dg            {OptionsDirectoriesGraphics files:OpDiGr}
  %df            {OptionsDirectoriesTeX fonts:OpDiFo}
  %dm            {OptionsDirectoriesFont metrics:OpDiMe}
  %db            {OptionsDirectoriesBibTeX input:OpDiBi}
  %ds            {OptionsDirectoriesIndex styles:OpDiIx}
  %r             emTeX drive, short form of %Ddt
  %ne       pclw {OptionsEditorEditor:OpEdEd}
  %nc       pclw {OptionsEditorTeXcad:OpEdTe}
  %nt       pclw {OptionsTeX optionsTeX prg:OpFoTe}
  %ng       pclw {OptionsTeX optionsBigTeX prg:OpFoBT}
  %nb       pclw {OptionsTeX optionsBibTeX:OpFoBi}
  %ni       pclw {OptionsTeX optionsIndexer:OpFoIn}
  %nv       pclw {OptionsOutputPreviewer:OpOuVi}
  %np       pclw {OptionsOutputPrinter:OpOuPr}
  %nm       pclw {OptionsOutputMFjob:OpOuMF}
  %ff       f    {Edit/Add FormatFile name:EdFoNa}
  %fo            {Edit/Add FormatOptions:EdFoOp}
  %fi            {Edit/Add FormatInput dirs:EdFoIn}
  %fm            {Edit/Add FormatMasks:EdFoMa}
  %fd            {OptionsTeX optionsfmt-Directories:OpFoFM}
  %fg            {OptionsTeX optionsBigfmt-Directories:OpFoBF}
  %st       -    {Print file:PrFi}Top margin
  %sl       -    {Print file:PrFi}Left margin
  %ss       -    {Print file:PrFi}Start page
  %se       -    {Print file:PrFi}End page
  %so       -    {Print file:PrFi}Additional options
  %sc            file to edit with external editor
  %sj       -    TeX-error linenumber
  %sm            filename for MFjob
  %q"title" f-   dialog with "title" and input line
  %%             %
  %#             #

The column Mod specifies which {modifiers:Modifier} are allowed:
 f     means file name modifier
 pclw  means tool selectors
 -     means the null-modifier

The five templates %st, %sl, %ss, %se and %so
are defined only in the {Printer:OpOuPr} {command lines:EdToCL} and
{environments:EdToEn}, they are undefined everywhere else.

The template %sj is usally expanded to the empty string, only immediately
after the user stopped TeX by typing 'e' it expands to the linenumber of
the last error found in the logfile.

The template %q opens a dialog with the specified title and just one
input line. The user can now type in whatever he wants, and terminate
input by pressing Enter; the expansion of %q is the contents of this
input line. If the user cancels the dialog, the whole expansion (together
with the program start that caused it) is aborted.

Input lines that are also available as templates, may contain templates,
but not themselves, directly or indirectly. The names of environment
variables may contain %-variables, which will be expanded.
The two delimiters # and ! have to be in the same input line.
The contents of environment variables may contain all kinds of templates.

see: {OptionsTools:OpTo}
     {OptionsEnvironments:OpEn}

.topic Modifier
  Modifier for templates
  
The Mod column in the above table specifies the modifiers allowed with
the template. Modifiers change the actual expansion of the
{template:Templates} they are applied to, by selecting parts of it.

 File name modifier
 
There are five modifiers DPBEN for file names. When applied to a file
name, P extracts the path portion including the final backslash, B
retrieves the base name without path or extension, E yields the extension,
N is a short form of BE, and D gives first character, usually the drive
letter. Regardless of the order of modifiers, the path will always be
before the base name which will be before the extension; P includes D.

Here is an example:
    file name            D    P          B        E
    
    c:\emtex\dvidrv.err  c  c:\emtex\  dvidrv   .err
    xyz.abc              x             xyz      .abc
    d:\temp\             d  d:\temp\
    e:blabla             e  e:         blabla

Let 'C:\QUELLEN\TEX\ADDENDUM.TEX' be the edit file. Then we have

        %e      C:\QUELLEN\TEX\ADDENDUM.TEX
        %DEe    C.TEX
        %PBe    C:\QUELLEN\TEX\ADDENDUM
        %Ne     ADDENDUM.TEX
        %PEe    C:\QUELLEN\TEX\.TEX

When no modifier is given the result will be the original file name.
These modifiers work only correct with fully specified file names,
so be careful when using them with the %q template. Especially the
D modifier will give false results, as in the second example.

 Tool selectors
 
are not real modifiers; they select a part of a program definition:
  p     selects the {program:EdToPr},
  c     the {command line:EdToCL},
  l     the {logfile:EdToLF}, and
  w     the {working directory:EdToWD}
of the program in question.

You can use file name modifiers to extract parts of p and l since both
are filenames.

It is important, that no %n template may be used without a selector!

 null-modifier
 
This modifier - is intended for command lines only: it will delete the
current expansion back to the last space ' ', if its argument expands
to the empty string (i.e. has no value).

Here is an example:

  content of
  Print file
  Start page test-template      expansion
  
    '4'      /b%-ss TEXPUT.DVI  /b4 TEXPUT.DVI
    ''       /b%-ss TEXPUT.DVI  TEXPUT.DVI
    ''       /b%ss TEXPUT.DVI   /b TEXPUT.DVI

see: {Schablonen:Templates}

.topic FiSe
  File select dialog
  
This dialog consists of
  an {input line:FiSeNa} with a history list
  a list of {directories:FiSeDi}
  a list of {files:FiSeFi}
  a list of {masks:FiSeMa}
  a Cancel button
  an Ok button
  sometimes a Clear button
  an information pane

It is designed to allow easy selection of a file name

see: {File menu:File}

.topic FiSeNa
  File select dialog, input line
  
In this input line you can type in a complete
file names, a directory name or a mask such as '*.TEX',
using normal DOS conventions.

Pressing the Cursor-down key or clicking on the history
button [] on the right opens the associated history
list, where you will find the file names you chose before;
use the cursor keys or the mouse to select one and press
Enter or double-click to copy it into the input line.

Tip: When TeXShell analyses the TeX logfile, it inserts all
file names into this history list.

see: {directory list:FiSeDi}
     {file list:FiSeFi}
     {File select dialog:FiSe}

.topic FiSeDi
  File select dialog, directory list
  
This list lets you easily switch between drives and directories.
In the list you find all directories from the root to the
current directory, nicely indented. Below the current directory,
all its subdirectories are listed in alphabetical order. Using the
mouse or the cursor keys, you can select any directory and make it
the current one with double-click or Enter. This will update the
{file list:FiSeFi} with the files in that directory; simply moving
the bar will do so only if the switch {reread file list:rereadFilelist}
is selected.

The uppermost directory contains the root directories of all drives,
thus allowing to switch the current drive as easy as the directory.

see: {File select dialog:FiSe}

.topic FiSeFi
  File select dialog, file list
  
The file list lists all file names that match any of masks given
in the {input line:FiSeNa} or the {mask list:FiSeMa}. They are
sorted alphabetically and allow incremental search by typing
the starting letters of the desired file name. The selected
file name is automatically copied into the input line, while the
information pane shows further information about the selected file.

see: {File select dialog:FiSe}

.topic FiSeMa
  File select dialog, mask list
  
In this list you will find the file name masks either from the current
{format:EdFoMa}, or from some given list. They can be switched on and
off to restrict the file names shown in the {file list:FiSeFi}. The
information pane always shows which masks are in effect.
.endpara
Note that the {input line:FiSeNa} also defines a mask which is shown
as the first mask in the information pane. You cannot deselect this
special mask.

see: {File menu:File}

.topic ChDi
  Change directory dialog
  
This dialog allows you to change the
current directory. It consists of an input line,
a directory list and an OK, and Revert button.

The input line allows to to type in the name of
the new current directoy, either absolute or
relative to the old current directory.

The directory list is the same as in the
{File select dialog:FiSeDi}. You can select the
directory from the list and press Enter or double-click
to make it the current.

Pressing the Revert button undoes all changes and
sets you back into the original current directory.
The Ok and Cancel buttons work as usual.

see: {File menu:File}

.topic LogV LV1 LV2 LV3 LV4 LV5 LV6 LV7
  View Logfile
  
With this dialog you can select the file to view.
The TeXShell always proposes the log file of the last
external program (except for the external editor and
TeXcad).

If other... is selected, you can type any file name
into the input line.

see: {TeXLogview:TeLo}

.topic Find Find1 Find2
  Find dialog
  
This dialog allows you to search for
text in the file. There are two
switches to modify the search:

'Case sensitive' makes upper and lower case
letters distinct.

'Whole words only' requires non-letters before and
after the search string.

'Regular expression' interprets the search strings as
a {regular expression:RegExp} and searches accordingly.
This allows a much more flexible search.

The search starts at the cursor
position; {Search again:EdSe} or Ctrl-L
will search for the next occurrence.

see: {The internal editor:InEd}
     {Edit-functions menu:EdFu}
     {Edit-funcsFind:EdFi}
     {Edit-funcsReplace:EdRe}
     {Edit-funcsSearch again:EdSe}
     {The Replace dialog:Replace}

.topic RegExp
  Regular expressions
  
These expressions are a means to declaratively describe sets of
strings. Each expression has an associated set of strings, and
complex expressions are built from simpler one using operators.
.endpara
The following expressions and operators are currently supported:

  constants
  
Each character except '.','+','*','\','(',')','[',']' and '|' is a
valid regular expression and describes itself. By prefixing them with
a backslash, you can even use the special characters listed above.
The dot '.' is a wildcard and matches any character.
     a          matches 'a'
     \          is not a valid regular expression
     \\         matches '\'
     .          matches '0','1','2','a','b','c','d',...
     \.         matches '.'

  constant sets
  
A set of characters in brackets matches any one of the characters, if
the first character after the [ is not an ^.
.endpara
If it is an ^, then the expression matches any character that is not in
the set.
     [cae]      matches exactly one of the chars 'a','c','e'
     [^ca]      matches any single character except 'a' or 'c'
Order in the set is not important, with the notable exception of ^.

  alternative
  
Two regular expressions separated by a bar | form a new regular expression
matching all strings fro the first or from the second expression.
     a|b        matches 'a' or 'b', but not 'ab' nor 'ba'

  parenthesis
  
Surrounding an expressiion with parentheses '(', ')' does not change the
set of strings the expression matches, but the operator precedence.

  concatenation
  
Concatenating two regular expressions forms a new regular expression,
which matches all ordered concatenations of strings from the first and
the second expression.
     ab         matches the string 'ab'
     (a|c)(ce)  matches the strings 'ace' und 'cce'

  closure (socalled Kleene-closure)
  
A regular expression, followed by a star '*' matches any string built up
by repeatedly concatenating strings matched by the expression. There may
be no concatenation at all, resulting in the empty string ''.
     a*         matches '','a','aa','aaa', and more 'a's
     (abc)*     matches '','abc','abcabc','abcabcabc',...

  repetition (socalled positive closure)
  
The same as with normal closure, but at least one string must go into the
resulting string. This operator can be modelled by using closure and
concatenation.
     v+         matches 'v','vv','vvv' and so forth
     (Ha)+      matches 'Ha','HaHa','HaHaHa',...

  empty expression
  
The empty string is a valid regular expression and matches itself.
     (|line)    is valid and matches any of the two strings
                '' and 'line'.

The operators '*' and '+' have strongest precedence, '|' has lowest.
Therefore, the regular expression "ab|ac*" matches the strings 'ab','a',
'ac','acc','accc' and so forth. Using parenthesis, you can change
the binding of the expression's operators.

see: {Find dialog:Find}
     {Replace dialog:Replace}

.topic Replace Replace1 Replace2 Replace3 Replace4
  Replace dialog
  
This dialog enables you to find text and replace
it by another string. The replacing can be controlled
by four switches:

'Case sensitive', 'Whole words only' and '{Regular expression:RegExp}'
are the same as in the {Find} dialog.

'Prompt on replace' requires confirmation before replacing.

'Replace all' starts at the top of the file and
goes on to the end -- there is no need for
{Search again:EdSe} or Ctrl-L.

see: {The internal editor:InEd}
     {Edit-functions menu:EdFu}
     {Edit-funcsFind:EdFi}
     {Edit-funcsReplace:EdRe}
     {Edit-funcsSearch again:EdSe}
     {The Find dialog:Find}

.topic PrFi
  Print file-Dialog
  
In this dialog you can set the page range to be printed, adjust the margins,
give additional printer options and select the printer to be used.

The input lines for the margins accept only correct dimensions, and
the ones for the page range accept only valid TeX page numbers. If one
of these conditions is not met, printing will not be started and the
input line in question will be selected. You may leave an input line
blank, the associated template will then be expanded to the empty string.
Using the {modifier:Modifier} '-' with the {templates:Templates} %sl,
%st, %ss and %se will then delete the associated option text.

The Printer button shows the menu name of the printer driver used for
printing. If you press it, the {OptionsOutput:OpOu} dialog lets you
select another printer driver.

see: {TeXPrint:TePr}
     {OptionsOutput:OpOu}
     {General}

.topic What What0 What1 What2 What3 What4 What5 What6 What7 What8
  Save what
  
With this dialog the set of options to be stored into an option file can be
modified. The TeXShell will propose only those option groups which have been
changed since a TEXSHEL  L.CFG has been saved or loaded.

With the arrow keys and the space bar or with the mouse you can select
options. If you do not select any option, nothing will be done.

The Programs option group represents all tool button programs in all dialogs;
these programs can therefore saved apart from the other options. If this
option group is selected, a second dialog allows you to select the programs
to be saved.

Cancelling any of both dialogs will save nothing.

see: {OptionsSave options:OpSa}
     {Options menu:Options}

.topic Clean Cln0 Cln1 Cln2 Cln3 Cln4 Cln5 Cln6 Cln7 Cln8 Cln9 ClnA ClnB ClnC ClnD
  Delete what
  
With this dialog the set of files to be deleted by {Clean up:FiCl} can be
modified. With the arrow keys and the space bar or with the mouse you can
select files. The initial set of files is given in the
{OptionsTeX optionsAuxiliary files:OpFoEx} input line.

see: {File menu:File}

.topic Viewer
  internal viewer
  
This is a view window, showing the
contents of the file whose name is
shown in the title bar. With the scroll
bars, PageUp, PageDn, Home, End or the
arrow keys you can move the window over
the file.

With the functions {Edit-funcsFind:EdFi}
and {Edit-funcsSearch again:EdSe} you
can search for text.

If the file in this viewer is the TeX logfile
of the primary file, you can press Enter within
an TeX error message to get the cursor
positioned into the editor on the line with
the offending text.

see: {Edit-functions menu:EdFu}
     {The Find dialog:Find}
     {The Replace dialog:Replace}
     {TeXLogview:TeLo}
     {General}

.topic Editor
  internal editor
  
This is an edit window. It allows the
contents of the file named in the title
bar to be edited. If the file name is
'Clipboard', it is the {clipboard:WiCl}
used by all other edit windows for
copying text blocks. If the file name
is 'Untitled', then this edit window
contains a new file.
With the scroll bars or the arrow keys
you can move the window over the file.

see: {The internal editor:InEd}
     {Internal editor key codes:EdTa}
     {Edit-functions menu:EdFu}
     {FileSave:FiSa}
     {FileSave As:FiAs}
     {FileNew:FiNe}
     {General}

.topic WiLi
  Window list
  
This dialog displays a list of all
windows from which one may be selected
as the new current window. In the list
all windows are shown with their type
(edit,view,info) and contents.
With the arrow keys or the mouse you
can select a window.

see: {WindowsNext:WiNe}
     {WindowsPrevious:WiPr}
     {General}

.topic OS2
  OS/2 programs
  
The TeXShell is able to start genuine OS/2
programs from within the OS/2 DOS box. To do
this job, it needs the program os2execd.exe
written by Eberhard Mattes which will serve
as a launcher. It accepts commands via the
pipe [Directories]OS/2-Pipe and returns the
DosExitCode to the initiating program, i.e.
the TeXShell.

Note: The TeXShell sets the environment as
under DOS, but does NOT set the PATH, PROMPT
and COMSPEC environment variables. You will
have to include \emtex with the appropriate
drive in your OS/2 PATH.

This feature requires OS/2 2.x. The TeXShell
will then run in a DOS box, and os2execd.exe
has to be started before the TeXShell tries
to start an OS/2 program; otherwise you will
get an error message, and TeXShell will try
to run the program as a DOS program.

see: {OptionsTools:OpTo}
     {Add/Edit tool:EdTo}

.chars ô:=
.topic Syntax
  Syntax highlighting
  
Syntax highlighting means emphasizing syntactic elements of TeX by
different coloring. In TeXShell, this is done line by line; therefore,
neither math mode nor arbitrary environments can be highlighted.
.endpara
TeXShell distinguishes 11 different syntactic elements:
  text           : everything that TeX will print, including spaces
  space          : spaces that are ignored by TeX
  macro name     : a backslash followed by letters
  macro chars    : a backslash followed by non-letters
  punctuation    : .,_+-!;:~*|&/`' etc.
  active chars   : e.g., the " used by german.sty for umlauts
  comment        : everything from a % up to the end of line
  numbers        : everything consisting of digits
  macroargument  : # followed by a digit
  parenthesis    : [](){}$
  others         : all invalid characters

Each syntactic element can have its own color, which can be set
using the OptionsColor:OpCo dialog.

The set of characters that make up a syntactic element are not hard-wired
into TeXShell but configurable (although not from within TeXShell). In the
[Editor] section of configuration files there is a new line starting with
the keyword 'SyntaxChars'; the rest of the line consists of nine sets of
characters, separated by the bar '|'. These sets are, in order:
 1. letters:                @a-zA-Z
 2. digits:                 0123456789
 3. space:                  ' ',Tab,CarriageReturn,LineFeed
 4. parenthesis:            (){}[]$
 4. macro-begin:            \
 5. active characters:      "
 6. punctuation:            ,.-;:_<>+~*^@!|&/=?`'
 7. macro argument:         #
 8. start of comment:       %
 9. invalid characters:     everything else

No character may appear in more than one set, and no set may be empty.
For non-printable characters, the bar '|' and the backslash '\' there
is a special notation to write them down: A backslash followed by a
number denotes the character with that ASCII value, and the backslash
followed by a character denotes the character itself. In both cases
the resulting character is not interpreted, thus allowing to include
the bar as \| into a set, or Tab as \9.

see: internal editor:InEd

