mc/lib
Slava Zanko 2ebdf91079 Merge branch 'm-utf-8'
* m-utf-8: (223 commits)
  Fix wildcard pattern in file select and file find dialogs
  Project builds with option --disable-charsets
  Deleted build-glib1.sh because glib1 don't work with utf-8
  fix building without --enable-charset
  Total replacement to mc_search stuff in all places
  Search engine: if found_len parameter NULL, then mc_search_run don't try to fill them
  src/view.c: Reworked search stuff to usage src/search
  refactoring: rename edit/editcmd_dialog.c:editcmd_dialog__get_search_types_list to
  Search engine: development of hex search complete
  Search engine: remove forgotten debug string and reindent file
  Search engine:
  configure.ac: if present glib-2.14 and higher, libpcre don't linked
  Search engine: now used regexp external engines:
  src/find.c: Fixed core dump if content search pattern no present
  edit/editcmd_dialogs.c: fixed state of search type between dialog window calls
  Find files: checkbox 'Regular expression' for content search now default unchecked
  Find files: changes for usage of new search engine:
  Fix copy of current/opposite path to command line: remove charset info from path
  src/Makefile.am: add some header files to Make-tracking
  Fixed editor menu reloading.
2009-05-07 13:01:01 +03:00
..
.gitignore Added .svnignore files (same as .cvsignore) 2008-12-28 23:27:03 +02:00
cedit.menu Update postal address of Free Software Foundation. 2005-05-27 03:35:10 +00:00
ChangeLog * lib/mc.ext.in: Play .flv files. 2007-11-02 14:20:27 +00:00
edit.indent.rc Update some URLs. From Frederic L. W. Meunier <lists@pervalidus.tk> 2003-09-28 20:04:05 +00:00
edit.spell.rc * lib/cedit.menu: Remove all references to the error file. 2002-08-24 17:39:07 +00:00
Makefile.am * lib/*.ti: Remove, these files are obsolete. 2003-09-23 06:11:19 +00:00
mc-wrapper.csh.in * lib/mc-wrapper.sh.in: Handle user names with spaces. 2006-02-28 22:42:52 +00:00
mc-wrapper.sh.in * lib/mc-wrapper.sh.in: Don't use "$()" construct as it is not 2006-03-18 13:05:52 +00:00
mc.charsets Add UTF-8 charset to list of charsets. 2009-01-26 12:20:41 +02:00
mc.csh.in Remove argument passing, it's not needed for aliases. 2002-11-01 19:48:45 +00:00
mc.ext.in Merge branch '324_viewing_man_w_references' 2009-04-17 21:33:18 +03:00
mc.hint changed the HQ to http://www.midnight-commander.org/ 2009-01-11 21:37:27 +01:00
mc.hint.cs patches by Rostislav Beneš: mc-27-hint 2009-01-26 12:00:33 +02:00
mc.hint.es patches by Rostislav Beneš: mc-27-hint 2009-01-26 12:00:33 +02:00
mc.hint.hu patches by Rostislav Beneš: mc-27-hint 2009-01-26 12:00:33 +02:00
mc.hint.it patches by Rostislav Beneš: mc-27-hint 2009-01-26 12:00:33 +02:00
mc.hint.nl changed the HQ to http://www.midnight-commander.org/ 2009-01-11 21:37:27 +01:00
mc.hint.pl patches by Rostislav Beneš: mc-27-hint 2009-01-26 12:00:33 +02:00
mc.hint.ru patches by Rostislav Beneš: mc-27-hint 2009-01-26 12:15:35 +02:00
mc.hint.sr patches by Rostislav Beneš: mc-27-hint 2009-01-26 12:00:33 +02:00
mc.hint.uk patches by Rostislav Beneš: mc-27-hint 2009-01-26 12:00:33 +02:00
mc.hint.zh patches by Rostislav Beneš: mc-27-hint 2009-01-26 12:00:33 +02:00
mc.lib added patch by angel_il on #219 2009-02-03 19:10:58 +01:00
mc.menu * mc.menu: %d is already quoted, so it must not be written "%d". 2005-09-06 06:01:07 +00:00
mc.menu.sr * lib/mc.hint.sr: Updated. 2003-09-22 21:04:59 +00:00
mc.sh.in lib/mc.sh.in: fixes for non-bash shells (fixing #196) 2009-02-04 22:39:27 +01:00
mcserv.init * lib/mcserv.init: Update from Red Hat package. 2002-08-26 03:46:17 +00:00
mcserv.pamd * lib/mcserv.init: Update from Red Hat package. 2002-08-26 03:46:17 +00:00
README.xterm * INSTALL: Remove information about Tk and XView. Change the 2001-05-18 16:28:22 +00:00
xterm.ad Fix typos. 2003-09-23 05:54:27 +00:00

                     Solving keyboard related problems
                               with XTERM
                        and GNU Midnight Commander
                       (and other programs as well).

Xterm brings a handful of problems with input keys and their translations.
Some of these problems include xterm's failure to make a difference between
shifted and not shifted function keys (many keyboards do not have more than
10 or 12 function keys, so it is useful to generate higher function keys (11
- 20) by pressing Shift and function key - 10 (e.g. Shift+F3 is F13). Xterm
also doesn't send Alt+character and Meta+character as something other than
plain character. Also, home key does not work on most systems. And keypad
operator characters (+, -, /, *) send different sequences than normal +, -,
/, * (or sometimes do not send anything).

Please note that if you want to use the Alt key on an XTerm, you have to
make sure you use:

XTerm*eightBitInput: false

Otherwise, you will just get accented keys.

Fortunately this can be solved, since xterm is written on top of the 
X Toolkit Intrinsics, which has a built-in feature of event translation
tables that can be specified using X resources. This doesn't apply to rxvt,
where the only solution to this problem would be patching rxvt's sources and
recompiling. So from now on, we are speaking only about xterm (and its
modifications, like color_xterm and ansi_xterm).

Xterm brings two new Xt widgets (if you don't know what they are it doesn't
matter), vt100 and tek4014 (these are used for the terminal display in vt100
and tektronics mode). The translation table is specified in
*vt100.translations and *tek4014.translations resources.
You can see a sample in xterm.ad file in this directory. 

If you want to install these translations, bear in mind that you have to
keep your terminfo and termcap in sync with these. So if you install
xterm.ad, you have to install xterm.ti and xterm.tcap (or do necessary
changes yourself).

xterm.ad has to be loaded into the Xrm (X resource manager), either by xterm
itself or by xrdb utility. There are many places you may want to install it
to; the decision is yours. Preferably it should go to your personal
$HOME/.Xdefaults file (if you have any). This file is automatically loaded
using xrdb whenever you start the X server (it is done by startx and openwin
scripts). Another possibility is to put this into
$X11ROOT/lib/X11/app-defaults/XTerm or wherever your app-defaults file of
xterm is and whatever is its name (sometimes it will have to be XTerm-ansi,
XTerm-color etc.) Or you can put this anywhere and call 
          xrdb xterm.ad
from any script you run on X11 startup.

xterm.ti (terminfo database source) is installed by running `tic xterm.ti'.
tic will compile it and place it into your TERMINFO directory.

xterm.tcap is the xterm (and xterm-color) termcap entry. It is based on the
newest termcap database from http://www.ccil.org/~esr/ncurses.html, but
contains a bunch of changes to make all the above mentioned keys work. Even
if mc is compiled so that it uses terminfo, you need to install the termcap
entry so that other programs which use termcap will behave correctly. You
have to edit your /etc/termcap and replace xterm and xterm-color entries
with those from xterm.tcap.

The xterm.ad translation table contains many items (some of them may be
unnecessary) but are included only to make it work on all different xterms
(xterm terminfo and termcap databases have different sequences for the same
keys in every different database, so xterm.ad works as a stardard to make
xterm.ti and termcap happy). If you find that xterm works well even if you
delete some lines from the translations, feel free to do it.

By default,  Alt+character keys received by mc are generated in xterm.ad by
Alt modifier plus the key. On some systems, you may want to change this to
the Meta modifier (e.g. if the Alt modifier is missing). You do it by
replacing a letter s at the beginning of table lines with letter m.

And what you might want to know, if you are going to change anything, is:
Each line looks like
	modifiers<Key>keyname: string("something") \n\
where modifiers can be:
a for alt
m for meta
c for control
button1 (2, 3) for mouse buttons.

  The string is generated whenever the named key is pressed while the
modifiers are in a state matching the specification.  Naming a modifier
specifies that the modifier must be pressed.  A ~ in front of a modifier
name specifies that the modifier must NOT be pressed.  If the set of
modifiers is preceded by !, unmentioned modifiers must not be
pressed; otherwise their state is ignored.

After <Key> you specify a name of the key (if you don't know a canonical
name of any key, see $X11ROOT/include/X11/keysymdef.h (keynames are the
names there without leading XK_). Then there can be any sequence of string
statements which send the string to the tty line, as if the user typed that
sequence of characters. If it has the form string(0xXX), where X's are
hexadecimal digits, then the ascii character of that value is sent rather
than 0xXX.

This is a subset of all the translation table features. If you want a
complete reference, see xterm(1) and X Toolkit Intrinsics manual Appendix B.

Please, if you find any problems or errors in this stuff, let me know by
e-mail to 
mc-devel@gnome.org.