What is Conholio?
=================

It's a terminal emulator! What you do in there is your business. However, there
are a few notable differences compared to the de-facto standard terminal (i.e. TosWin):

 - Conholio is based around the concept of tabs. Each tab holds its own terminal and
   environment, and it's possible to switch tabs using a ALT+Fxx. While it's possible
   to use multiple windows as well, tabs are generally recommended since they put less
   strain on the CPU.

 - Conholio has an optional fullscreen mode, invoked using ALT+RETURN. This feature
   uses the VDI and is available on all machines provided that there is enough RAM.

   On the Falcon, Conholio can optionally access the frame buffer directly to provide
   a faster fullscreen display. This feature is enabled by default, but can be disabled
   in the configuration file if desired (in such case, the VDI will be used on the
   Falcon as well). It's possible to use custom screen resolutions by editing/replacing
   the file 'conholio.scp', which contains video data in Screens of Pain format.
   There are some premade modes in the 'videomodes' folder.


System Requirements
===================

Conholio is written with "high end" systems in mind, but should work on any
machine with a 020 processor or better. Fastram is recommended, since the text
rendering engine is designed around that.

 - 020 or better CPU (040 or higher recommended)
 - 4 megs of free RAM. Maybe more. I haven't checked.
 - XaAES/FreeMiNT release 1-16-0 or newer


Installation
============

 1. Copy the Conholio folder to some place on your drive.

 2. Make sure that the binary is executable:
     - In TeraDesk, select conholio.app -> show info -> check the 'x'-checkbox.
     - Alternatively, type chmod +c conholio0nn.app in the conholio folder.


Basic Operation
===============

Keyboard combos:
 - ALT+Fx        Switch to Terminal (F10 = /dev/console)
 - ALT+RETURN    Toggle fullscreen
 - HELP          Corresponds to F11
 - UNDO          Corresponds to F12

To use the mouse feature in Lynx: 'lynx -use_mouse'

Note: At this point, Conholio doesn't support tw-call.prg.


Configuration File
==================

Conholio loads its settings from 'conholio.cfg'. This is a plain ASCII-file which can
be altered using any text editor. The configuration settings are described in detail
inside that file.


Known Issues
============

 - Don't open multiple console (/dev/console) tabs. It's not dangerous, but screen updates look funny.
 - Don't paste stuff to the console (/dev/console).
 - Conholio doesn't work with the EmuTOS VDI. Not sure why, but I'm not sure it matters.
 - The VT10x emulation is about 90% finished. Most stuff work, but there may be issues.
 - the VT52 emulation hs been tested for about 3 seconds. Stay away from it.
 - Some of the VT10x character set CSIs are bogus at this point.
 - Application & numeric keyboard handling isn't finished nor does it work as intended.
 - Special keys are handled incorrectly in VT52 mode.
 - Mouse doesn't work in fullscreen mode (yet).
 - In <=8bpp modes, Conholio takes a while to start on slower machines. I should fix that.


Special Thanks
==============

Some people have been really supportive and given me good constructive feedback on this stuff.

 - Evl, for providing suggestions and feedback
 - Havoc, for suggesting the use of YUV-based colour mapping
 - ggn, for supporting the project and providing a lovely 4x8 font
 - Beetle, for using and supporting this stuff :)
 - Helmut, for providing the TOP sources (found the bug!)
 - Nerve, for using it :)
 - FredL2 for testing it on the CT2
 - and the rest of you darlings. Stay Atari :)


Enjoy!

-- Peter Persson (pep.fishmoose@gmail.com)
