home *** CD-ROM | disk | FTP | other *** search
- Brief documentation for TOS2GEM dated 19.01.1995
- ================================================
-
- 1. What is TOS2GEM?
- -------------------
- TOS2GEM is an Auto folder program which GEM applications can access in
- a flexible way to display the output from TOS and TTP programs as VDI
- text in a Console window.
- TOS2GEM makes the ideal Console window for use with shells or alternative
- desktops and saves the programmer some effort!
-
- TOS2GEM was principally designed for use under Single TOS and although it
- runs fine under Geneva, MagiC and MultiTOS its use is limited as these
- each include their own Console window.
-
- TOS2GEM features at a glance:
- -Directs the output of TOS/TTP type programs into a GEM window.
- -Simulates TOS screens of various sizes (not just boring 80x25) in any
- size window.
- -Works with all monospaced fonts irrespective of size.
- -Optional scroll buffer allows output to be reviewed.
- -Offers almost complete VT52 emulation (with the exception of colour
- sequences)
-
-
- 2. Installation
- ---------------
- Copy TOS2GEM.PRG to the Auto folder of your boot partition. TOS2GEM
- installs a Cookie which can be used to control some of TOS2GEMs
- functions. TOS2GEM.PRG can also be run from the desktop.
-
-
-
- 3. What is T2GRESET.PRG?
- ------------------------
- Programs must reserve TOS2GEM for themselves; until released other
- programs cannot make use of TOS2GEM.
- If a program which had reserved TOS2GEM crashes or is exited without
- releasing TOS2GEM you can use T2GRERSET.PRG from the desktop to release
- TOS2GEM. It's not a good idea to run T2GRESET.PRG if an application
- which has reserved TOS2GEM is still running as this inevitably causes
- serious complications.
-
- 4. T2G_BSP.PRG and PRIMZAHL.TOS
- -------------------------------
- These utilities are part of the main TOS2GEM distribution but not
- included in the Atari World Reader disk distribution.
-
- 5. Where is the programmers documentation?
- ------------------------------------------
- It's still under development at the moment. The final release will be in
- ST-Guide hypertext format and include detailed information explaining how
- to call TOS2GEM from your own programs. The current incomplete German
- documentation is available on request to anyone that wants them on the
- understanding they are for your own personal use.
-
- 6. Disclaimer
- -------------
- Although TOS2GEM and the associated utilities have been carefully
- programmed and thoroughly tested I cannot guarentee no bugs remain. I,
- Thomas Binder, do not accept any liability or responsibility for any
- direct or indirect damage that may arise, either financial, material
- or any other kind from either the use or misuse of TOS2GEM and its
- associated applications, utilities and documentation. All trademarks
- mentioned in the TOS2GEM documentation are acknowledged and
- recognised.
-
- 7. Distribution
- ---------------
- With my permission the mini version version of TOS2GEM including this
- limited documentation has been translated for the Atari World Thing
- Reader disk by Joe Connor and is NOT for general distribution.
-
- The complete archive is Freeware and available from all good PD
- libraries and BBSs. The complete package includes:
-
- TOS2GEM.PRG, T2GRESET.PRG, TOS2GEM.H, TOS2GEM.TXT, T2G_BSP.PRG,
- PRIMZAHL.TOS and, when completed, TOS2GEM.HYP and TOS2GEM.REF.
-
- 8. Contact details
- ------------------
- If you'd like a copy of the incompleted German DOCs, help programming for
- TOS2GEM, praise, criticism or simply a chat, here are my details:
-
- Thomas Binder
- Johann-Valentin-May-Strasse 7
- 64665 Alsbach-Haehnlein
- Germany
-
- InterNet: binder@rbg.informatik.th-darmstadt.de
- IRC: Gryf
-
- Please include a disk and SAE (Self Addressed Envelope) along with
- either an International reply coupon (or a second disk) to receive the
- latest DOCs.
-
- TOS2GEM has taken a considerable amount of my free time to develop and
- if you'd like to contribute to ensure I continue to support the Atari
- platform please don't hesitate to do so!
-
- My banking arrangements are:
- Dresdner Bank AG Frankfurt am Main
- Account No: 9 024 050 00
- Sort code: 500 800 00
-
- Thanks a lot!
-
- 9. What programs support TOS2GEM?
- ---------------------------------
- Currently two main programs use TOS2GEM as Console windows:
- -POVSHELL v1.3 onwards, programmed by Dirk Klemmt:
- Email: klemmt@informatik.uni-frankfurt.de
- -Thing alternative desktop, programmed by Arno Welzel:
- Email: aw@zaphot.augusta.de
- Other programmers are interested but until I'm 100% certain we'll leave
- it at that.
-
- 10. Credits
- -----------
- The following people either directly or indirectly took part in the
- development of TOS2GEM (in alphabetical order):
- -Alexander Clauss
- -Frank Danapfel
- -Dirk Klemmt
- -Harald Schönfeld
- -Thomas Schulze
- -Arno Welzel
-
- 11. History
- -----------
- Omitted from this translation
-
-