DragonFly On-Line Manual Pages
uterm(1) Unicode terminal window starter uterm(1)
NAME
uterm - start script for a Unicode capable terminal window
SYNTAX
uterm [ -terminal-options ] [ -e program arguments ... ]
uterm [ -rx | -rxvt ] [ -rxvt-options ] [ -e program arguments ... ]
uterm [ -xt | -xterm ] [ -xterm-options ] [ -e program arguments ... ]
DESCRIPTION
(Note: if there is no dotted line below, use 8 bit terminal environment
for proper display of manual page.)
......................................................
Invoke a terminal window with a reasonably optimized range of Unicode
support, enforcing UTF-8 mode and using the best Unicode fonts found.
Many systems are not yet properly configured to enable easy and
straight-forward use of Unicode in a text-mode terminal environment
(such as xterm or rxvt). The purpose of uterm is to help users to
start a terminal with good Unicode capabilities without much hassle.
Terminal selection
Either of xterm or rxvt-unicode is selected as the terminal application
to start, depending on:
o Availability of rxvt-unicode: The script checks whether
rxvt-unicode is available under the name urxvt (e.g. on
cygwin), or if rxvt is available, whether it actually is
rxvt-unicode (and not an older version). Only if this
check is positive, rxvt is considered.
o User preference, implicit: If the environment variable
TERM starts with "rxvt", rxvt-unicode is preferred.
o User preference, explicit: With the command line option
-rx or -rxvt, rxvt-unicode is preferred. With -xt or
-xterm, xterm is preferred.
o Font selection: If the GNU unifont is selected, rxvt is
chosen.
o In all other cases, xterm is chosen.
Users of mlterm are assumed to start mlterm themselves directly, so
mlterm is not considered. Neither of KDE konsole or gnome-terminal is
currently considered since they cannot be font-configured on-the-fly.
Font selection
The uterm script tries its best to use fonts that provide a maximum of
Unicode support.
o First it checks if you have the 10x20 Unicode font and a
matching 20x20 double width font installed (see
explanation below about CJK coverage).
o If not, it checks if you have the 9x18 Unicode font and a
matching 18x18 double width font installed and uses them.
o If both are not found, it tries to invoke rxvt with the
GNU unifont.
o If either GNU unifont or rxvt are not installed, efont is
tried.
o As a last resort, it tries to invoke xterm with 6x13 and
12x13 fonts.
o As a very last fallback, it invokes xterm with its
configured default fonts.
Note: The efonts are installed on fewer systems than the misc-fixed
fonts so only 1 size of them is considered and at a lower priority. If
you prefer efont, you should configure xterm font usage yourself (using
X resource configuration) and invoke xterm directly.
Note: GNU unifont does unfortunately not work with xterm (or rather
xterm with GNU unifont), so in this case rxvt is invoked.
Information about font usage
Font selection is a matter of both taste and script coverage. The
uterm script uses fonts with a good coverage of Unicode script ranges,
but its order of precedence may not suit your specific needs. In that
case you should configure your exact desired font preference and invoke
the desired terminal (xterm, rxvt) directly. Coverage of certain
scripts would suggest certain font preferences:
o Korean Hangul: GNU unifont
o Devanagari: efont
o Georgian: efont, misc X fonts
o (to be continued)
CJK coverage and the 10x20 fonts
Among the Unicode "misc" X fonts (misc-fixed-...), the 20 pixel size
fonts are much clearer in appearance than the 18 pixel fonts for which
CJK wide fonts (using double cell width in a fixed-width terminal) are
available. Unfortunately, xterm is not yet capable of padding an 18x18
font up to 20x20 pixel character cells for use together with a 10x20
pixel font. The bdf18to20 script, packaged with the mined editor like
uterm, helps with this issue and generates the missing fonts from the
18 pixel double width fonts by padding blank pixels. If you have
installed those, uterm will select 20 pixel fonts as its first
preference.
Note: 20x20 fonts (padded with bdf18to20) are already installed as part
of the xterm package with SuSE Linux 10.0.
Note: The 6x13 pixel font from Unicode misc-fixed-... also has a
matching 12x13 CJK font but that size is really much too small for
serious application on modern desktops which often provide higher
resolutions than traditional workstations.
UTF-8 environment setup
The uterm script enforces UTF-8 mode with the terminal and also sets up
the locale variable environment to reflect UTF-8 terminal encoding. If
necessary, all LC_* and LANG environment variables are modified to
provide a proper environment for applications started inside the
Unicode terminal. (See the inline documentation of the uterm script for
how this is done.)
X resource class
When starting xterm, uterm uses the X resource class UXTerm so you can
configure the desired appearance of UTF-8 mode terminal windows in your
X resource configuration. For rxvt-unicode, the class URxvt can be
used for X resources.
Unicode width data version
If called with an -e option to invoke a specific program in it, uterm
enables the -mk_width option of xterm (if xterm version 201 or newer is
available). This tells xterm to use its own, compiled-in character
width property tables, rather than using system locale information.
The advantage is that this information is often newer (referring to a
newer version of Unicode) than the installed system data. Thus the
user is enabled to use up-to-date Unicode data by using a self-
installed copy of xterm, rather than being stuck with the Unicode data
that the system administrator cares to install. This is especially
useful if the application is known to be able to recognise that Unicode
version, like the Unicode editor mined. The umined script makes use of
this feature to invoke mined in a Unicode terminal with a maximum of
Unicode support.
Keyboard resources for application use
If called with an -e option to invoke a specific program in it, uterm
also enables a number of other xterm resources in order to enable best
keyboard and terminal control for applications:
*VT100*eightBitOutput:true
to enable 8 Bit output (actually not needed in UTF-8 mode)
*VT100*metaSendsEscape:true
to enable ESC prefixing triggered by Alt-key
*VT100*eightBitInput:false
to enable ESC prefixing triggered by Alt-key in old xterm
versions
*VT100*deleteIsDEL:true
to enable distinguishing the two DEL keys on the keyboard
*utf8Title:true
to enable UTF-8 window title strings
FILES
$HOME/.Xdefaults or $HOME/.Xresources
typical location of user's X resource configuration
AUTHOR
The uterm script is an auxiliary script packaged with the mined editor
by Thomas Wolff. Please send comments, suggestions, bug reports to
mined@towo.net.
uterm March 2015 uterm(1)