home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1994 #1
/
monster.zip
/
monster
/
OS2
/
TEXPRT14.ZIP
/
TEXPERT.DOC
< prev
next >
Wrap
Text File
|
1994-03-01
|
11KB
|
253 lines
Small documentation for TeXPERT:
---------------------------------
0.Files in this package:
------------------------
- ReadMe.OS2 - small overview over TeXPERT (OS/2 Version only)
- ReadMe.DOS - dito (DOS Version only)
- TeXPERT.DOC - this documentation
- TeXPERTd.EXE - German version of TeXPERT \ put one of these in a
- TeXPERTe.EXE - English version of TeXPERT / directory in your path
- TeXENV.DAT - default TeX-Environment file for TeXPERT
- emx.dll - emx-0.8h dll, put in a directory in your LIBPATH
for example x:\os2\dll or x:\emtex\dll (OS/2 only)
1.Patterns:
-----------
Patterns are normal ASCII-Files that quickly can be loaded via the pattern
menu. You can define up to 20 patterns and give them a name of your choice.
If you select a pattern from the menu it will replace the text in the current
buffer while the name of the buffer is not changed or will optionally be
loaded into a new (unnamed) buffer.
You can use them for example to load a pattern of a letter...
2.Archives:
-----------
You can invoke "grep" (or another scanner of your choice) from TeXPERT to
scan your texts for a string. Select "Archives - Search for key word".
The names of the files found are stored in a file called "TeXPERT.FND".
You can select a file from this list by calling "Archives - Select text".
To replace grep by another scanner select "Archives options" from the
"Options" menu. In the "Parameter of scan program" %1 represents the search
string, %2 represents the files to scan, and %3 represents the output file
("TeXPERT.FND" on default). The output has to have exactly the same format
as grep.
Note: "grep" is contained in the gnu text utils, available from ftp.cdrom.com
and other sites.
3.TeX:
------
You can call several TeX programs from TeXPERT. You can adjust the programs
to start and their parameters by selecting "TeX options" in the "Options"
menu. You will be asked for:
- Name of menu entry : Text to appear as menu choice in the TeX-Menu.
- Name of program : Filename of the program to be called.
If this is left blank, CMD.EXE (OS/2) resp.
COMMAND.COM (DOS) will be called.
- Options for program : Parameters that will be passed to the program.
(see 3.2.)
- HotKey for invokation: Scancode of the hotkey to call the program.
You may press Ctrl-A and then the hotkey to let
TeXPERT find the correct scancode.
You will also be asked for the type of the dialog to be called before
the start of the program:
- Separator : This program entry will not be executed. Its line
in the TeX-Menu will be marked to be non-selectable.
This is useful to include separator lines in the TeX-Menu.
- No Dialog : The program will be executed without opening a dialog box.
- Preview Dialog: A preview dialog will be opened before starting the program.
- Print Dialog : A print dialog will be opened before starting the program.
- MFJob Dialog : A mfjob dialog will be opened before starting the program.
You may specify some further options:
- autosave file before start: Save current editor file before starting
the program.
- don't use TeX-Environment : see 3.1.
- close window on exit : close window of the program to be executed
when program has ended (OS/2 only)
- session type for program : PM, fullscreen or standard (OS/2 only)
The default settings are adjusted to the normal emTeX package (for TeX
programs) respectively the beta DVI-driver package (for DVI-drivers) of
November 1992.
3.1.TeX-Environment:
--------------------
The programs are passed an environment, that can be entered in a small editor
window by selecting "Options - TeX environment". Note that you HAVE to include
a PATH and a DPATH (OS/2 only) environment entry pointing to "X:\EMTEX" (where
X: is the drive where emTeX is installed) and a COMSPEC entry pointing to
C:\OS2\CMD.EXE (OS/2) or C:\DOS\COMMAND.COM (DOS) respectively. You may also
want to include an EMXOPT environment entry if you use TeX386 or MF386. The
environment is saved in an ASCII file as "TEXENV.DAT" (or what you enter in
"Options - Editor options". If you begin a line in the environment file with
a "+", it is appended to the previous line.
The easiest way to create the environment file is to read your "set-tex.cmd"
via ^KR into the environment editor and to delete all "SET "'s by pressing
^KZ4 (i.e. move block 4 columns right). Then include the PATH, DPATH and
COMSPEC environment strings.
If you want a program to use the standard environment (which is specified
in CONFIG.SYS (OS/2) or AUTOEXEC.BAT (DOS)), check the "Don't use
TeX-Environment" button in its options dialog.
3.2.Parameters of programs to be executed:
------------------------------------------
Within the options string (see above) for each program you may use some
special expressions. They all look like this:
%<name>
or %<name>[<default>]
These expressions will be replaced by the content of the internal TeXPERT
variable <name>. If the content of <name> is empty and [<default>] is used,
the expression will be replaced by <default>.
The following variables are available:
(*) %fullname : full name of the editor/main file (e.g. X:\MYTEX\TEST.TEX)
(*) %name&ext : name and ext of editor/main file (e.g. TEST.TEX)
(*) %path&name: path and name of editor/main file (e.g. X:\MYTEX\TEST)
(*) %name : body of name of editor/main file (e.g. TEST)
(*) %path : path of editor/main file (e.g. X:\MYTEX)
(*) %ext : extension of editor/main file (e.g. TEX)
%begin : first page number (after preview/print dialog only)
%end : last page number (after preview/print dialog only)
(*) %trans : transformation (after preview/print dialog only)
%copies : number of copies requested (after print dialog only)
%fonts : font names (after mfjob dialog only)
%steps : font sizes (after mfjob dialog only)
%model : printer model (after mfjob dialog only)
Variables marked by (*) are never empty; therefore "%fullname[xyz.tex]" is
equivalent to "%fullname".
Three special variables exist: %format, %special1 and %special2
If one of these variables is specified in the parameter string, TeXPERT will
open the editor/main file and scan the first 10 lines of the file for the
string "%format=", "%special1=" resp. "%special2=". The string has to start
in the first column of the file. If TeXPERT finds the required string, it
will replace it in the parameter string by the string that starts after the
=-character up to the next whitespace or linefeed. Otherwise it will use
the default string.
Note that TeXPERT will open the disk file, even if the file is loaded in
the editor. So you have to save your editor file before calling the program
(or specify "autosave" in the options (see above)).
Example:
--------
Editor file: TEST1.TEX TEST2.TEX
Contents: \documentstyle... \documentstyle...
%format=myfmt %special1=1
... ...
expands to:
%format[lplain] myfmt lplain
/tr%special1[%trans] value specified in 1
preview/print dialog
4.Word wrap:
------------
Can be activated by entering a non zero value for "Auto word wrap at column"
in "Options - Editor options".
5.Macros:
---------
Macros can be recorded by pressing ALT-F1. A menu will pop up listing
all recorded macros (if any). You can now choose "Record" to record
a new macro. If you do so, you'll be asked for the name of the macro
and the one ore two hot keys, which will invoke the macro. After
selecting "Ok" all keystrokes you do will be recorded until you press
ALT-F1 a second time. Different macros must differ in their name!
From within the macro menu you are also able to invoke and delete macros.
6.Warranties:
-------------
Exactly none
7.Bugs:
-------
I'm sure there are some, please report them and any suggestions to
jmartin@goofy.zdv.uni-mainz.de
8.Changes:
----------
Version 1.4 (03/02/1994):
- support of wildcards and response files in command line
- TeX options have been changed significantly. Although TeXPERT will
read old configuration files you have to change the TeX-Options!!
(see section 3)
- colors can now be changed
Version 1.3b (09/22/1993):
- TeXPERT looks for its configuration file now in
1. current directory
2. directory where TeXPERT.EXE is (new, OS/2 only)
3. DPATH (OS/2) or PATH (DOS)
- "Main file" now possible
Version 1.3a (09/12/1993):
- fixed some minor bugs
- fixed problems with TeXPERT running in OS/2 2.1 fullscreen sessions
- DOS Version now generally available
Version 1.3 (06/04/1993):
- more options in menu "TeX-Options" (auto-save, start programs in window/
fullscreen, maximized/minimized, etc)
- integrated clipboard (cut, copy, paste)
- bug fixed in handling of small blocks
Version 1.2:
- changed name to TeXPERT because of conflicts with DOS TeXShell
- changed maximum size of environment file to 100 lines
(previously 20 lines)
- changed macro handling:
- macros can be given a name
- macros are now stored in an ASCII file,
so old macros cannot be used with new TeXPERT
- changed TeX-options:
- entry for name of environment file now in Editor-Options
- TeX-menu can now be freely configured
(count and purpose of menu entries is variable)
some examples:
- you can include an editor of your choice in the TeX-Menu
(if you don't like wordstar)
- you can include different TeX's, for examples plain, latex,
amstex, and so on
- Options are now stored in an ASCII file.
so the old configuration file cannot be used with new TeXPERT.
Version 1.1 (called TeXShell):
- Initial release
9.English:
----------
TeXPERT was originally written in German, so please understand that the
English translation is quite bad (you may get a feeling how translated
English programs sound in German's ear ...).
10.Registration:
----------------
TeXPERT is Shareware. To register send a nice postcard of your home village
with some comments on TeXPERT to:
Johannes Martin
Pfarrer-Dorn-Straße 26
D-55127 Mainz
Germany
In addition, any donation is appreciated ...
11.Copying:
-----------
You are allowed to copy this program under the condition that you
- take no money for it,
- leave the copyright statement unchanged,
- copy all files included in this package (see section 0).