File	Date	Author	Commit
data-noarch	2010-12-31	Leonius	[51052d] Adding i18n
src	2011-01-01	Leonius	[073de6] FIXED: <conf> file processing order and their m...
.gitignore	2010-12-30	Leonius	[da3623] English help system is done
COPYING	2010-03-04	Leonius	[e17e1c] Backup before build try
Doxyfile	2010-08-29	leonius	[ebf6e0] Non-functional changes
INSTALL	2010-12-30	Leonius	[77f9da] <v1.4.3> is so close
Makefile	2010-12-31	Leonius	[21294d] Adding...
NEWS	2010-12-25	Leonius	[3314d3] FIXED: small source packaging error
README	2010-12-30	Leonius	[77f9da] <v1.4.3> is so close
for-supported-do.sh	2010-12-25	Leonius	[3314d3] FIXED: small source packaging error
qte2console-generic.t	2010-08-29	leonius	[7e3de6] Ready to public
qte2console-setenv-ezx.sh	2010-12-29	Leonius	[ebe922] In process of adding custom text-displaying wid...
qte2console.pro	2010-12-31	Leonius	[21294d] Adding...
qte2console.t	2010-12-29	Leonius	[ebe922] In process of adding custom text-displaying wid...
setenv-ezx.sh	2010-12-25	Leonius	[9f6d85] ADDED: <alpha> versions for VE66, EM35, VA76, Z...
tmake.conf	2010-12-30	Leonius	[da3623] English help system is done
update-mobile.sh	2010-12-27	Leonius	[bb7c24] ADDED: keybinding for phones without <SIDE_UP>,...

Read Me

qte2console
This README is for version 1.4.2 .
Qt Embedded 2.3.8 terminal emulator for Motomagx mobile phone Motorola EM30 (and, maybe, some other Motomagx/MotoEZX)
By Leonius <leonius@inbox.ru>.
Based on <ezxterm> from Lahu <lahu3672@googlemail.com>.

Quickstart, keypad controls: see help via "Left->Help" menu in <qte2console>.

Compilation/Installation: see INSTALL
License: see COPYING
New in this version (user-visible changelog): see NEWS

End of real "README" portion, there follows reference.

****** REFERENCE ******

*** FEATURES ***

Features:
*	Terminal emulation suitable for many programs
*	Support for long outputs
*	<utf-8> output (so, cyrillic output also can be performed) (NO <UTF-8> INPUT!)
*	Scrolling
*	Multi-tap (multi-press) input method with "Shift" and "Caps Lock"
*	Ability to run any command, not only shell ("-e" option)
*   Help from menu :)

Also:
*	Fullscreen mode
*	Program output logging
*	Show of command exit status
*	Configurability by command line options, key=value config files 
	accepting same keys and values as command line 
*	Configurability by internal script-like language for keypad and menus
*	Customization of colors, font	
*	"Shadow installation" of its command
*	(Broken: Hiding/unhiding)

*** Shortcut Installation ***

If there is writable </ezxlocal/bin> directory on your machine then on every invocation <qte2console.sh> (and <qte2console-unhide.sh>) makes "shadow install": installs light "shortcut" script in folder mentioned. 
It means that that's very probable that you'd run <qte2console> from shell by typing "qte2console" literally. This will accept all options mentioned below.

*** Command Line ***

Usage: qte2console [options] [startup shell]
Often it's better to run qte2console.sh or qte2console-unhide.sh "launcher". 

Examples are in "Left->Help->Notes" menu item.

Main options are:
	-e                 Run a command
						specified from after
                        end of this option
                        till command line end
  --eval arg            Evaluate string as in this program's internal script
                        syntax
  --conf-file arg       Evaluate file as key-value pair config file
  --help                Provide command line options help

There are some other options which are discoverable by "--help".

*** Configuration File ***

Your keybindings by default are in <qte2console.conf>; you can view this file through menu item "Left -> View Conf... -> qte2console.conf".
It contains examples of internal script language (nealy all that can do, heh).
In fact, syntax of configuration file is nearly same as command line syntax.

Note that "many" strings go through control sequence unescaping, some are 
	2 times. These replacements are:
* "\x", "\n", "\b", "\t", "\'", "\"", "\\" like in C
* "\$" -> "$"
* "${MYPATH}" -> <Program root path>  (where there are directories bin, 
	share, etc...)

*** More ***

About hiding/unhiding: i cannot make it stably working on my <EM30>. But there was reports that e.g. on <E8> everything works OK.

*** The End ***