mined
[ -
/+
options ]
[ +
line ]
[ +/
search ]
[ files ... ]
xmined
...
umined
...
lmined
...
wmined
...
This manual contains the main topics
Online help is also available.
mined x
mined x y z
cmd | mined
cmd
;
a file name for saving can be given later
mined x > y
mined | mail nn
cmd1 | mined | cmd2
cmd1
(output)
and cmd2
(as input)
xmined ...
umined ...
lmined ...
wmined ...
+
number
+/
expr
-v
--
++
-
" or "+
".
+x
-r
-R
+R
+u-u
-uu
and is now on by default).
-u
(character set)
-EU
, ignored
if the terminal is configured or detected to be in CJK mode.
-l
(character set)
+u
which is
still valid for compatibility.)
-EL
, ignored
if the terminal is configured or detected to be in CJK mode.
+u-u
(character handling)
-uu
and is now on by default).
-b
(character handling)
-c
(character handling)
-C
(character set and terminal mode)
-E
X (character set)
-E
X (character set)
-E
X (character set)
-K
X (input method handling)
+K
(input method handling)
-U
(terminal mode)
-U
option or environment setting).
In the latter case, -U
deselects UTF-8 terminal operation.
This option should normally not be used as the mode should
be configured in the environment (see
Locale configuration).
+U
(terminal mode)
-U
or +U
needs to be used if
the environment is correctly configured to indicate
UTF-8 as it should (see
Unicode handling / Terminal environment).
+UU
(terminal mode)
-cc
(terminal mode)
+c
(terminal mode)
-C
(character set and terminal mode)
-CC
(terminal mode)
-C
, and override UTF-8
terminal auto-detection.
This enforces the assumption of a CJK terminal unless
UTF-8 terminal mode is also configured by environment
variable setting.
+C
(character set and terminal mode)
-C
, but characters
encoded in a CJK encoding format are displayed transparently
even if they do not map to a valid Unicode character.
+CC
(terminal mode)
+C
, but even
character codes that do not match the encoding scheme
(e.g. wrt. to specified byte ranges) are written
transparently to the terminal.
+CCC
(terminal mode)
+CC
and overrides
auto-detection of the terminal capability to display
CJK 3-byte / 4-byte codes which would by default
suppress their display if the terminal does not support them.
-G
(terminal mode)
-A
(input handling)
-w
-a
+j
+jj
-j
-T
-Q
X
-Qs
or -Qr
),
-Q
option),
-Qs
or
-Qr
or
-Qf
).
-4
-8
-+4
-+8
-L
N
-e
+V
-V
.)
-W
-B
-k
-*
-m
(default)
+m
-M
-o
N
-o
without a subsequent digit toggles scrollbar.)
-p
-t
< TAB >
-X
-s
-S
-d
N
-P
All options are also looked for in the environment variable MINED.
The right-hand cursor block of typical keyboards is assigned the most important movement and paste buffer functions.
+------+------+------+ | (7) | (8) | (9) | | Mark | ^ | PgUp | +------+------+------+ | (4) | (5) | (6) | | <- | HOP | -> | +------+------+------+ | (1) | (2) | (3) | | Copy | v | PgDn | +------+------+------+ | (0) | (.) | | Paste | Cut | +------+------+------+
Note that the mined keypad function assignment as shown here
deviates from the more usual assignment of Home/End to
"move to beginning/end of line" and Delete to "delete character".
This is deliberately designed to provide more useful functions
to easily available keys, while e.g. line movement can also
easily be achieved with HOP cursor-left or HOP cursor-right,
respectively, and character deletion can still be done with
the Delete key on the smaller keypad.
This keypad function assignment gives you the
best benefit of keypad usage and is thus considered
much more useful than the commonly expected "standard assignment"
although now and then a user is irritated by it.
-k
option switches
to the more common assignment by exchanging the
unshifted keypad assignments with the Alt- assignments,
keeping the mined assignment available with Alt.
-k
mode,
the more common function assignments (line navigation
and character deletion) are always assigned to
Control-Home/End/Delete, while the paste buffer
functions are always assigned to Shift-Home/End/Delete
(at least on the small keypad).
HOP - char left | move cursor to beginning of current line |
HOP - char right | move cursor to end of current line |
HOP - line up | move cursor to top of screen |
HOP - line down | move cursor to bottom of screen |
HOP - scroll up | scroll half a screen up |
HOP - scroll down | scroll half a screen down |
HOP - page up | move to beginning of file |
HOP - page down | move to end of file |
HOP - word left | move cursor to previous ";" or "." |
HOP - word right | move cursor to next ";" or "." |
HOP - delete tail of line/line end | delete whole line |
HOP - delete whole line | delete tail of line |
HOP - delete previous character | delete beginning of line |
HOP - set mark | go to mark |
HOP - search | search for current identifier |
HOP - search next | repeat previous (last but one) search |
HOP - copy/cut | copy or cut, but append to buffer |
HOP - save buffer | save buffer, but append to file |
HOP - paste buffer | paste "inter-window buffer", which is the last saved buffer by any invocation of mined on the same machine by the same user. |
HOP - edit next file | edit last file |
HOP - edit previous file | edit first file |
HOP - exit current file | exit mined |
HOP - suspend | suspend without writing file |
HOP - show status line | toggle permanent status line |
HOP - enter HTML tag (alternate opening/closing) | embed copy area in HTML tags |
Configuration hint: To enable mouse operation in a Windows DOS box, deactivate "QuickEdit mode" in the properties menu.
Scrollable menus: In a low-height terminal (e.g. 24 lines), especially the Encoding menu and the Input Method menu may not fit on the terminal. In this case, they are scrollable with cursor keys, including Page Down/Up, Home, End keys.
Note: Your mouse driver may be configured to generate multiple (e.g. 3) mouse wheel events on one mouse wheel movement (e.g. with Windows).
Configuration hint: On Unix, in order to make Alt work
as a modifier, set the xterm resource metaSendsEscape to true
as suggested in the example file Xdefaults.mined
.
(With older versions of xterm, setting eightBitInput to false
may be required instead; this xterm option doesn't actually
disable 8 bit input as its name might suggest.)
+V
option.
-p
that
distinguishes paragraph/line end display.
Auto indentation is automatically suppressed if text is entered very fast (by heuristic detection of input speed) in order to allow unmodified copy and paste using terminal mouse functions.
Xdefaults.mined
in the Mined
runtime support library.)
-+4
or -+8
, a TAB key input will be
expanded to an appropriate number of Space characters instead
of inserting a TAB character. You can still insert a literal
TAB character with Control-V TAB.
ctags
command).
HOP ESC t prompts for an identifier. (Also available from
search or popup menu.)
If a new file is opened for this purpose, the current
file is saved automatically.
In addition to the current position, mined also stores the paragraph justification margins (only if automatic paragraph justification is active) and the selected Smart Quotes style.
mined --
[ filenames ... ]
In restricted mode, only the file opened when mined was started can
be edited, no commands changing file name reference, involving other
files (copy/paste), or escaping to a shell command will be allowed.
(When mined is invoked without filename argument, a file name
will be prompted for despite restricted mode, however.)
uprint
is installed and configured
properly, printing works in any selected character encoding.
See Printing configuration for further
details.
?
": this flag menu offers options
for permanent File info, Char info, or
Han character information display.
For the latter, further options can be selected
to configure the information shown.
--
": no keyboard mapping
is active.
U8
":
Unicode/ISO 10646 character set / UTF-8 encoding
-l
/ -E
/ -C
16
" or "61
":
Unicode character set / UTF-16 encoding
(big-endian or little-endian, respectively)
-l
/ -u
/ -E
/ -C
L1
": Western
"Latin-1" character set / ISO 8859-1
(other 8 bit character sets handled transparently
if terminal font matches)
-u
/ -E
/ -C
WA
":
Western "ANSI" character set / Windows "codepage" 1252
(superset of Latin-1)
CY
":
Cyrillic character set / KOI8-RU encoding
(Russian, Ukrainian, Bjelorussian)
MR
":
Mac-Roman character code
PC
":
PC DOS character code ("codepage 437")
B5
":
Traditional Chinese character set /
Big5 encoding with HKSCS extensions
-u
/ -l
/ -E
GB
":
Simplified Chinese character set /
GB18030 encoding, includes GBK encoding,
includes GB 2312 / EUC-CN encoding
-u
/ -l
/ -E
CN
":
Traditional Chinese character set /
CNS / EUC-TW encoding (including 4-byte code points)
JP
":
Japanese character set / JIS X 0208 / 0212 / 0213 /
EUC-JP encoding (including 3-byte code points)
-u
/ -l
/ -E
sJ
":
Japanese character set / Shift-JIS encoding
(including single-byte mappings to Halfwidth Forms)
-u
/ -l
/ -E
KR
":
Korean Unified Hangul character set / UHC encoding,
includes KS C 5601 / KS X 1001 / EUC-KR encoding
-u
/ -l
/ -E
Jh
":
Korean Johab character set and encoding
VI
":
Vietnamese character set / VISCII encoding
-u
/ -l
/ -E
/ -C
TC
":
Vietnamese character set / TCVN encoding
TI
":
Thai character set / TIS-620 encoding
ç
": combined display mode
`
": separated display mode:
combining characters are separated from their
base character and displayed with coloured background
H
": HOP applies to next command
h
": HOP not active
E
": text is being edited
V
": text is being viewed (modification inhibited)
=
": cut/copy replaces (overwrites) paste buffer
+
": cut/copy appends to paste buffer
»
": auto-indentation enabled: entering a newline
indents the following line like the current one
¦
": auto-indentation disabled
j
": justification only on request (ESC j command)
j
": justification is performed whenever
text is entered beyond the right margin
J
": justification is performed whenever
text is inserted and the line exceeds the
right margin (slightly buggy)
": non-blank line end terminates
paragraph (blank space at line end continues paragraph)
«
": empty line terminates paragraph
-o1
option.
«
| LF (Unix-type line end)
change with MINEDRET or MINEDUTFRET, may contain up to 3 characters to configure different appearance |
µ
| CRLF (MSDOS-type two-character line end) |
@
| CR (Mac-type line end)
transparently handled and displayed with +R command line option
|
º
| NUL character (pseudo line end) |
¬
| "none" line end (virtual line end as used to split input lines too long for internal handling; will be joined into a single line when saving the file) |
·
| non-breaking space (character code hex A0) |
«
| Unicode line separator |
¶
| Unicode paragraph separator |
¶
| end of paragraph (if enabled by -p )
change with MINEDPARA or MINEDUTFPARA |
»
| line extending the end of the screen line
(move cursor right to shift line display) change with MINEDSHIFT |
·
| position spanned by TAB character
change with MINEDTAB or MINEDUTFTAB, may contain up to 3 characters to configure different appearance within the TAB span |
profile.mined
in the
Mined runtime support library.
Default values are compiled in and can be overridden by setting
the variables to empty values.
-Q
is available to configure your
style preference; see also
Terminal interworking problems for configuration hints
to deal terminal-related graphics display trouble.
-Q
).
-Qv
command line option.
For the most common Western European accents, the following function keys are defined as accent prefix keys:
F5 | diaeresis: composes next input character with diaeresis, e.g. a » ä |
Shift-F5 | tilde: composes next input character with tilde, e.g. a » ã |
Control-F5 | ring: composes next input character with ring or with cedilla, e.g. a » å , c » ç |
F6 | acute: composes next input character with acute accent (accent d'aigu), e.g. a » á |
Shift-F6 | grave: composes next input character with grave accent, e.g. a » à |
Control-F6 | circumflex: composes next input character with circumflex accent, e.g. a » â |
For the Sun keyboard, the function keys R4/- , R5/÷ , R6/× , R3 , R1 , R2 are attached to the same prefix functions, in this order.
For Vietnamese input support, the following additional
accent prefix keys may be configured
(see Xdefaults.mined
in the
Mined runtime support library):
Control-1 | acute: composes following character with acute |
Control-2 | grave: ... |
Control-3 | hook above |
Control-4 | tilde |
Control-5 | dot below |
Control-6 | circumflex |
Control-7 | breve |
Control-8 | horn |
Control-9 | stroke |
Alt-1 | circumflex and acute |
Alt-2 | circumflex and grave |
Alt-3 | circumflex and hook above |
Alt-4 | circumflex and tilde |
Alt-5 | circumflex and dot below |
Control-Alt-1 | breve/horn and acute: composes following A/a with breve and acute, or following O/o or U/u with horn and acute |
Control-Alt-2 | breve/horn and grave: ... |
Control-Alt-3 | breve/horn and hook above |
Control-Alt-4 | breve/horn and tilde |
Control-Alt-5 | breve/horn and dot below |
For accent compositions, mnemonic patterns
(generic accent mnemonics) are listed in the following table;
the respective letter to place the accent(s) on is indicated
with an "x
" below.
generic mnemonic | accent placed on the base character ("x ")
|
---|---|
x: or "x
| diaeresis (umlaut) |
x' or ´x
| acute (accent d'aigu) |
x! or `x
| grave |
x> or ^x
| circumflex |
x? or ~x
| tilde |
x0 or °x
| ring above |
x,
| cedilla |
x-
| macron |
x(
| breve |
x.
| dot above / middle dot |
x_ or _x
| line below |
x/
| stroke |
x"
| double acute |
x;
| ogonek |
x<
| caron |
x2
| hook above |
x9
| horn |
x-> or >x
| circumflex below |
x-. or .x
| dot below |
x--. or .x-
| dot below and macron |
x.-. or .x.
| dot below and dot above |
x7 or x.-
| dot above and macron |
x~- or x?-
| tilde and macron |
x;-
| ogonek and macron |
x:-
| diaeresis and macron |
x-:
| macron and diaeresis |
x-'
| macron and acute |
x-!
| macron and grave |
-x
| topbar |
--x
| bar |
,x
| comma below / left hook |
x#
| double grave |
x)
| inverted breve |
x&
| hook |
%x
| retroflex hook |
x,,
| palatal hook |
x~~
| middle tilde |
x-? or ?x
| tilde below |
x--: or :x
| diaeresis below |
x-0 or ox
| ring below |
x-( or (x
| breve below |
x(-. or .x(
| breve and dot below |
x>-. or .x>
| circumflex and dot below |
x9-. or .x9
| horn and dot below |
x'.
| acute and dot above |
x('
| breve and acute |
x(!
| breve and grave |
x(2
| breve and hook above |
x(?
| breve and tilde |
x<.
| caron and dot above |
x,'
| cedilla and acute |
x,(
| cedilla and breve |
x>'
| circumflex and acute |
x>!
| circumflex and grave |
x>2
| circumflex and hook above |
x>?
| circumflex and tilde |
x:'
| diaeresis and acute |
x:<
| diaeresis and caron |
x:!
| diaeresis and grave |
x9'
| horn and acute |
x9!
| horn and grave |
x92
| horn and hook above |
x9?
| horn and tilde |
x0'
| ring above and acute |
x/'
| stroke and acute |
x?'
| tilde and acute |
x?:
| tilde and diaeresis |
Mnemonic character substitution commands (ESC _ and national variants) replace the two characters (or the HTML character tag) at the cursor position with a suitable composite character (e.g. accented character) if possible.
Xdefaults.mined
in the Mined runtime support library).
mkkbmap
script
(from tables in various formats as used by other editors) and
then compiled into mined.
See configuration hints below for details.
Keyboard mapping works as follows: You enter a key sequence
that is mapped to a character sequence in the selected
keyboard mapping table. The transformed character sequence is
used as input.
As some typical keyboard mappings contain ambigous key
sequences where one may be a prefix of another, a short delay
is applied in these cases to allow recognition of any such
sequence to be mapped. After a timeout, the shorter sequence
already matching will be used; the timeout can be cut short by
typing a Space key, the Space character itself will then be
discarded. (The timeout value is 900 ms by default and can be
configured with the environment variable MAPDELAY.)
-K
.
While navigating through the pick list, the line and the selected item in the line are highlighted accordingly; if the current item is a CJK character, also its character information (description and optionally pronunciations as configured with the Han info option of the '?' information flag menu) is displayed on the status line. If the item is a word comprising multiple CJK characters, the information for only the first of them is shown. The available information is derived from the Unihan database.
Keyboard mapping data are based on Unicode. So in CJK text mode, the selection menu (the pick list) may contain symbols that are not mapped to the active CJK text encoding. In a UTF-8 terminal, these will still be displayed but cannot be inserted. In a CJK terminal, these are not displayed; an empty entry is shown instead.
--
"
if no mapping is active.
The active mapping can be selected in the following ways:
-u
or
-l
).
It also detects UTF-16 with BOM (byte order mark U+FEFF) which
can represent the complete 21 bit Unicode subset of ISO-10646.
Since mined 2000.10, UTF-16 is maintained transparently, i.e.
a UTF-16 encoded file is written back in UTF-16 again (with BOM).
No explicit menu/command line options are currently available
for UTF-16 as internal handling is done in UTF-8. However, the
character encoding flag indicates UTF-16 with either
"16
" (big endian) or
"61
" (little endian).
U8
" if UTF-8
text interpretation is selected. For Latin-1 text interpretation
"L1
" is shown, for others see
Mode indication flags.
You may click on the indication flag to toggle between the
current and the previous selected encoding.
With HOP ESC u, permanent display is toggled. Other commands insert the code of the current character or insert a character taking its encoding from the text. For details, see the command summary.
See also the generic section Character input support above for input support for accented characters and Keyboard Mapping.
--
| if preceded by a Space character: en dash (U+2013)
otherwise: em dash (U+2014) |
-
| if an adjacent character is in the Hebrew script range: Hebrew hyphen mark Maqaf (U+05BE) |
<-
| leftwards arrow (U+2190) |
->
| rightwards arrow (U+2192) |
<>
| left right arrow (U+2194) |
+UU
.
+u-u
).
Xdefaults.mined
in the
Mined runtime support library.
Illegal UTF-8 sequences are displayed with highlighted background, using the following indications. Furthermore, control characters encoded as a UTF-8 sequence and control characters in the "C1" range (values 0x80..0x9F) will be displayed similar to normal control characters but with coloured highlighting.
8
| for an unexpected UTF-8 continuation byte (range 80-BF) |
4
| for a 0xFE (254) byte |
5
| for a 0xFF (255) byte |
«
| for a too short UTF-8 sequence if followed by a single-byte character (00..7F) |
»
| for a too short UTF-8 sequence if followed by a multi-byte character (C0..FF) |
Legal Unicode characters that cannot be displayed are indicated with the following replacements:
e
| the character code U+FFFE |
f
| the character code U+FFFF |
¤ or
¤ (if wide)
| a Unicode character that cannot be displayed in the (non-UTF-8) terminal (non-combining) |
' or
'
| a Unicode combining character that cannot be displayed in the (non-UTF-8) terminal |
E
| the Euro character U+20AC (in a non-UTF-8 terminal) |
0 ..9 ,
A ..Z
etc
| a corresponding fullwidth ASCII character (in a non-UTF-8 terminal) |
¤ 46
").
(Note: Terminal support for combining charcters is
auto-detected; additional command line options are available
in case this fails.)
If mined operates on a terminal that handles combining
characters, it offers two editing modes: combined or separated.
They can be toggled by clicking the Combining display flag
in the Mode indication flags area
(right part of the top screen line),
or by the menu entry "eXtra - combined display";
separated display mode can also be selected by the
command line option -c
.
Xdefaults.mined
in the
Mined runtime support library.
With mlterm, enable this with the sample configuration
file mlterm_key
in the
Mined runtime support library.
Control-Backarrow can also be configured to work with xterm
but doesn't appear to work with rxvt or mlterm,
use F5 Backarrow instead.
+UU
right-to-left display
option or auto-detected), the joined character width will
be handled correctly in cooperation with the terminal.
+U
selects UTF-8 terminal mode.
uterm
" in the
Mined runtime support library.
For more details, see Locale configuration.
mkkbmap
script.
¤
| CJK character that cannot be displayed in (8-bit) terminal |
' or
'
| CJK combining character that cannot be displayed in (8-bit) terminal |
? or
?
| CJK character code that has no known mapping to Unicode
(to enforce display on CJK terminal use option +C )
|
# or
#
| invalid CJK character code that is outside of the
code range assigned to the encoding scheme
(to enforce display on CJK terminal use option +CC )
|
#
| CJK character in extended code range
(esp. 3 and 4 byte codes, or codes with 0x80...0x9F
byte range) that cannot be displayed on CJK terminal
due to terminal capability limitations
(to enforce display on CJK terminal use option +CCC )
|
<
| incomplete or otherwise illegal CJK code |
?
" flag.
The same information is always shown while you are browsing
an input method pick list (then on the status line).
The information includes the character code (in CJK encoding,
both CJK code and corresponding Unicode value are shown).
The amount of descriptive information (from the Unihan
database) to be shown can also be preconfigured with the
environment variable MINEDHANINFO;
see Han info configuration below.
-EX
where X is one of the character encoding tags (see the
encoding options above).
-E
parameter) to disable auto-detection of other encodings.
UTF-8 auto-detection cannot be disabled this way.
-C
lets
mined assume to handle CJK encoded text and to operate in a
CJK terminal (unless auto-detection determines a UTF-8 terminal).
With HOP ESC u, permanent display is toggled. Other commands insert the code of the current character or insert a character taking its encoding from the text. For details, see the command summary.
-E
option (together with the
-C
option in case CJK terminal auto-detection fails) or by a
locale indication in one of the environment variables LC_ALL,
LC_CTYPE or LANG.
For available encodings and usage of the -E
option,
see Mode indication flags.
For usage of the locale environment variables, see
Locale configuration.
+C
. These and
other invalid CJK character codes are displayed with special
indications (see CJK character display below).
The options +C
, +CC
, +CCC
control the level of display
transparency for unknown character codes on CJK terminals
(see Command line options above for details).
-C
) or by
proper setting of the locale environment
(LC_ALL, LC_CTYPE or LANG variable).
For usage of the locale environment variables, see
Locale configuration.
Mined Command reference (command and key function assignments)
|
profile.mined
in the Mined runtime support library.
usrshare
); if mined is
installed into standard locations, they are copied to one of the
directories /usr/share/mined
,
/usr/share/lib/mined
,
/usr/local/share/mined
,
/opt/mined/share
,
$HOME/opt/mined/share
(depending on operating system and installation options).
Mined runtime support includes the following files:
README
CHANGES
profile.mined
Xdefaults.mined
xinitrc.mined
mlterm_main
mlterm_key
uprint
mined.hlp
minedmar
minedmar.bat
uterm
mterm
umined
lmined
xmined
wmined
wmined.bat
mined.desktop
configure-xterm
makeprint
installfonts
bdf18to20
bdf18to20.sed
Recognition of some special terminal features or restrictions is associated with the setting of TERM (xterm, linux, vt100, sun*, cygwin, rxvt, *ansi*, 9780*, hp*, xterm-hp, superbee*, sb*, microb*, scoansi*, xterm-sco, cons*, att605-pc, ti_ansi, mgterm).
For detection of function keys and cursor keys, the escape sequences being used by terminals are often not known to an operating system environment because they are poorly and incompletely configured. Because this does usually not work as expected (see this bug report just for an example), mined does not rely on the termcap/terminfo configuration of function key codes; rather it always accepts a wide variety of typical codes. A few ambiguous codes are resolved according to the TERM variable.
In an xterm, window headline and icon text are set to the current filename and "(*)" is added if the text has been modified.
Special DOS terminal handling (remote login to Unix):
If the environment variable TERM begins with "pcansi", "nansi",
"ansi.", or contains "-emx",
mined assumes the terminal to run the PC character set
(codepage 437) so this supports remote login from a DOS system
or Windows telnet (in a DOS box) to Unix. If the effective
encoding used via the remote connection is rather Windows-ANSI
(codepage 1252), TERM should be "cygwin" instead.
Note: The character set or codepage being used depends
on the telnet program; cygwin telnet always emulates Windows
codepage 1252 and sets TERM=cygwin, so mined detects it
correctly; the older Microsoft telnet GUI client uses Windows
codepage 1252 and sets TERM=ansi; the newer Microsoft telnet
console mode client always uses DOS codepage 437 ("pcansi")
(even if started from a cygwin shell with codepage 1252 emulation)
and sets TERM=ansi; so mined cannot determine the encoding based
on TERM=ansi. If you use the newer Microsoft telnet console
mode client, please set TERM=ansi.sys or TERM=pcansi on
the Unix machine to adjust this.
Native DOS terminal handling: Cygwin emulates the Latin-1 character encoding in a DOS box window (unless reconfigured with the CYGWIN variable) instead of the IBM PC character set that a DOS box runs by default. This may produce unexpected appearance of non-ASCII characters when editing DOS files; even editing the same file in the same DOS box alternatingly with cygwin mined or djgpp mined will exhibit this change of character display. Mined detects, however, the environment setting "CYGWIN=codepage:oem" and behaves accordingly.
Running mined in a dosemu session (DOS emulator on Linux)
works fine, even in an xterm-embedded session although not
perfect in that case: ^S and ^Q are interpreted for flow
control (thus ^S will hold all output until ^Q is entered),
and the mined option -Qa
should be
used to tune menu borders right.
Unicode: UTF-8 | suffixes: .UTF-8 / .utf8 |
Traditional Chinese (Hongkong): Big5 with HKSCS | suffixes: .BIG5* / .Big5* / _HK / _TW (_TW ambiguous, .euctw may follow) |
Simplified Chinese: GB18030 (includes GBK and GB2312) | suffixes: .GB* / .gb* / .EUC-CN / .euccn / _CN |
Traditional Chinese (Taiwan): CNS (EUC-TW) | suffixes: .EUC-TW / .euctw |
Japanese: JIS / EUC-JP | suffixes: .EUC-JP / .eucjp / .euc (.euc ambiguous, kr/tw/cn may follow) |
Japanese: Shift-JIS | suffixes: .Shift_JIS / .sjis |
Korean Unified Hangul: UHC (includes EUC-KR) | suffixes: .UHC / .EUC-KR / .euckr |
Korean: Johab | suffixes: .JOHAB |
One of the problems with locale conventions is that there is
no explicit distinction between text encoding and terminal
encoding although this is obviously a very different thing and
mixed combinations of both may occur and are actually supported
by mined. For this reason, mined follows a pragmatic approach:
For text encoding, mined checks the variables
LANG, LC_ALL, LC_CTYPE in this order.
The encoding command line options (-u, -l, -E) override this
environment preference (unless for non-CJK encoding in CJK
terminal which is not supported).
For terminal encoding, mined checks the variables
LC_ALL, LC_CTYPE, LANG in this order.
Thus it is possible to specify for example that
mined runs in a UTF-8 terminal and should assume GB text encoding
by default:
LC_CTYPE=whatever.UTF-8
LANG=zh_CN.gbk
An encoding specification with the -E
parameter takes
precedence over environment configuration.
If mined performs auto-detection of CJK encoding, it can
be configured which encodings are to be taken into account
for detection.
For this purpose, set the MINEDDETECT environment variable
to the list of encoding indications (capital letters as listed
for the -E
parameter) to
disable auto-detection of other encodings.
UTF-8 auto-detection cannot be disabled this way.
Xdefaults.mined
which lists settings that should be applied to the terminal
for proper operation of several features as described
throughout this manual.
Depending on the terminal you use, the resource class
"XTerm" may have to be adapted (copying entries) to apply
to your terminal as well.
In some terminals, the cursor may not be well visible or not
visible at all if the cursor is on a character
with reverse background (control character, occurs e.g. in xterm)
or highlighted background (invalid character code, occurs e.g.
in xterm and rxvt).
See the X resource parameters for "cursorColor" in the example
configuration file Xdefaults.mined
for remedy.
If your terminal scrolls down one line when you click the left mouse button in the text area, the terminal type is not properly set up. This occurs, e.g., when you run inside a cygwin or rxvt terminal but the environment variable TERM is incorrectly set to xterm. Set it to the correct value for remedy.
If mouse wheel movement moves more than expected, especially if it cannot move by single items in a menu, this is probably a configuration issue with your mouse driver. You are probably running a Windows-based X server which is (often by default) configured to generate multiple mouse wheel events on each actual mouse wheel movement. Often not even in the Control Panel mouse section, but only in a configuration menu of mouse-specific setup software (e.g. "Browser Mouse Settings"), configure the scroll unit to 1.
any terminal: menu border display
any terminal: slow terminal feature auto-detection
export ESCDELAY; ESCDELAY=3000
export ESCDELAY; ESCDELAY=1200
mlterm
hanterm
rxvt
Xdefaults.mined
from
the Mined runtime support library.
konsole Due to the lack of decent Unicode font support in the default configuration of the KDE konsole terminal, menu appearance options -QQ and -Qr should not be used; rounded borders are disabled by default.
cxterm
DOS console
PuTTY
profile.mined
in the
Mined runtime support library
for Siemens 9780x terminals.
export MINEDKEYMAP=-gr
will set Greek keyboard mapping standby.
export MINEDKEYMAP=py-rs
will set Pinyin input method active and Radical/Stroke
input method standby.
export MINEDQUOTES="»"
sets these »inward« quotes and corresponding single smart quotes.
export MINEDQUOTES="»»"
sets these »Swedish» quotes and corresponding single smart quotes.
M | show Mandarin pronunciation |
C | show Cantonese pronunciation |
J | show Japanese pronunciation |
S | show Sino-Japanese pronunciation |
K | show Korean pronunciation |
V | show Vietnamese pronunciation |
P | show Hanyu Pinlu pronunciation |
T | show Tang pronunciation |
D | show character description |
F | display full information (in popup-menu form); without F, the information will be shown on the status line where it is subject to truncation |
Xdefaults.mined
in the
Mined runtime support library for suggestions.
uprint
from the
Mined runtime support library
to print the current contents of the text being edited
in any selected encoding (unless the environment variable
MINEDPRINT is set to direct mined to use a different print command).
paps
or
uniprint
for actual formatting (print preprocessing).
paps
is available at
http://imagic.weizmann.ac.il/~dov/freesw/paps/ and uses the
pango layout engine for formatting.
uniprint
is part of the yudit distribution; if
you don't have it installed on your system, there is another
script makeprint
in the support library which can
be used to download and build the needed uniprint program.
The mined print script (uprint
) prefers
paps
if it is available as it has more capabilities
for printing a wide range of Unicode characters, and it does
right-to-left formatting.
profile.mined
in the Mined runtime support library.
src/colours.cfg
; it contains entries with the
script name (as listed in the Unicode data file
Scripts.txt
), blank space, and a colour index
into the xterm 256-colour mode. (To make good use of 256
colour mode, the terminal program should be compiled with 256
colour support enabled. Configure xterm with
configure --enable-256-color
.)
colours.cfg
before building mined to
adapt coloured script display to your preferences.
src/keymaps.cfg
and a script mkkbmap
; go into the
src
directory and use the script to generate
additional keyboard mappings:
The parameter to the mkkbmap
script can be one of
mkkbmap
will then generate an according
keyboard mapping file, e.g. for Bopomofo
keymaps.cfg
; the
entry is however initially disabled as it usually needs manual
adjustment: edit the configuration file; enable the new
entry by removing the leading '#' character, check the first
element which will be the name of the mapping to appear in the
Input Method menu, check the last element of the entry
which is a two-letter shortcut and must be unique for all
mappings, then move the entry to the position where you want
it to appear in the menu. You can also group mappings by
adding "-" lines in this configuration file.
DOS binaries: Two DOS-based versions, compiled with djgpp and with cygwin, are available for download from the mined web site http://towo.net/mined/ for users who want a quick binary on DOS-based systems. The djgpp binary is a "dual-mode" executable which runs on plain DOS and also supports long file names in a Windows 98/2000/... DOS box (not NT4.0).
Highlight mode: The ANSI codes for selecting normal and exposed display can be chosen with the environment variable MINEDCOL. The two selections are separated by a space. Each selection is a semicolon-separated list of the code values. The default behaviour corresponds to the setting
For command line options, "/
" can be used instead of "-
".
The "ESC -" command cannot go back within a group of files named by the same wildcard expression. It goes to the previous file name (or wildcard expression) instead.
Enabling the keypad HOP key: If you have a very old and crappy BIOS, you may have to enable use of the cursor block "5" key (for use as a HOP key) with a TSR driver (ENHKBD.COM) or an enhanced keyboard driver. (Older PC keyboard drivers were often so ignorant to forbid you to use that key.)
Immediate adjustment to changed window size does not work in the DOS version if the size change is caused by a TSR (e.g. VGAMAX using a hotkey); in that case, mined adjusts its screen display only after the next key is typed.
The cygwin terminal environment (cygwin in a DOS box window) provides an emulation of a Unix 8 bit character set so non-ASCII characters entered in this version are different from those entered in other DOS-based versions. Editing UTF-8 text, on the other hand, works transparently in all DOS-based versions. See Terminal environment for more details.
In order to enable mouse use in a DOS box, deactivate
"QuickEdit mode" in the properties menu.
The following only applies if DOS ANSI driver output is used
which is currently not the case in any configuration:
The default colour setting depends on an extended ANSI driver
(like NNANSI) as does the scroll down function anyway.
Unfortunately, there is no way to find out the current colour
setting nor is there an inverse video mode in many ANSI
drivers (only a fixed black on white mode) so that it is
impossible to implement just inverse display for highlighting.
Therefore, if mined thinks to see an ANSI driver of the
simpler kind, it will change its colour setting defaults. In
any case, these can be overridden with the MINEDCOL variable.
Recommended ANSI drivers:
Mined tries to analyse the ANSI drivers capabilities by
checking some control sequences. This works, however, only if
the ANSI driver is at least able to send cursor position
reports.
For primitive ANSI drivers that cannot even do that, mined's
operation can be ensured with an emergency procedure:
A faked pseudo-report should be stuffed into mined as its
first input (with some key-stuffing program) and mined will
use no further cursor position requests. It will also assume a
simple ANSI driver then. The faked report should consist of
the screen size in lines and columns, embedded at the
positions of the ANSI cursor report sequence but with
different surrounding characters. For an invocation of mined
on a 25 lines and 80 columns screen a batch file for this
would look like:
The remaining remarks apply to the Turbo-C version only which is no longer supported (use djgpp instead):
profile.mined
in the Mined runtime support library
together with explanations and suggested values.
man fonts.conf
(Unix:) Mined cannot edit a pipe or device file and hangs if
you try to do so. (But it can insert from, or write to, a pipe.)
This restriction does not refer to editing from standard
input in a piped command like cmd | mined
which works of course.
(MSDOS:) Piped editing from standard input does not work for unknown reason. This restriction does not apply to the cygwin version.
(MSDOS, xterm:) Non-cygwin versions (djgpp etc.) do not work in an xterm for unknown reason. The cygwin version does of course work in xterm.