This is the TeX integrating GoldEd enviroment, (at this time) a collection
of ARexx macros to provide control over TeX from within GoldED.

This is a "just working -- don't expect more" version. some of the script are
simple adaptions of the original scripts by Jörg Höhle, René Laederach and
Georg Hessmann I found in the PasTeX distribution. I added some more scripts
for LaTeX environment handling and control of DVIPrint.

I haven't found any copyright notice in the original scripts, so I used them
as a basis for my code. I hope the original authors don't mind. Otherwise leave
me a note, please.


IMPORTANT:

My email address suddenly changed. It is now

beren-st@reze-1.rz.rwth-aachen.de

Don't use the old address any longer.

Except from this, *nothing* has changed!


COPYRIGHT:

All files in this archive are © copyright 1995, 1996 by Stefan Berendes except
the files in the directory SetActiveWin © copyright 1993 by Franz Schwarz.

They may be freely redistributed but not included in a commercial software
bundle. Feel free to use it and to adapt them to your personal needs but
please -- do not distribute any changed version.

This is notifyware. If you use it and find bugs, enhancements, suggestions
or the like, you must tell me that. Also, if you changed the macros, please
send me a copy of the changed macros (except for personal adaptions).

There are two reasons for this: First I want to know what to improve. As said
above, this is just a running system. Currently, I use it to write a study
thesis, and it works for me. But I myself already found some things I would
like to have changed. Perhaps I will do that if I have the time to do. But if
I get some echo from this distribution, I can make a more user--based design.
Second, I don't want to have thousands of versions implementing different
additional features.


INSTALLATION:

This package requires installations of PasTeX 1.4 and GoldED 3.x. it may work
with earlier versions but I haven't tested. It doesn't feature an installer
script.

Simply copy all the files ending in .ged to GoldED:Arexx/ and the file
texedit.rexx to TeX:rexx (make a backup of the original file).

Copy SetActiveWin to C: or a directory in your command path.

Include the macros in your GoldED menu/keyboard setup. I have included some
GoldED 3.13 setup files as examples.


DESCRIPTION:

begin_environ.ged - starts a new LaTeX environment, i.e. \begin{...}. You can
choose some common used environments from the list or type in an environments
name by selecting "other". No additional setup required.
To do: read environment names from a file.

end_environ.ged - ends the current LaTeX environment, i.e. \end{...}, by
searching for the appropriate \begin{} and taking the environment name.
No additional setup required.

printdvi.ged - prints the .dvi file of the current .tex source. You can choose
between double-sided and single sided printing. Besides this, you can print
four pages on a sheet of paper in papersave (1,2/3,4) or book modus (1,2/N-1,N)
using dvidvi. This does only work good for one paper size and setup. Additional
setup: in the file, adjust the margins for dvidvi so that your texts fit best
(use the testpage.tex from LaTeX). You must also specify the printer codes
that set your printer into landscape/portrait modus, because dviprints
landscape option does not bring satisfying results. The default codes are for
Laserjet (PCL4) compatible printers.
To do: a much, much more user friendly interface, e.g. set printing ranges.

reconfig.ged - this is a macro for GoldED. It takes the name of the current
file and loads configs according to the filename extension. Because GoldEd
reopens its screen when loading a new .prefs file, the macro will load every
single config file. The config file names must be of the same base, e.g. my
config files are called ENV:GoldED/Stefan*, that can be given as the
argument to the macro. If omitted, the base defaults to GoldED:presets/GoldED*.
The rules are simple. The macro first looks for a file called
<base>_std.<prefext>, e.g. Stefan_std.men. If this file is found, nothing
happens.  Use this for configs you don't want to change, e.g. GUI and Menus.
Then it looks for a file named <base>_<textext>.>prefext>, e.g. Stefan_TeX.men.
If this is not found, it loads a file named <base>.<prefext>, e.g. Stefan.men.
Either a _std or this file MUST exist for every config type. So these should
be the files that your GolED.prefs is made of.
The macro recognizes some extensions as alias, e.g. for .sty and .cls files it
will load the config for .tex files. You can change/extend this in the macro
code. Syntax should be clear.
I recommend to assign this macro to a keyboard shortcut so you can quickly
call it. If you like, you can add it to the "Activate next window" or "Arrange
window" sequence so it is automatically called for the actual text. But if
you have some text windows open, it will always reload if you scroll through
them. See also startup.ged below.

startup.ged - is my very personal startup macro. It does copy the config
presets to env:GoldED/ and call the reconfig.ged macro if a text is loaded.
If you use it, don't forget to set the reconfig argument appropriately.
This macro heavily depends on my personal setup.

Start_TeX.ged - calls the TeX--Server to TeX the current TeX source.
Arguments are the format to be used and the name of the virtex to be used, e.g.
"&latex virtex-big-20" on my system.

TeX-Server_quit.ged - well, this is crippled shareware. If you pay me $100 I will
send you the missing documentation for this command ;-).

TeX-Server_start.ged - starts the TeX-Server that is used to control the TeX engine.
Must have a console window for output named "TeX System#?.
Arguments: The pubscreen of the console window plus two optional arguments. If
these are set to "ASK" the TeX--Server prompts for editing setup / requesting
of format upon startup. Difficult to explain. Set them first to ASK and see
what happens. If you don't like the requesters, omit the arguments. The setup
will be the same as if you press return for both requesters.
The macro uses PToFront and SetActiveWin to bring the console window to front
when TeXing a file (That's why the name must be TeX System*).

TeX_xxxxError.ged - can be used to move around the errors in your .tex source.
Best to assign this to keyboard shortcuts. TeX-FirstError.ged works like
texedit.rexx, except that it does NOT reload the .aux file the error parsing is
based on!.
To do: after error parsing, reset search expression and wildcard use. Not
supported by GoldED ? Same with end_environ.ged.

TeX_ShowLog.ged - load the .aux file for the current .tex text.

ShowDVI.ged - calls ShowDVI for the .dvi file of the current .tex file. If
you specify the argument "ASK", it will prompt to really load showdvi if it
is not already running.


Sorry for this quick and dirty, bad english description of the macros. If
there are any requests, I will do a better one here. One of the reasons to
write my owm macros was that I don't know what the existing ones exactly did.


AUTHOR:

Stefan Berendes
Königstr. 62
52064 Aachen
Germany

Phone: +49 241 871609

Email: beren-st@reze-1.rz.rwth-aachen.de