Security and safety features

Interactive features

Versatile character encoding support

Text editing features

Small-footprint operation, portability and interworking

This manual contains the main topics

Interactive help is available with F1.

Examples

mined x

edits the file x

mined x y z

edits files x, y, and z

cmd | mined

edits the output of program cmd; a file name for saving can be given later

mined x > y

takes the contents of file x and edits it for writing into y

mined | mail nn

edits a text to be mailed

cmd1 | mined | cmd2

modifies text within a pipe between program cmd1 (output) and cmd2 (as input)

minmacs ...

runs mined in emacs-compatible command mode (like mined -e)

mstar ...

runs mined in WordStar-compatible command mode (like mined -W)

mpico ...

runs mined in pico-compatible command mode (alpha)

xmined ...

starts a new terminal window (xterm or rxvt, depending on current TERM variable setting) and invokes mined in it

umined ...

starts a new terminal window in UTF-8 mode (xterm or rxvt, depending on font availability and usage capabilities) and invokes mined in it

wined ...

(in cygwin) starts mined in a window (using the mintty terminal, applying Windows look-and-feel)

wined.bat ...

(in Windows) starts mined in a window, using Windows keyboard emulation mode

Startup options

+number

Mined positions to the given line number.

+/expr

Mined initially searches for the given search expression. →NEW→ The search can be repeated with F9.

-v

Mined starts in view only mode. The text cannot be modified.

--

Restricted mode (tool mode): no other files can be edited or otherwise affected. (Also triggered if programm name starts with "r", e.g. rmined).

++

End of options; subsequent file name can start with "-" or "+".

+@

Apply extended grooming to file info file; drop entries for files that are not accessible. See File info: Memory of file position and editing style parameters for details.

File handling

+x

Make new files executable (Unix). When cloning a file (with Save As or a similar feature), or if permissions are restricted by the environment (umask setting in Unix), executable permission is set only where also read permission is set.

+bX

Select backup mode, where X is one of:

+zX

Preselect file chooser sort options, where X is one of:

Line end handling (transparent and transforming)

-r

Convert MSDOS line ends (CR LF) to Unix line ends (LF) (stripping CR at line ends). Can be combined with -R or +R. Also sets line end type for new files to LF for the djgpp version (which defaults to CR LF).

+r

Convert Unix line ends (LF) to MSDOS line ends (CR LF) (adding CR at line ends). Can be combined with -R or +R. Also sets line end type for new files to CR LF.

-R

Convert Mac line ends (CR) to Unix line ends (LF). Can be combined with -r or +r.

+R

Recognise Mac line ends (CR) and indicate them on display; nothing is transformed with this option. Can be combined with -r or +r.

+u-u

Interpret Unicode line separator and paragraph separator as normal characters, not line ends (handling them as line ends was previously enabled with -uu and is now on by default).

Character set and character handling

-u (character set)

Interprets edited text as UTF-8, disables UTF and CJK auto detection.
Synonym of -EU.

-l (character set)

Interprets edited text as Latin-1, disables UTF and CJK auto detection.
Synonym of -EL.

+u-u (character handling)

Interpret text as UTF-8, but interpret Unicode line separator and paragraph separator as normal characters, not line ends.

-c (character handling)

Selects separated display mode for combined characters (separating base character and combining characters). This mode can also be toggled from the Options menu or by clicking on the Combining flag (next to the character encoding flag) in the flags area.

-b (character handling)

Toggle "poor man's bidi" mode: input support for right-to-left scripts, based on Unicode script ranges. (Enabled by default unless the terminal is detected to be in bidi mode; so e.g. in mlterm, poor man's bidi is disabled by default.)

-EX (character set)

Where X is one of B/G/C/J/S/K/H: Selects one of the supported CJK character encodings for text interpretation and disables auto-detection of CJK encodings. For details, see CJK encoding support. For more details on supported encodings, see the Character encoding flags listing in the Quick Options (Mode indication) flags section.

-EX (character set)

Where X is one of U/L or another 1-letter character encoding tag: Selects Unicode/UTF-8, Latin-1, or one of the other supported character encodings for text interpretation. For details on supported encodings, see the Quick Options (Mode indication) flags listing.

-E=charmap (character set)

Where charmap is a character encoding name (as reported by the locale charmap command): Selects the respective character encoding for text interpretation. For details on locale-related character encoding configuration, see Locale configuration.

-E.suffix (character set)

Where suffix is a character encoding suffix ("codeset") as used in locale names: Selects the respective character encoding for text interpretation. For details on locale-related character encoding configuration, see Locale configuration.

-E:flag (character set)

Where flag is a 2-letter indication used by mined to indicate the respective text encoding in the Encoding flag: Selects the respective character encoding for text interpretation. For details on supported encodings and their flags, see the Quick Options (Mode indication) flags listing.

-Eu (buffer encoding)

Enables Unicode buffer mode which always maintains the Copy/Paste buffer in Unicode, thus facilitating conversion between different encodings being edited. For details, see Unicode Copy/Paste buffer conversion.

-E? (character set)

Determine the encoding(s) of the text file(s) given as parameters by auto-detection, print out the information and quit.

-E or -E-

→NEW→ Disable text encoding auto-detection and derive it from the locale environment.

-KX (input method handling)

Configure the Space key to perform a certain function in keyboard mapping selection menus ("CJK input method pick lists"), where X is one of: 'n' to navigate to the next choice (like cursor-right), 'r' to navigate to the next row (like cursor-down), 's' to select the current choice (like Enter).

-K=im-im (input method selection)

Select input method and/or standby input method (for quick switching with Alt-k). The syntax is the same as for the optional environment variable MINEDKEYMAP (see below).

Terminal mode

-U (terminal mode)

Toggles UTF-8 screen handling assumption, i.e. selects UTF-8 screen handling unless UTF-8 keyboard input is already selected (by another -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)

Selects UTF-8 screen handling. Note that none of the options -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).
Also, mined performs auto-detection of UTF-8 terminal encoding and UTF-8 terminal features (different width data versions, handling of double-width, combining and joining characters), so even if the environment is not correctly configured, mined should work without this explicit terminal mode parameter.

+UU (terminal mode)

Selects bidirectional terminal support. This mode implies UTF-8 and also assumes that Arabic ligature joining (of LAM/ALEF combinations) is applied; it will be handled by mined accordingly.

+UU-U (terminal mode)

Selects bidirectional terminal support without Arabic ligature joining (like mintty).

-cc (terminal mode)

Assumes that the terminal does not support combining characters. By default - unless otherwise detected - mined assumes that combining characters work on UTF-8 terminals and do not work in CJK terminals.

+c (terminal mode)

Assumes that the terminal supports combining characters. This is enabled by default for UTF-8 terminals, and disabled by default for CJK terminals, unless otherwise detected.

+EX (terminal mode)

Where X is one of B/G/C/J/X/S/x/K/H: Assumes a CJK encoded terminal in one of the supported CJK character encodings. For details, see CJK encoding support.

+EX (terminal mode)

Where X is one of g/c/j: Assumes a CJK encoded terminal in one of the CJK character encodings like G/C/J and also assumes that the terminal cannot display GB18030 4-byte encodings, CNS 4-byte encodings, EUC-JP 3-byte encodings, respectively.

+EX (terminal mode)

Where X is one of U/L or another 1-letter character encoding tag: Assumes a Unicode/UTF-8 or Latin-1 encoded terminal, respectively, or an 8-bit terminal running one of the other supported character encodings. For details on supported encodings, see the Quick Options (Mode indication) flags listing. For details on terminal encoding support, see Terminal encoding support.

+E=charmap (terminal mode)

Where charmap is a character encoding name (as reported by the locale charmap command): Assumes the terminal to have the respective encoding. For details on locale-related character encoding configuration, see Locale configuration.

+E.suffix (terminal mode)

Where suffix is a character encoding suffix ("codeset") as used in locale names: Assumes the terminal to have the respective encoding. For details on locale-related character encoding configuration, see Locale configuration.

+E:flag (terminal mode)

Where flag is a 2-letter indication used by mined to indicate the respective encoding as text encoding in the Encoding flag: Assumes the terminal to have the respective encoding. For details on supported encodings and their flags, see the Quick Options (Mode indication) flags listing.

+E? (terminal mode)

Determine the terminal encoding and further terminal encoding features and properties by auto-detection, print out the information and quit.

-C (character set and terminal mode)

(Deprecated.) Turns a subsequent -E option (with a single-letter CJK tag) effectively into a combined -E and +E option. So mined assumes the given CJK encoding for both terminal encoding (unless overridden by UTF-8 terminal auto-detection) and text encoding. Can be used for quick indication of CJK terminals (e.g. cxterm, kterm, hanterm) if locale environment is not properly set.

+C (terminal mode)

Displays unknown characters on CJK terminal: Assumes a CJK encoded terminal (e.g. cxterm, kterm, hanterm; more specific encoding specification is advisable), and characters encoded in a CJK encoding format are displayed transparently even if they do not map to a valid Unicode character.

+CC (terminal mode)

Displays invalid characters on CJK terminal: Implies +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)

Displays extended characters on CJK terminal: Implies +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.

+D (keyboard assignment)

Setup xterm (by sending dynamic configuration codes) to apply two useful keyboard handling modes: Del key on small keypad sends DEL character rather than an escape sequence and can thus be distinguished from the Del key on the big (numeric) keypad. Prepend ESC to character if pressed with the Alt or Meta key in order to enable Alt-commands (e.g. Alt-f to open the file menu, Alt-Shift-H to enter HTML markers etc). (Unfortunately this cannot be done by default as it cannot be undone because the previous state cannot be detected.) (This xterm setting should rather be configured permanently as suggested in the sample file Xdefaults.mined in the Mined runtime support library.)

+#

→NEW→ Assume dark terminal background and adjust some colours accordingly.

-nc

Suppress usage of terminal colour attributes.

Information display

+H

→NEW→ Enable syntax highlighting for HTML/XML and server scripting.

-H

Disable HTML/XML syntax highlighting.

+?c

Enable character code information display on status line.

+?X

Enable character code information display (implies +?c) with additional information, where X is one of:

+?h

Enable full Han character information display as a popup. In addition to the character description, a set of pronunciations can be selected with the variable MINEDHANINFO.

+?x

Enable compact Han character information on status line. In addition to the character description, a set of pronunciations can be selected with the variable MINEDHANINFO.

+?f

Enable file and position information display on status line (enabled by default). Note that when editing a file that does not fit completely in memory (e.g. large file on old system), this option may cause considerable swapping. In that case, disable the feature with -?f.

-?X

Deselect the respective +? option.

Editing behaviour

-q

→NEW→ Derive quotation marks style from locale information (environment variables LANGUAGE, TEXTLANG, LC_ALL, LC_CTYPE, LANG). See Smart quotes for details. Note: if either LANGUAGE or TEXTLANG is used, -q is assumed implicitly.

-q=locale

→NEW→ Derive quotation marks style from given locale. (-q:locale works too.)

+q or +q=locale

→NEW→ Like -q but exchange primary and secondary style.

-q:style

→NEW→ Set given quotation marks style if available for any language, e.g. -q:"«»". (-q=style works too.)

-w

Recognise fewer places as word boundaries for word skip and delete commands.

-a

Append mode: Append to text buffer or external file for copy/delete commands instead of replacing it.

+j

Set justification level 1 (or increment level previously set by environment variable to 1 or 2): Level 1 initially enables automatic word wrap at line end when typing over right margin. Can be changed by clicking on the j/J flag.

+jj

Set justification level 2: Level 2 initially enables automatic word wrap at line end when typing within paragraph; buggy. Can be changed by clicking on the j/J flag.

-j

Set justification level 1 or 2 (other than previously set). Can be changed by clicking on the j/J flag.

-T

When moving vertically over a Tab character, stay left of the Tab column range (on the Tab character). The default depends on the previous position. Also, stay left on a wide character when moving vertically over it.

+T

When moving vertically over a Tab character, stay right of the Tab column range (behind the Tab character). The default depends on the previous position.

-V

Place cursor before pasted region after paste commands. (If this option is enabled already, -V acts like -VV.)

-VV

Like -V, and disable emacs-style paste buffer functions for "delete word" and "delete to end of line" commands (^T, ^K).

+V

Place cursor behind pasted region after paste commands. (If this option is enabled already, +V acts like +VV.)

+VV

Like +V, and enable emacs-style paste buffer functions for "delete word" and "delete to end of line" commands (^T, ^K).

+[

Initially enable rectangular paste buffer mode. See Rectangular copy/paste.

-[

Initially disable rectangular paste buffer mode.

+V:X or -V:X

→NEW→ Enable/disable visual selection behaviour, where X is one of

Keyboard function mode selection

+eX

Select emulation mode, especially control key function mapping, where X is one of

-e

Select emacs mode. This assigns functions to control keys, M-X commands (ESC commands, using the "meta" key as emacs calls the Alt prefix) and C-X commands as defined by the emacs editor. Also the emacs paste buffer ring and cut/paste behaviour is enabled.

-W

Select WordStar mode. This configures WordStar command key layout and enables many functions of the ^K, ^O, and ^Q menus.

-kX

Select keypad modes, where X is one of

+t

(Deprecated.) Windows keypad mode, like -kw.

+tt

(Deprecated.) Shift-select mode, like -kS.

-k (as single-letter option)

Switch the Home and End key functions of the two keypads (small keypad, numeric keypad), i.e. exchange the two keypads with respect to these keys. This assigns the more usual functions "goto line beginning", "goto line end" to the Home and End keys of the right keypad. The (assumedly more useful) mined default is to assign the frequently used paste buffer functions (mark, copy) to these keys.
In turn, the assigned functions of the Home and End keys of the small keypad ("editing keypad") are exchanged to provide the other function than on the right keypad, respectively - provided the terminal and its configuration support this distinction.
Also Alt-Home/End are assigned the respective other functions on each keypad so the most useful keypad functions should always be quite easily available.
Regardless of this switching, mined tries to map fixed functions to modified Home and End keys: Ctrl-Home/End for line begin/end movement (both keypads), Shift-Home/End for the paste buffer copy functions (small keypad) - provided the terminal, its mode and configuration support distinction of modified keypad keys.
See also the section on Keypad layout for a motivating overview of the mined keypad assignment features and options.
About terminal support and configuration, see Keypad configuration for further hints.

+k

Enforce usage of terminal "keypad mode" which switches the numeric keypad to send "application keypad" escape sequences. This is normally not needed. On certain terminals, mined will automatically use this mode (e.g. Linux console), and in terminal emulators it is usually not needed unless you are running a misconfigured X windows system in which case you can enable distinguished keypad functions by using the NumLock function of the keyboard and switching on this option.

+Bp

→NEW→ Backspace should apply "plain backspacing" rather than "smart backspacing", i.e. no auto-undent and only delete one combining character of a combined character; without this option, use Control-Backspace for the "plain" function; with this option, use Shift-Control-Backspace for the "smart" function.

-B

(Deprecated.) Enforce the Del control character to delete left, Backspace to move left. Should normally not be used, see "Automatic backspace mode adaptation" below.

Appearance

-QX

Select menu border style, where X is one of

-O

Disable script colour highlighting (for Greek, Cyrillic...).

+O

Enable script colour highlighting (for Greek, Cyrillic...). (Disabled by default in dark terminals.)

-f

Restrict usage of graphic characters: use cell-grained scrollbar, simple menu borders, no fancy menu bar for highlighting the selected menu item.

-ff

Further restrict usage of graphic characters: no Unicode box drawing graphic characters for menu borders.

-fff

Further restrict usage of graphic characters: no graphic characters (including VT100 graphics) for menu borders.

-F

Assume a screen font with limited coverage of special symbols and restrict usage of special marker characters for display of line indications. (This is needed e.g. for KDE konsole or for xterm using TrueType fonts.)
Interpretation of the MINEDUTF* environment variables is suppressed.

-FF

Assume a screen font with even more limited coverage of special symbols and restrict usage of special characters for indication of selected menu items. Also, trigger substitution display of a number of special characters in text (like in non-Unicode terminals).

+F

Revert the effect of one -F option (e.g. preconfigured in the environment variable MINEDOPT) or a corresponding assumption of mined about the specific terminal which would limit font usage.

+FF

Fully enable usage of characters for special indications.

Further mode selection, interface and display behaviour

-N

Set Tab size to either value of 8, 4, →NEW→ 2. The effective Tab size can be changed while editing with the ESC T command or from the Options menu.

-+N

Set Tab spacing expansion mode to either size or 8, 4, →NEW→ 2. In this mode, a TAB input character will be expanded to an appropriate number of spaces. To enter a real Tab character, type Ctrl-V Tab (^V^I). The effective Tab size can be changed while editing with the ESC T command or from the Options menu. Tab expansion mode can be changed while editing with the HOP ESC T command or from the Options menu.

-P

Hide passwords; enables hidden display of one word behind the string "assword" in a line (to accommodate for "password" or "Password"): hidden characters are indicated by reverse "*" characters. By default, this mode is activated when editing a file whose name starts with ".".

+P

Unhide passwords; always display them.

+ZZ

Virtual bold stropping: displays keywords of Algol-like programming languages in bold while transparently editing them in all-capital letters ("upper stropping"), which is started with entering only one capital letter. Implicitly enabled on file name suffix .a68 (disable with -ZZ).

+Z_

Underline strop style: use underlined instead of bold for stropping. To activate virtual underline stropping, use both options: +ZZZ_.

-LN

(N is a number) Define mouse wheel movement to scroll by N lines (default 3). Ctrl-mouse-wheel always scrolls by 1 line. Shift-mouse-wheel scrolls by 1 page. Mouse-wheel on the scrollbar scrolls by half a page.

+M:

→NEW→ Enable file tabs header display (above menu line which is also enabled).

-M:

→NEW→ Disable file tabs header display.

-M

Suppress display of menu header line (including flags). Pull-down and pop-up menus can still be opened with keyboard commands. Mouse control remains enabled.

-MM

Suppress display of menu header line (including flags) and disable quick menu (right-click on text). Pull-down and pop-up menus can still be opened with keyboard commands, the quick menu can still be opened with Alt-space or ESC space.

-MM+M

Disable quick menu but leave menu header and flags line enabled.

+*

Enable enhanced mouse control: Menu items can be navigated with the mouse without button pressed. Enabled by default for mintty, xterm, gnome-terminal, cygwin console.

-*

Disable enhanced mouse control (if enabled by default or by previous option), otherwise disable mouse support altogether.

-**

Disable mouse support altogether.

-oN

Select scrollbar display mode. N=0 disables the scrollbar (may speed up editing on slow remote lines), N=1 enables cell-grained scrollbar display, N=2 (default) enables finer-grained scrollbar display on a UTF-8 terminal.

-oo

Selects old (until 2000.14) left/right click behaviour on scrollbar.

-o

Disables the scrollbar.

+o

Enables the scrollbar.

-p

Enables distinguished display of line ends and paragraph ends with different symbols.

-X

Disables display of the filename in the window title bar.

-s

Stay with cursor in top line after page down or bottom line after page up instead of center line.

-S

Use scrolling for page up/down.

-dN

Apply delay between lines of page output to achieve visually effective display build-up which may help to quickly focus on the new cursor position (the screen output is displayed starting from the cursor position, proceeding to the screen edges).
If N lies between '0' and '9', the respective number of milliseconds is applied between display of two lines. If N='0', still an output flush is performed. If N='-', no delay at all is applied though still the order of display output is from cursor position to edges.
Default: '-'; configuration is currently disabled in the Unix version as 'usleep' doesn't seem to be very portable.

+p

Enables support for proportional display fonts. This does not really work, however, with e.g. xterm or SunOS shelltool as they do not reliably position characters after using control sequences.

All options are also looked for in the environment variable MINEDOPT (or MINED for compatibility).
On the command line, options containing wildcard characters ("?", "*") may need to be quoted (if matching files starting with "-" or "+" exist).

Keypad layout

The right-hand cursor block of typical keyboards is assigned the most important movement and paste buffer functions.

Keypad assignment features:

The HOP function

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

embed copy area in HTML tags

While a pull-down or pop-up menu is open, any HOP key or the Space key or the middle mouse button toggles the HOP amplifier/expander for a function subsequently invoked in the menu; the menu redisplays with function names changed where applicable.

Character-oriented navigation and editing

Mouse control and menus

Summary of mouse functions:

Configuration hint: To enable mouse operation in a Windows console window, deactivate "QuickEdit mode" in the properties menu.

Menus

Menu navigation

There are three methods to navigate within a menu:

When selecting a menu item, in most cases the associated function is carried out and the menu closed afterwards. In some cases, an option is toggled and the menu stays open (esp. in Info menu: Han info pronunciation selection, character information "with" attributes selection).

Scrollable menus: In a low-height terminal (e.g. 24 lines), longer menus (especially the Encoding menu and the Input Method menu) may not fit on the terminal. All menus are scrollable with cursor keys, including Page Down/Up, Home, End keys.
When the window size is changed, open menus are closed in order to prevent resizing and repositioning problems; this is planned to be enhanced in a future version.

Hints

Layout configuration: See Menu display below for configuration of menu appearance.

Configuration hint: On Unix, in order to make Alt work as a modifier, set the xterm resource metaSendsEscape to true and the rxvt resource meta8 to false as suggested in the example file Xdefaults.mined in the Mined runtime support library. (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.) With xterm, this setting can also be enforced dynamically with the +D option.

Interoperable and multiple paste buffers

System paste buffer / Clipboard

Inter-window paste buffer

Multiple paste buffers

Keypad modes and Visual selection

Keypad modes

Shift-select mode (-kS) may become the default in a future version.

Visual selection is toggled by the following actions:

Note: The actual behaviour of the paste buffer functions acting on the text selection (Copy, Cut) are not affected by the visual selection; they work alike even if the selection is hidden.
The Delete key is the only function that is actually modified by visual selection, following a dual-mode behaviour consistent with most contemporary text editors: if a non-empty visual selection is active, it deletes the selected area (Cut to paste buffer), otherwise, it deletes the next character.

Rectangular copy/paste

Text position markers

Text position marker stack

Paragraph justification / word wrap

Paragraph termination modes: Two different definitions of paragraph end are available.

Auto indentation

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.

→NEW→

Structure input commands

Back-Tab (Undent function / reverse indent)

Tab expansion

Search and replace multiple lines

Header line underlining

Automatic backspace mode adaptation

Character input

Structured input

Special features

Tags file support / Identifier and file lookup

→NEW→

Data safety and security

Backup files

+b-

no backup files

+bs

simple backup files: filename~

+be

emacs style numbered backup files: filename.~N~ where N are increasing version numbers

+bv

VMS style numbered backup files: filename;N (using the original notation of the VMS operating system) where N are increasing version numbers

+bn

numbered backup files, either emacs or VMS syntax, whichever already exists (with a higher version number)

+ba

automatic backup files, either numbered if numbered backups (either style) already exist, or simple

Note: In order to preserve possibly existing hard links to the file being edited, it is actually copied, not just renamed for the backup version (like with joe, vim, or emacs with option backup-by-copying). Note: In mined 2011.19, +ba (automatic simple/numbered backup) is the default, and +b is a shortcut for +ba. This is subject to change in a future version, however. Note: To select your preference, use the runtime configuration file $HOME/.minedrc, or include the respective option in the environment variable MINEDOPT, or set the environment variable VERSION_CONTROL (compatible with usage by emacs and cp), with the following mapping:

VERSION_CONTROL

$HOME/.minedrc command line option

none or off

backup_mode - +b- - no backups

numbered or t

backup_mode e +be - emacs style numbered backups

existing or nil

backup_mode a +ba - automatic backup mode

simple or never

backup_mode s +bs - simple backups

backup_mode n

+bn - numbered backups (automatic style)

backup_mode v

+bv - VMS style numbered backups

Note: To place backup files in a different directory than the original file, use the environment variable BACKUP_DIRECTORY or BACKUPDIR. It can be either an absolute pathname (e.g. $HOME/.backups) or a relative pathname (e.g. .~) in which case backup files are stored relative to the respective working directory of mined. Note: On VMS, backup options are ignored as VMS handles backup files natively.

File locking

Edited text / Recovery files

Overwriting files and →NEW→

File access permissions

Special file types

Character or block device files

FIFO files

Pipe input

Pipe output

Line end modes and binary-transparent editing

File info: Memory of file position and editing style parameters

Note: File information is stored every time the user invokes a command to save the file (even if no write is performed because the text has not been edited). When editing that file again (from the same working directory), mined will automatically move to that position (and set text marker 0 to it).

File info grooming

File chooser

→NEW→

File switcher

Page length

Restricted mode (tool mode)

Version control integration

Printing

In Windows, mined uses notepad /p for printing.
Note: The font size interactively configured in notepad also affects the print size; with a fixed-width font, a font size of not more than 10pt gives you at least 80 characters per line; if 72 characters per line are enough, you can use 11pt font size.

Quick Options (Mode indication) flags

Scrollbar

Text position marker stack

Structured editing support

HTML support: syntax highlighting and tag entry/matching

Search structure match

Structure input

Visual structure input is supported by Auto indentation

Password hiding

Virtual bold/underline stropping

Long line splitting

Visible indication of line contents and display

«

/ ⏎ LF (Unix-type line end)
customize indication with MINEDRET or MINEDUTFRET (may contain up to 3 characters to configure different appearance behind the line end)

«

/ ⏎ CRLF (MSDOS-type two-character line end)
(µ on black and white terminals)
customize indication with MINEDDOSRET or MINEDUTFDOSRET

«

/ ⏎ CR (Mac-type line end)
(@ on black and white terminals)
customize indication with MINEDMACRET or MINEDUTFMACRET
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)

«

→NEW→ NL (U+0085, ISO 8859/EBCDIC Next Line)

«

/ ⏎ LS (U+2028, Unicode line separator)

¶

PS (U+2029, Unicode paragraph separator)
customize indication with MINEDPARA or MINEDUTFPARA

¶

end of paragraph (if enabled by -p)
customize indication with MINEDPARA or MINEDUTFPARA

·

no-break space (Unicode character U+00A0)

»

line extending the end of the screen line
(move cursor right to shift line display)
customize indication with MINEDSHIFT or MINEDUTFSHIFT

«

line shifted out left of the screen line
(move cursor left to shift line display back)
customize indication with MINEDSHIFT or MINEDUTFSHIFT

·

position spanned by Tab character
customize indication with MINEDTAB or MINEDUTFTAB (may contain up to 3 characters to configure different appearance within the Tab span)

Configuration: Display colour of the indications is by default red or a dimmed foreground colour; this can be changed with the environment variable MINEDDIM, display colour for Unicode line end indications and other special (esp. invalid) character indications with <span class=env>MINEDSPECIAL. Their values should be the numeric part of an ANSI terminal control sequence, e.g. 31 for red, "33;44" for yellow text on blue background. MINEDDIM can also be set to an integer percentage value (e.g. MINEDIM="50%") to have mined apply dim colour to the indications; the colour value is computed from the current foreground and background colours (if the terminal supports their detection).
For more details and recommended settings see the example script file profile.mined in the Mined runtime support library. Default values are compiled in and can be overridden by setting the variables to empty values.

Note: With the -F option, mined limits usage of special characters for line indication and suppresses the interpretation of the MINEDUTF* environment variables.

Function key help bars

Menu display

Latin-script languages

Character sets

Character input support

For other characters and ligatures, mined provides mnemonic input.
See Character input support for more details.

Language-specific mnemonic conversion support

Language-specific case conversion

Lithuanian: (If language tag begins with "lt") Proper case conversion of accented i with retained i dot.

Turkish, Azeri, Tatar, Bashkir: (If language tag begins with "tr" or "az" →NEW→ or "crh" or "tt" or "ba") Proper case conversion of i<->I with dot above / dotless i<->I.

→NEW→ Dutch: (If language tag begins with "nl") Title case conversion with Shift-F3 supports "IJ" pseudo ligature like in "IJsselmeer". <!p>

Esperanto

Character sets

Input method

Accented character input support

Ctrl-F6

Ctrl-^

circumflex

Alt-Shift-F5

Ctrl-(

breve

<!p>

Hawai'ian

Accented character and 'okina input support

HOP ` (grave accent)

glottal stop / 'okina (U+02BB)

Alt-Ctrl-F6

Ctrl-- (Ctrl-minus)

macron (long vowel)

Note: In smart quotes mode, the grave accent (or backquote) ` alone enters a glottal stop as well. <!p>

Russian, Ukrainian, other Cyrillic-script languages

Character sets

Input method

Accented character input support

F5

Ctrl-:

diaeresis

Alt-Ctrl-F6

Ctrl--

descender / macron

Alt-F5

Ctrl-/

stroke

Ctrl-&

hook

Ctrl-- Ctrl-&

middle hook

Alt-Shift-F5

Ctrl-(

breve

Ctrl-;

tail / tick / upturn

F6

Ctrl-'

Ctrl-´

vertical stroke

Shift-F6

Ctrl-`

grave

Shift-F5

Ctrl-~

titlo

acute acute

double acute

grave grave

double grave

See Character input support for more details.

Script highlighting

Tadjik

Character sets

Input method

Accented character input support

Script highlighting

Kazakh

Character sets

Input method

Accented character input support

Script highlighting

Georgian

Character sets

Armenian

Character sets

Greek

Character sets

Input method

Accented character input support

F6 < alpha >

enters the Greek letter alpha with tonos

Ctrl-F6 < alpha >

enters the Greek letter alpha with oxia

Likewise, with mnemonic input

^V ' < alpha > (using the apostrophe key)

enters the Greek letter alpha with tonos

^V ´ < alpha > (using the acute accent key)

In these examples, < alpha > indicates the Greek letter alpha, which may e.g. be entered by selecting the Greek input method and typing the a key.

Accent prefix functions for Latin letters are reused for Greek accents, see the following table:

F5

Ctrl-:

Ctrl-"

dialytika

Shift-F5

Ctrl-~

perispomeni

Ctrl-F5

Ctrl-,

iota (ypogegrammeni)

Ctrl-Shift-F5

Ctrl-;

prosgegrammeni

Alt-Shift-F5

Ctrl-(

vrachy

F6

Ctrl-'

(Ctrl-apostrophe) tonos

Ctrl-F6

Ctrl-´

(Ctrl-acute)

Ctrl-^

oxia

Shift-F6

Ctrl-`

(Ctrl-grave) varia

Alt-F6

Ctrl-<

psili

Alt-Shift-F6

Ctrl-.

dasia

Ctrl-Shift-F6

macron

Alt-6

psili and oxia

Ctrl-Alt-6

dasia and oxia

Alt-7

psili and varia

Ctrl-Alt-7

dasia and varia

Alt-8

psili and perispomeni

Ctrl-Alt-8

dasia and perispomeni

For polytonic Greek, 2 or 3 accents can be combined by applying the respective accent prefix functions in sequence. For convenience, the most frequent combinations of 2 accents are also available as dedicated accent prefix keys as listed above. Also, modified Ctrl-/Alt-/Alt-Ctrl- digit keys are used for polytonic Greek accent prefix functions. See Character input support for more details.

Script highlighting

Script-specific case conversion

Amharic

Input method

Arabic

Character sets

Input method

Accented character input support

Bidi support

Hebrew

Character sets

Input method

Accented character input support

Bidi support

Smart replacement

Chinese

Character sets

Input method

Han character information display

Accented character input support

Japanese

Character sets

Input method

Han character information display

Accented character input support

Korean

Character sets

Input method

Han character information display

Vietnamese

Character sets

Input method

Character input support

An accent prefix can either be applied to the plain Latin base letter, or to a precomposed Vietnamese letter which already has one of the accents. These are:

Examples: Suppose your keyboard is mapped to have Vietnamese characters like A with circumflex available. Then:

^V Â ' (Ctrl-V A-circumflex apostrophe)

enters the composite character U+1EA4 (A with circumflex and acute)

^V ~ Ô (Ctrl-V O-circumflex tilde)

enters the composite character U+1ED6 (O with circumflex and tilde)

Ctrl-6 A

enters U+00C2 (A with circumflex)

Alt-4 A

enters U+1EAA (A with circumflex and tilde)

Ctrl-Alt-3 A

enters U+1EB2 (A with breve and hook above)

Ctrl-Alt-3 O

enters U+1EDE (O with horn and hook above)

Note: Using composite base characters in mined character mnemonics or accent prefix combinations as just described also works in non-UTF-8 text encoding mode (e.g. in VISCII or TCVN encoding). <!p>

Thai

Character sets

Input method

Accented character input support

Script highlighting

Combining characters

(Note: Terminal support for combining characters 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 Quick Options (Mode indication) flags area (right part of the top screen line), or by the menu entry "Options - Combined display"; separated display mode can also be selected by the command line option -c.

Combined display and editing mode (Combining display flag ç)

Combined characters are displayed as intended (i.e., combined).

•

Micro movement into combined characters:

•

Partially editing combined characters:

Separated display and editing mode (Combining display flag `)

Combined characters are separated into base character and combining character(s) for display and editing. Combining characters are indicated with coloured background.

Input support: For input of Unicode combining characters,

see Combining character input below.

Note: Unicode combining characters (according to the

most recent version of Unicode known to mined) that are not handled as combining characters by the terminal (which might implement an older version of Unicode) are always displayed like in separated display mode.

Note: Isolated combining characters, i.e. those

appearing at a line beginning or after a TAB character, are always displayed like in separated display mode.

Character information display

Permanent display of character information is toggled with HOP ESC u or by selecting "Char info" in the Info menu (or with HOP "Toggle Char info" in the Options menu).

In the Info menu, attributes that are shown with the character information can be selected: Unicode script name, Unicode character name, →NEW→ Unicode named sequence, Unicode character decomposition, list of input mnemonics. Note that Unicode named sequence information only applies to a small number of named sequences, otherwise normal character information is shown instead; also, it is only shown in combined display mode, so normal information can be quickly toggled by switching to separated display mode (middle-click on ç flag).

Character information display can be selected with the +?c command line parameter (see parameter description for further options). To preselect continuous character information display, append +?c to the environment variable MINEDOPT or enable option "display_charinfo" in the runtime configuration file $HOME/.minedrc.

Han character information display

Character conversion features

Case conversion

Line end type conversion

Numeric conversion

Numeric entity (HTML/URL) conversion

Mnemonic conversion

Encoding conversion support

Unicode Copy/Paste buffer

Smart quotes

The smart quotes left/right selection algorithm considers both the text context and the state (whether an open quote was inserted before) to automatically support smart quotes also in CJK text, and to try to distinguish an apostrophe from a quote mark. →NEW→ At a line beginning, always a left (opening) quotation mark is chosen, supporting the habit in some languages to repeat opening quote marks for each new paragraph inside a quotation.
French quotation marks spacing is automatically applied (using no-break space U+00A0) if French style has been selected from the menu or by locale.
A typographic apostrophe can also be inserted with HOP ' (^G ') or with HOP ´ (acute accent), regardless of smart quotes mode. In smart quotes mode, a typographic apostrophe is also inserted on input of ´ (acute accent).
Straight quotes or accent marks (" ' ` ´) can be inserted with mnemonic compose pairs (^V ^ " or ^V ^ ' or ^V ^ ` or ^V ^ ´, or ^V"# or ^V'# or ^V`# or ^V´# respectively).
Smart quotes are applicable in all text encodings provided the desired quote marks are contained in the selected encoding.

When a file is loaded, mined tries to determine the applicable quotation marks style in two ways: With file position memory (see File info: Memory of file position and editing style parameters above), mined also remembers the last selected smart quotes mode for the file. If that information is not available, mined auto-detects existing quotation marks in the file and adjusts its smart quotes mode accordingly. The option -q overrides this detection.

→NEW→ With command-line option -q alone, quotation marks style is derived from locale information (environment variables →NEW→ LANGUAGE, TEXTLANG, LC_ALL, LC_CTYPE, LANG), or from a locale value given with the option as -q=locale. For some languages, two styles are predefined, using the primary style as active smart quotes style, and the secondary or alternate style as standby style, for quick toggling with a middle mouse click on the Quotes flag (or using the standby entry from the Quote marks menu). The active quote marks style can also be derived explicitly from the locale with the Quotes menu option "by locale".
Option +q exchanges primary and alternate quotation marks style, setting the alternate style active.
Without an option -q, the primary locale-derived quote marks style is always set as standby style to be quickly available.
Note: Language-dependent quotations marks styles are determined using the compile-time configuration file quotes.cfg. See Quotation Marks Styles on the mined web site for a listing.
Note: Smart quotes style can also be preselected giving the desired quotation marks directly, either as command line option like -q="«»" or with the environment variable MINEDQUOTES (see under Environment configuration hints below); this overrides both auto-detection and the preference saved with the cursor position.

Smart text replacements: apostrophe, smart dashes, arrows and glottal stop

--

if preceded by a Space character: en dash (U+2013)
otherwise: em dash (U+2014)

- or -TAB

→NEW→ if leading a line (only white space before): en dash (U+2013)

-

→NEW→ if embedded in spaces: minus sign (U+2212)

-

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)

´

apostrophe (U+2019 right single quotation mark)

`

glottal stop (U+02BB modifier letter turned comma)

Note: →NEW→ Mined smartly avoids inappropriate placement of smart replacements as well as double spaces by redundant combination of smart spaces and explicitly entered spaces, so you can seamlessly type either "bonjour" or " bonjour " to enter « bonjour » with French quotes, or a -- b to enter an en dash although a space is initially inserted after it.

Accented and mnemonic input support

Note that mnemonic input and accent prefix keys can be

combined in flexible ways, e.g.

^V ' Ctrl-F6 e

or

F6 ^V e ^

which both enter U+1EBF (e with circumflex and acute)

Mnemonic input can be applied recursively to compose a character

for further composition, e.g.

^V ' ^V a e

enters U+01FD (æ with acute)

Accent prefix keys can use an already precomposed base

character for further composition; if this does not match an explicitly known mnemonic, the base character is decomposed first to find a match, e.g.

F6 ü

or

F5 ú

which both enter U+01D8 (u with diaeresis and acute)

Up to three accent prefix keys can be combined by entering

them in sequence in order to compose characters with multiple accents, e.g.

F5 F6 u

enters U+01D8 (u with diaeresis and acute)

Ctrl-2 Ctrl-7 a

enters U+1EB1 (a with grave and breve)

Ctrl-- Ctrl-: u

enters U+1E7B (u with macron and diaeresis)

Ctrl-, Ctrl-( e

enters U+1E1D (e with cedilla and breve)

Alt-7 Ctrl-, < alpha >

Alt-F6 Shift-F6 Ctrl-, < alpha >

Ctrl-< Ctrl-` Ctrl-, < alpha >

all enter U+1F82 (alpha with psili and varia and ypogegrammeni) where < alpha > indicates the Greek letter alpha, which may e.g. be entered by selecting the Greek input method and typing the "a" key

Accent prefix keys

General notes on using keys with Control, Shift, Alt modifiers:

Especially for accented character input, mined makes use of key combinations modified with Control, Shift, Alt, or a combination of them. Some of these key combinations may be limited by local environment, especially the window system, or may need extra configuration to be enabled.

The following table lists the accent prefix keys:

F5

(Sun: R4/-) diaeresis (umlaut) / dialytika

Shift-F5

(Sun: R5/÷) tilde / perispomeni

Ctrl-F5

(Sun: R6/×) ring / cedilla / iota (ypogegrammeni)

Alt-F5

stroke

Ctrl-Shift-F5

ogonek / prosgegrammeni

Alt-Shift-F5

breve / vrachy

F6

(Sun: R3) acute (accent d'aigu) / tonos

Shift-F6

(Sun: R1) grave / varia

Ctrl-F6

(Sun: R2) circumflex / oxia

Alt-F6

caron / psili

Ctrl-Shift-F6

macron / descender

Alt-Shift-F6

dot above / dasia

Ctrl-1

acute

Ctrl-2

grave

Ctrl-3

hook above

Ctrl-4

tilde

Ctrl-5

dot below

Ctrl-6

circumflex

Ctrl-7

breve

Ctrl-8

horn

Ctrl-9

stroke

Ctrl-0

ring / cedilla

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

Ctrl-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)

Ctrl-Alt-2

breve/horn and grave

Ctrl-Alt-3

breve/horn and hook above

Ctrl-Alt-4

breve/horn and tilde

Ctrl-Alt-5

breve/horn and dot below

Alt-6

psili and oxia

Ctrl-Alt-6

dasia and oxia

Alt-7

psili and varia

Ctrl-Alt-7

dasia and varia

Alt-8

psili and perispomeni

Ctrl-Alt-8

dasia and perispomeni

Ctrl-'

(Ctrl-apostrophe) acute (d'aigu) / tonos

Ctrl-´

(Ctrl-acute) acute (d'aigu) / oxia

Ctrl-`

(Ctrl-grave) grave / varia

Ctrl-^

circumflex / oxia

Ctrl-~

tilde / perispomeni / titlo

Ctrl-:

diaeresis (umlaut) / dialytika

Ctrl-"

diaeresis (umlaut) / dialytika

Ctrl-,

cedilla / ring / iota (ypogegrammeni)

Ctrl-/

stroke

Ctrl--

(Ctrl-minus) macron / descender

Ctrl-<

caron / psili

Ctrl-.

dot above / dasia (with i or j: dotless)

Ctrl-(

breve / vrachy

Ctrl-;

ogonek / prosgegrammeni / tail / tick / upturn

Ctrl-)

inverted breve

Ctrl-&

hook

Ctrl-- Ctrl-&

middle hook

Note: If your keyboard assignment provides its own accent prefix keys ("dead keys"), pressing the key twice usually delivers the corresponding spacing character which can then be used for the extended accent prefix functionality of mined; e.g. hold Control, then press ´ (acute key) twice, to invoke the acute/oxia prefix function of mined.

Note: For combining multiple accents, in most

cases their order does not matter. As an exception, to combine dot above and macron, enter prefix keys in this order, as s macron and dot above will be interpreted as dot below.

dot macron

e.g. Ctrl-. Ctrl-- dot above and macron (on A or O)

macron dot

e.g. Ctrl-- Ctrl-. dot below

Note: For the sake of accepting Ctrl--

intuitively both as an accent prefix for macron as well as an accent modifier to place an accent below a letter, the macron accent prefix combined with another accent prefix key is also interpreted as applying that accent below. As a workaround to ambiguous cases, it has to be applied twice with diaeris for diaeresis below (U), and three times for line below.

macron macron diaeresis

e.g. Ctrl-- Ctrl-- Ctrl-: diaeresis below

macron diaeresis

e.g. Ctrl-- Ctrl-: macron and diaeresis

diaeresis macron

e.g. Ctrl-: Ctrl-- diaeresis and macron

macron macron macron

e.g. Ctrl-- Ctrl-- Ctrl-- line below

Note: Some accent prefix keys, when applied twice in

sequence, are mapped to a single accent as follows:

acute acute

e.g. F6 F6 double acute accent

grave grave

e.g. Shift-F6 Shift-F6 double grave accent

macron macron

e.g. Ctrl-- Ctrl-- bar/topbar

cedilla cedilla

e.g. Ctrl-, Ctrl-, psili/comma below

Combining character input

Unicode combining characters can be entered

by applying accent prefix keys to the Tab key. They will be visually combined with the previous character by rules of Unicode (and by terminal implementation). Examples:

Ctrl-, Tab

combining cedilla

F6 F6 Tab

combining double acute accent

Special character input shortcuts

Typographic quotation marks can be entered

by applying accent prefix keys to the space key as follows, or using certain input mnemonics or shifted combinations (see below):

(twice) grave space

(double) left quotation mark

(twice) acute space

(double) right quotation mark

acute space

e.g. F6 space or Ctrl-' space also serves for input of typographic apostrophe (or HOP ')

(twice) cedilla space

(double) low-9 quotation mark

(twice) dot above space

(double) high-reversed-9 quotation mark

^V < < or ^V > >

double angle quotation marks « »

^V < space or ^V > space

single angle quotation marks

" or '

outer or inner quotation mark of selected quote marks style

Alt-" or Alt-'

→NEW→ outer or inner quotation mark of previous/standby quote marks style

Some characters are specifically mapped to special key

combinations or specific applications of accent prefix keys for convenience or for Windows compatibility:

Ctrl-Shift-space

no-break space (U+00A0)

Ctrl-@ a/A

å/Å

Ctrl-& a/A

æ/Æ

Ctrl-& o/O

oe/OE ligature

Ctrl-& s

ß

Ctrl-?

¿

Ctrl-!

¡

As with modified keys in general, these shortcuts may depend on proper terminal configuration according to the sample files in the Mined runtime support library.

Line ends

Key combinations are available to enter specific kinds of line ends

(works in xterm and mintty):

Ctrl-Alt-Enter

DOS or Unix line end (if editing Unix or DOS file, respectively)

Ctrl-Shift-Alt-Enter

Mac line end

Ctrl-Enter

Unicode line separator (if editing Unicode text)

Shift-Enter or HOP Enter

Unicode paragraph separator (if editing Unicode text)

→NEW→ Control-Shift-Enter

ISO 8859 Next Line (if editing Unicode or ISO 8859 text)

Also, the line end type of a line can be changed from a submenu

of the Options menu.

Character input mnemonics

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.

For Greek and Cyrillic accented characters, mnemonics combining accents with Greek or Cyrillic base characters are generated automatically from the UnicodeData.txt database.
Greek and Cyrillic accent prefix keys reuse those for Latin accents and are listed in the sections on Greek and Cyrillic script support (see Language support).

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" or 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 or x--

topbar

--x or x--

bar

,x or x-,

comma below / left hook

x# or x!!

double grave

x)

inverted breve

x&

hook

%x

retroflex hook

x,,

palatal hook

x~~

middle tilde

x}

curl

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

See also the description of the ^V function below for more input options.
Two-letter mnemonics can also be entered in reverse order if this is unambiguous. Detection of reverse order mnemomics (two letters or one letter and multiple accents) as well as the generic accent mnemonics " ^ ` ~ ¨ ¯ ´ ¸ ° works with both short mnemonic entry (two-letter "^Vxy") and full mnemonic entry ("^V xy... ").

Mnemonic character substitution commands (ESC _ and national variants) replace characters at the cursor position with the respective character described by them. The following substitute descriptions are detected:

Keyboard Mapping and Input Methods

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.)

Pick lists

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, some characters may not be displayed; an empty entry is shown instead. (In a non-Unicode, when editing text in a different encoding, there may even be characters that cannot be displayed in the selection menu but can be inserted.)

Input method selection

The active mapping can be selected in the following ways:

ESC k or Alt-k or Ctrl-Alt-F12 or left click on Input Method flag

toggles between current (active) and previously selected (standby) input method (keyboard mapping)
(Alt- toggle functions also work on prompt line)

HOP ESC k (or HOP Alt-k)

clears input method, i.e. resets keyboard mapping to none (unmapped input)

ESC I or Alt-I or ESC K or Alt-K or Ctrl-F12

opens the Input Method (Keyboard Mapping) selection menu
(Alt-I or Alt-K or Ctrl-F12 also work on prompt line)

right click on Input Method flag

opens the Input Method selection menu

HOP ESC K or HOP Alt-K

cycles through available input methods / keyboard mappings

If file position memory is enabled (see File info: Memory of file position and editing style parameters above), mined also remembers the last selected input method for the file.

Note: For preselecting the active or standby input method by environment configuration, see about usage of the environment variable MINEDKEYMAP below.

Note: Keyboard mapping is implicitly suppressed temporarily where it is not useful: during mnemonic character input, HTML marker input, command letter entry, help selection, yes/no prompting.

Auto-detected character encodings

-

UTF-8

-

UTF-16 encoding (big or little endian) with or without BOM (byte order marker)

8

any 8 bit encoding; this is auto-detected in a generic way; the actual 8 bit encoding assumed corresponds to the terminal encoding if it is an 8 bit terminal; otherwise, Latin-1 is assumed; using "8" in the environment variable MINEDDETECT excludes all CJK encodings from auto-detection (but not UTF-8), and adds all 8 bit encodings that are not included by default

L

Latin-1 (ISO 8859-1)

W

Windows Western ("ANSI", CP1252)

P

PC Latin-1 (CP850)

M

MacRoman

-

CJK encoding (with unspecified mapping) is pre-auto-detected in a generic way; usually the actual CJK encoding is determined, too

G

GB18030 (including CP936)

B

Big5 (including CP950)

J

EUC-JP

X

→NEW→ EUC-JIS-2004 / EUC-JIS X 0213

S

Shift_JIS / CP932

x

→NEW→ Shift_JIS-2004 / Shift_JIS X 0213

K

UHC / CP949 (including EUC-KR)

V

VISCII

Note: For new files, the text encoding is derived from the locale environment. →NEW→ With command line option -E- or -E auto-detection is disabled and text encoding is always derived from the locale environment.

CJK and mapped 8 bit encoding support

→NEW→

Combining characters

For Japanese X 0213 encodings, the character codes that map to two Unicode characters are supported.

Character code related commands

Other commands insert the code of the current character, insert a character taking its character code or Unicode value from the text, or toggle the preceding character and its hexadecimal Unicode value (Alt-x). For details, see Code conversion in the Command reference.

Terminal environment for CJK encoding support

CJK terminals: For terminals that support native CJK encodings (e.g. cxterm, kterm, hanterm), the terminal encoding assumed by mined can be specified with a command line option or by proper locale indication in one of the environment variables LC_ALL, LC_CTYPE or LANG. For available encodings, see Quick Options (Mode indication) flags. For usage of the +E options, see the description of the Terminal encoding options above. For usage of the locale environment variables, see Locale configuration.

Note: In native CJK terminals, it is often troublesome to find a working encoding configuration and font setup, and the locale environment is not automatically set by the terminals. A collection of wrapper scripts is available ( http://towo.net/mined/terminals.tar.gz) to help with this setup problem and demonstrate the invocation of a number of different CJK and 8 bit encoded terminal windows, along with selection of suitable fonts and proper locale environment setting.

Note: Native CJK terminals have a different assumption of the range of character codes supported in an encoding family, e.g. Big5 / Big5 with HKSCS, GB2312 / GBK / GB18030, EUC-KR / UHC, EUC-JP without/with 3 byte codes. For compact handling, mined always assumes the largest superset of these encoding families. It does, however, have some features to prevent display garbage in most cases when a terminal supports a smaller character set: By default, mined does not display the following CJK character codes in a native CJK terminal, i.e. it displays a substitute indication for them (see CJK character display above):

Regardless of all these features and options, it may not always be possible to prevent display garbage, especially if the font used by the terminal does not cover the needed character range. To avoid these problems in general, it is recommended to use a Unicode terminal for editing CJK encoded files.

See also Terminal interworking problems for special hints about certain terminals.

VT100 special graphics character set display support

Introduction: handling Unicode encodings

UTF-8 internal representation, transparent handling of other text

Character encoding indication

Character information display

Character input support

See also the generic section Character input support above for input support for accented characters and keyboard mapping.

Encoding conversion support

Unicode Copy/Paste buffer conversion

Smart quotes and dashes

Bidirectional terminal support

Input support for right-to-left scripts ("poor man's bidi" mode)

Unicode line ends

Unicode display

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)

Illegal or non-Unicode characters are indicated with the following replacements:

�

(or ? or []) a character code ending with FFFE or FFFF (override substitution for transparent display with +C)

�

(or ? or []) a surrogate code point (override substitution for transparent display with +CC)

�

(or ? or []) a code point outside the defined Unicode range (override substitution for transparent display with +CCC)

Character substitution display

¤ or

¤  (if wide) a non-combining Unicode character that cannot be displayed

% or

%  (if wide) (if the terminal cannot display ¤) a non-combining Unicode character that cannot be displayed

` (or wide)

a Unicode combining character that cannot be displayed

" or

' (or wide) a double or single quotation mark character (typographic quote mark)

- or

~ or = (or wide) a dash or hyphen character

e, ê,

etc a combined or other character that cannot be displayed which is based on the displayed character by its Unicode decomposition

E

the Euro sign € U+20AC

V,

X, Z the check mark ✓ U+2713, ballot X ✗ U+2717 , zigzag arrow ↯ U+21AF

'

glottal stop 'okina ʻ U+02BB

0 ..9 ,

A ..Z  etc a corresponding fullwidth ASCII character

Configuration: Display colour of special or illegal UTF-8 indications can be changed with the environment variable MINEDUNI, the value should be the numeric part of an ANSI terminal control sequence; optionally, the value can be preceded by a character to be used for Unicode character indication in non-Unicode terminal mode.
(The default configuration value is "¤ 46").

Combining and joining characters

Joining characters

Search expression limitations

UTF-8 preservation and byte-transparent editing

Terminal environment

See also Terminal interworking

problems for special hints about certain terminals.

CJK input method support

Radical/Stroke input method

CJK character display

¤  or

¤ CJK character that cannot be displayed in the terminal

%  or

% (if the terminal cannot display ¤) CJK character that cannot be displayed in the terminal

` or

`  CJK combining character that cannot be displayed in the 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

Han character information display

The same information is always shown while you are browsing an input method pick list (then on the status line).

Han character information display can be selected with the +?h command line parameter (or +?x for short display on the status line). To preselect continuous Han character information display, append this parameter to the environment variable MINEDOPT.

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.
(For the Unicode version used for the Unihan data source, see the Options - About information or the mined change log.)

Terminal feature detection

Specific terminal properties

Generic command modifiers (esp. HOP key)

^Q or ^G or "5" (on keypad) or Menu (in Linux) or * (on keypad) or Shift-TAB

HOP key (except ^G followed by a digit).
In order to enable the "5" key to invoke the HOP function, or assign the HOP function to another key (e.g. on laptops which lack the numeric keypad), some configuration may be necessary; see Keypad configuration below.

ESC

Prefix for subsequent "letter commands".
Also: Generic prefix for "Alt" modified command (to apply to a subsequent command for which the terminal does not support the Alt key).

^V

(Prefix for control character input, but also:)
Generic prefix for "Control" modified command (to apply to a subsequent command for which the terminal does not support the Control key).

Ctrl-< punctuation key >

(Set of accent prefix keys to enter composed characters.)

Cursor and screen motion

^E or cursor-up

Move cursor 1 line up.

... with HOP:

Go to top of page.

^X or cursor-down

Move cursor 1 line down.

... with HOP:

Go to bottom of page.

^S or cursor-left

Move cursor 1 character left.

... with HOP or Ctrl-Home

Go to beginning of line.

^D or cursor-right

Move cursor 1 character right.

... with HOP or Ctrl-End

Go to end of line.

^A or Shift-cursor-left (on small keypad)

Move word left (to preceding beginning of a word).

... with HOP:

Go to beginning of sentence.

^F or Shift-cursor-right (on small keypad)

Move word right (to beginning of next word).

... with HOP:

Go to end of sentence.

Ctrl-Shift-cursor-up

Move backward to previous beginning of paragraph.

Ctrl-Shift-cursor-down

Move forward to next beginning of paragraph.

Shift-cursor-up (on small keypad)

Go to top of page.

Shift-cursor-down (on small keypad)

Go to bottom of page.

^R or PgUp or PrevScreen (VT100)

Scroll backward 1 page (Top line becomes bottom line).

... with HOP:

Go to beginning of text.

^C or PgDn or NextScreen (VT100)

Scroll forward 1 page (Bottom line becomes top line).

... with HOP:

Go to end of text.

Home (on small keypad)

Move to beginning of line. If already there, move to beginning of previous line. Only if keyboard is configured to emit different control sequences for the two keypads, see Keypad configuration hints below.

Ctrl-Home (on small keypad)

Move to beginning of line.

End (on small keypad)

Move to end of line. If already there, move to end of next line. Only if keyboard is configured to emit different control sequences for the two keypads, see Keypad configuration hints below.

Ctrl-End (on small keypad)

Move to end of line.

→NEW→ HOP ESC .

Center current position vertically on screen.

Navigation support for combined Unicode characters

Ctrl-cursor-right or ^V cursor-right

Micro movement: Move partial character right into Unicode combined character.

Ctrl-cursor-left or ^V cursor-left

Micro movement: Move partial character left over Unicode combining character.

^W or Ctrl-PgUp or keypad-Minus (if supported by terminal)

Scroll screen backward 1 line.

... with HOP:

Scroll backward half a screen.

^Z or Ctrl-PgDn or keypad-Plus (if supported by terminal)

Scroll screen forward 1 line.

... with HOP:

Scroll forward half a screen.

^G nn Enteror ESC g nn Enter

Move to a line (prompts for line number). (Terminate command with Enter or Space.)

^G nn % or ESC g nn %

Move to position in text determined by percentage.

^G nn p or ESC g nn p

Move to page in text (set page length with ESC P).

^G < command > or ESC g < command >

If not immediately followed by a digit, the positioning command works as an alternative HOP key.

Text marker navigation

^G N , or ESC g N ,

(N=0..15) Set marker N. (Final "m" or "," may be used.)

^G N . or ESC g N .

(N=0..15) Go to marker N. (Final "'" or "g" or "." may be used.)

ESC m N

(N=0..9/a..f) Set marker N.

ESC ' N (deprecated)

(N=0..9/a..f) Go to marker N.

HOP Home or ^G ^@ or ^G ^] or HOP ESC ^

Move to the position previously marked by Home/^@/^]/ESC ^

ESC Enter or Alt-Enter (Alt-Return) *

Return backward to the previous position marked in the position stack.

HOP ESC Enter or HOP Alt-Enter (HOP Alt-Return) *

Return forward to the next position marked in the position stack. * Note that depending on Window system or terminal, Alt-Enter may be captured as a function to maximize the window.

left mouse button

Move cursor to position.

Entering text

< printable char >

Insert the character at cursor position.

< Enter > or < LF Linefeed char > or < CR Return char >

Insert a newline at cursor position, clone line end type. Apply auto-indentation if enabled.

Ctrl-Enter (if editing Unicode text)

Make a new line by inserting a Unicode line separator at cursor position (unless disabled with +u-u).

Shift-Enter (if editing Unicode text)

Make a new line by inserting a Unicode paragraph separator at cursor position (unless disabled with +u-u).

→NEW→

Control-Shift-Enter (if editing Unicode or ISO 8859 text) Make a new line by inserting a Next Line character (U+0085).

Ctrl-Alt-Enter

Make a new line by inserting a DOS or Unix line end at cursor position (if editing Unix or DOS file, respectively).

Ctrl-Shift-Alt-Enter

Make a new line by inserting a Mac line end at cursor position.

< Tab char >

Insert a Tab character at cursor position. with option -+8 or -+4 or -+2: Tab expansion; insert as many space characters as needed to fill line up to the next Tab position.

^V < Tab char >

Insert a Tab character (even in Tab expansion mode).

HOP {, HOP (, HOP [, HOP <

Enter indented pair of matching parentheses.

HOP /

Enter an indented Javadoc comment frame.

HOP ' or HOP ´ (acute accent)

Enter an apostrophe (U+2019). Note: In smart quotes mode, ´ alone also enters an apostrophe.

HOP ` (grave accent)

Enter a glottal stop / 'okina (U+02BB). Note: In smart quotes mode, ` alone also enters a glottal stop.

HOP -

Underline the line that starts before the cursor position.

^O

Make new line at current position. If the current line is terminated by a Unicode paragraph separator, a line separator is inserted.
Auto-indentation is not applied.

HOP ^O

Split a line in two binary-transparently, i.e. enter a "NONE" virtual line end.

Accented character input support by accent prefix keys

F5 < character >

Compose character with diaeresis (umlaut accent), e.g. a » ä

Shift-F5 < character >

Compose character with tilde, e.g. a » ã

Ctrl-F5 < character >

Compose character with ring or with cedilla, e.g. a » å , c » ç

Ctrl-Shift-F5 < character >

Compose character with ogonek.

Alt-Shift-F5 < character >

Compose character with breve.

F6 < character >

Compose character with acute accent (accent d'aigu), e.g. a » á

Shift-F6 < character >

Compose character with grave accent, e.g. a » à

Ctrl-F6 < character >

Compose character with circumflex accent, e.g. a » â

Ctrl-Shift-F6 < character >

Compose character with macron.

Alt-Shift-F6 < character >

Compose character with dot above.

Ctrl-0 ... Ctrl-9

Compose character with accent, esp. for Vietnamese accented characters.

(Ctrl-)Alt-1 ... (Ctrl-)Alt-5

Compose character with two accents, esp. for Vietnamese double accented characters.

(Ctrl-)Alt-6 ... (Ctrl-)Alt-8

Compose character with two accents for Greek multiple accented characters.

Ctrl-< punctuation key >

Compose character with accent (looking similar to the modified punctuation character, e.g. Ctrl-, composes with cedilla, Ctrl-: with diaeresis, Ctrl-minus with macron, Ctrl-( with breve, Ctrl-< with caron, Ctrl-/ with stroke, Ctrl-; with ogonek, etc; see Accent prefix function keys above for details).

Input support commands

Ctrl-V special input support

These functions also work on the prompt line (e.g. to enter search expressions).

^V < control character >

Enter control character.

^V [ or ^V \ or ^V ]

Enter one of the control characters ^[, ^\, ^].

^V ^ ^ or ^V _ _

Enter one of the control characters ^^, ^_.

^V ^ ' or ^V ^ "

→NEW→ or ^V ^ ` or ^V ^ ´ Enter one of the straight quote marks ' or " or plain accents (needed in smart quotes mode)

^V < accent > < character >

Compose accented character.

^V # xxxx < Space or Enter >

Enter character defined by a hexadecimal number being input (depending on applicable encoding, byte value, Unicode value, or valid CJK code is required).

^V # # xxxxxx < Space or Enter >

Like ^V # but using an octal number.

^V # = xxxxx < Space or Enter >

Like ^V # but using a decimal number.

^V # u or U or +

(followed by a numeric input as described above, with optional # or = for octal or decimal input) interprets the input as a numeric Unicode value which is converted into the current text encoding.

^V # ... Space ...

With numeric character input, mined supports successive multiple character entry according to ISO 14755 if the numeric code is terminated by a Space key.

^V < function key >

This is not an input support function but rather the function key is invoked as if pressed together with the control key.

Mnemonic character input support

Mnemonics recognised include the following:

^V < Space > < name > < Space or Enter >

Lookup character mnemonic and enter character. RFC 1345 mnemonics take precedence in ambiguous cases.

^V < character > < character >

Compose two characters. Non-RFC 1345 mnemonics take precedence in ambiguous cases.

Note: A number of mnemonics are defined with already precomposed base characters (especially for Vietnamese input) which can be used for further composition.
^V can be applied recursively to compose a character for further composition.
See examples with æ below for both cases.

Examples:

^V^A

Enter Ctrl-A.

^V^[ or ^V[

Enter the escape character.

^V__

Enter Ctrl-_.

^V'e

Enter é (e with accent d'aigu).

^Vae

Enter æ (the ae ligature).

^V ae' (terminated by Space or Enter)

Enter U+01FD (æ with acute).

^Væ'

Enter U+01FD (æ with acute).

^V ^Vae' (terminated by Space or Enter)

Enter U+01FD (æ with acute).

^V'^Vae

Enter U+01FD (æ with acute).

^VOK or ^Vcm

Enter the check mark ✓ (U+2713)

^Vzz or ^V zigzag (terminated by Space or Enter)

Enter the downwards zigzag arrow ↯ (U+21AF)

^V-,

Enter ¬ (the negation symbol).

^V neg (terminated by Space or Enter)

Enter ¬ (the negation symbol).

^Va* or ^V a* (terminated by Space or Enter)

Enter the Greek small letter alpha.

^V ae' (terminated by Space or Enter)

Enter the Latin ligature ae with acute accent.

^V euro (terminated by Space or Enter)

Enter the Euro character.

^V#20ac (terminated by Space or Enter)

Enter the character with hexadecimal value 20AC (which is the Euro character in UTF-8 encoding).

^V#U20ac (terminated by Space or Enter)

Enter the Euro character (which has the hexadecimal Unicode value 20AC) encoded in the currently selected text encoding.

^V#+20ac < Space > +20ac < Enter >

Enter two Euro characters in successive multiple character entry mode (ISO 14755).

Input method (Keyboard mapping) selection

ESC k or Ctrl-Alt-F12 or middle-click on Input Method flag

Toggle between current and previously selected input method (or initially the configured standby input method). Note: Alt-k or Ctrl-Alt-F12 also works on prompt line.

HOP ESC k

Clear input method, i.e. resets keyboard mapping to none (unmapped input).

ESC I or ESC K or Ctrl-F12 or right click on Input Method flag (mapping indication in flags area)

Open the Input Method selection menu. Note: (Alt-I or Alt-K or Ctrl-F12 also works on prompt line)

HOP ESC K

Cycle through available keyboard mappings / input methods.

Modifying text

Note on the Home and End keys

Sometimes people expect the "Home" and "End" keys to move the cursor to the beginning or end of line, respectively. In the keyboard usage approach of mined, these functions can easily and quite intuitively be invoked with "HOP left" and "HOP right", i.e. by pressing the keypad keys "5 4" or "5 6" in sequence. So there is enough room left for mapping the most frequent paste-buffer functions to the keypad as described above which is considered much more useful. Use Ctrl-Home and Ctrl-End for the line positioning functions, depending on terminal support and configuration; or use the -k option if preferred to switch keypad key function assignments for the Home and End keys. See Keypad layout above for a motivating overview of the mined keypad assignment features and options.

Backarrow or ^H

Dual-mode function:
If a visual selection is active: Cut selected area to paste buffer.
Otherwise: Delete character left.
Smart backspacing: If there is only blank space before the current position in the current line and the line above and auto-indentation is enabled, the auto-undent function (Back-Tab) is performed instead, deleting multiple spaces back to the previous level of indentation. Note: Mined tries to map this function to the Backarrow key on the keyboard whether it is assigned to the Backspace or DEL control characters, by inspecting the setting of the terminal interface, see Automatic backspace mode adaptation. Note:→NEW→ Configuration option plain_BS (command line option +Bp) switches the Backarrow key from smart backspacing to plain backspacing, i.e. no auto-undent and only delete one combining character of a combined character. Use Shift-Control-Backarrow to perform smart backspacing then.

Ctrl-Backarrow (if key properly configured) or F5 Backarrow

"Delete single": Delete only right-most combining accent of combined character left of cursor position. If not next to a combined character: delete character left, avoiding auto-undent function.

→NEW→ Shift-Ctrl-Backarrow (if key properly configured) or Shift-F5 Backarrow

"Delete smart": Smart backspacing function as described above as default behaviour of the Backarrow key.

Del (on keypad)

Dual-mode function:
If a visual selection is active: Cut selected area to paste buffer.
Otherwise: Delete next character right, including any combining characters.

Ctrl-Del (on keypads, if key properly configured)

Delete character right, excluding any combining characters.

Shift-Del (on small keypad, if key properly configured)

Cut selected area to paste buffer.

DEL (ASCII character)

If detected to be attached to the keyboard Backarrow key: Delete left. (Or delete visual selection, see above.) (Enforce with option -B.)
Otherwise: Delete right.

HOP Backarrow

Delete beginning of line (left of current position).

^B

Delete character right (next character).

^T

Delete next word.

^^ (overridden when used as accent prefix, e.g. with newer xterm)

Delete previous word.

^K

Delete tail of line (from current position to line-end); if at end of line, delete line end (joining lines).

HOP ^K

Delete whole line.

Code conversion

ESC X

Insert hexadecimal representation of current character code. (In UTF-8 mode, this is the UTF-8 byte sequence of the character in hexadecimal notation.)

... with HOP:

Insert character with hexadecimal code scanned from text at current position.

ESC U

Insert (hexadecimal) Unicode value of current character (with either 4/6/8 hexadecimal digits, depending on the value); in CJK or mapped 8 bit encoding mode, the value is transformed from the current text encoding into Unicode.

... with HOP or Ctrl-Shift-F11

Insert character with hexadecimal Unicode value scanned from text at current position; in CJK or mapped 8 bit encoding mode, the value is transformed from Unicode into the current text encoding.

ESC A

Like ESC U but inserting an octal Unicode value.

... with HOP:

Like HOP ESC U but scanning an octal Unicode value.

ESC D

Like ESC U but inserting a decimal Unicode value.

... with HOP:

Like HOP ESC U but scanning a decimal Unicode value.

Alt-x

Toggle the preceding character and its hexadecimal Unicode value. The command detects a 2 to 6 hex digit character code with a valid Unicode value, or a non-digit Unicode character, respectively.

Case conversion

ESC C or F11

Exchange case (low/capital) of character under cursor. Case mapping is based on Unicode (but applicable in all text encodings). Special handling is applied for:

... with HOP or Shift-F11

Apply case conversion to word from cursor.

Shift-F3

Cycle casing of a word between all small, title case, and all capitals (title case means the first letter is either capital or actually a Unicode title case, the following letters are small). For Japanese script, it toggles the word between Hiragana and Katakana.

Mnemonic and special conversion

ESC _ or Ctrl-F11

Mnemonic character substitution replaces the two characters at the cursor position with a suitable composite character (e.g. accented character) if possible. With Ctrl-F11, transformations are the same as with the ^V two-letter character input mnemonics. With ESC _, language-dependent preferences may take precedence (see variations below) according to the current locale environment.
Example: ae → æ

Special conversion features

As variations of ESC _, there are some commands ESC LETTER using national letters that occur on respective national keyboards. They apply basically the same transformations but with some national preferences taking precedence:

ESC ä or ESC ö or ESC ü or ESC ß

Similar to ESC _, but with German transformation preferences.
example: ae → ä, oe → ö

ESC é or ESC è or ESC à or ESC ù or ESC ç

Similar to ESC _, but with French transformation preferences.
example: oe → œ (oe ligature U+0153)

ESC æ or ESC å or ESC ø

Similar to ESC _, but with Danish transformation preferences.
example: ae → æ, oe → ø

→NEW→ ESC ì or ESC ò

Similar to ESC _, but with Italian accent preferences (è rather than é).

→NEW→ ESC < accented letter typical on East European keyboard >

(like l with stroke, u with ring, o with double acute, s with caron, etc) Similar to ESC _, but with East European accent preferences: ogonek rather than cedilla, -d becomes d with stroke

→NEW→ ESC < special key typical on South European keyboard >

(like n with tilde, g with breve, dotless i) Like ESC _.

Encoding conversion

HOP ESC ( or Alt-F11

Search for a character encoded in the "wrong encoding", i.e. a UTF-8 character in non-UTF-8 text mode, or a Latin-1 character in UTF-8 text mode.

ESC _ or ESC ö etc.

If invoked on a non-ASCII character, UTF-8 / non-UTF-8 character encoding conversion is applied: If the character is not encoded in the current text encoding it is converted into the current text encoding (from UTF-8 or from Latin-1).

Alt-Shift-F11

Convert Latin-1 / UTF-8, then search for the next "wrong encoded" character.

Paragraph formatting

ESC j

("Clever Justify") Format paragraph by word-wrapping according to the currently set right margin value; left margins are derived from the contents of the paragraph and line. Heuristic detection of numbered items automatically triggers appropriate indentation.
End-of-paragraph is a line without trailing blank space.

... with HOP:

Same, but end-of-paragraph is considered to be a blank line.

ESC J

("Normal Justify") Format paragraph by word-wrapping according to the currently set left and right margin values.
End-of-paragraph is a line without trailing blank space.

... with HOP:

Same, but end-of-paragraph is a blank line.

ESC <

Set left margin for justification.

ESC ;

Set left margin of first line of paragraph only.

ESC :

Set left margin of next lines of paragraph only.

ESC >

Set right margin for justification.

HTML support

ESC H (every first time)

Enter HTML tag (and remember for subsequent ESC H). (Note that Alt-Shift-H will do the same thing if your terminal is configured appropriately - see the example configuration file Xdefaults.mined in the Mined runtime support library.) The tag can be entered with attributes and values; these will not be repeated in the closing tag (see next entry on ESC H).

ESC H (every second time)

Enter closing HTML tag. Any tag attributes and values entered with the tag (see previous entry on ESC H) will be left out.

HOP ESC H

Put text between mark and current position in HTML tags. The "A" tag gets special treatment.

Text block and buffer operations

Note on the Home and End keys

Sometimes people expect the "Home" and "End" keys to move the cursor to the beginning or end of line, respectively. In the keyboard usage approach of mined, these functions can easily and quite intuitively be invoked with "HOP left" and "HOP right", i.e. by pressing the keypad keys "5 4" or "5 6" in sequence. So there is enough room left for mapping the most frequent paste-buffer functions to the keypad as described above which is considered much more useful. Use Ctrl-Home and Ctrl-End for the line positioning functions, depending on terminal support and configuration; or use the -k option if preferred to switch keypad key function assignments for the Home and End keys. See Keypad layout above for a motivating overview of the mined keypad assignment features and options.

^@ (Ctrl-Space)

or Home (on right keypad) or Shift-Home
or ^] or ESC @ or ESC ^
or Stop (sun)or Select (VT100) Set mark (to remember the current location).

... with HOP:

Goto mark or: (if on already marked position) Toggle rectangular selection.

^Y

or End (on right keypad) or Shift-End
or Copy (sun) or Do (VT100) Copy selected text (between mark and current position) to paste buffer. If rectangular copy/paste mode is selected: Copy rectangular area spanned by mark and current position to paste buffer.

... with HOP:

Append to buffer.

^U

or Del (with visual selection) or Shift-Del (small keypad)
or Cut (sun) or Remove (VT100) Cut selected text (between mark and current position) to paste buffer. If rectangular copy/paste mode is selected: Cut rectangular area spanned by mark and current position to paste buffer.

... with HOP:

Append to buffer.

^P or Ins or Ctrl-Ins

or Paste (sun) or InsertHere (VT100) Paste contents of paste buffer to current position. If rectangular copy/paste mode is selected: Paste contents of paste buffer as rectangular area to current position and corresponding positions of subsequent lines. With ^P or Ctrl-Ins, the cursor is placed before the pasted region. With Ins, the cursor is placed behind the pasted region unless the option -V was used.
In rxvt, with Ins on the left keypad, the cursor is placed before (left of) the pasted region.

... with HOP: (e.g. HOP Ins or ^G^P)

Paste from inter-window buffer. Thus you can quickly copy text from one invocation of mined to another.

→NEW→ Shift-Ins (Windows/cygwin version)

Insert text from Windows clipboard, adapting lineend types. →NEW→ With Ctrl-Shift-Ins, the cursor is also placed before the pasted region.

Alt-Ins or Ctrl-F4

Replace text just pasted with preceding paste buffer. This command uses a ring of paste buffers (like emacs "yank ring").

ESC b or Shift-F4

Copy contents of paste buffer into a file.

... with HOP:

Append to file.

ESC i or F4

Insert file at current position.

Print from File menu

Print text being edited (to default printer).

HOP ESC ! or (deprecated) ESC c

Invoke operating system command (prompted for) with paste buffer as input.

Search

Note on case-insensitive searching

Mined applies case-insensitive search pattern matching where the search pattern contains small characters, unless when searching for an identifier (current identifier occurence, HOP F8, or identifier definition, Alt-t). For a case-sensitive search for a small letter, use a single-letter range expression like [x] or a backslash escape like \x (note, however, that \n and \r have special meaning).

ESC / or Find or F7 or F8 or / (on keypad)

Search forward (prompt for regular expression).

... with HOP:

Search for current identifier.

ESC \ or Alt-F7 or Alt-F8 or Alt-/ (on keypad)

Search backward (prompt for regular expression).

HOP F8 or Shift-F9

Search for current identifier.

HOP Alt-F8 or Alt-Shift-F9

Search for current identifier backward.

HOP Shift-F8 or ESC t or Alt-t

Search for definition of current identifier (using tags file), or open file referred to. See ESC t below for further description.

HOP Ctrl-Shift-F8

Search for identifier definition (prompts for identifier).

HOP Ctrl-F8 or Ctrl-Shift-F9

Search for current character.

^N or F9

Search for next occurence (using previous search expression and direction).

... with HOP:

Repeat last but one search; two alternating search expressions can be used with this command.

Alt-F9

Search again (for last expression) but in the opposite direction.

ESC , or Shift-F8

(Global) Substitute (prompt for search and replacement strings).

ESC r or Ctrl-F8

(Global) Replace with confirmation prompting (first prompt for strings).

ESC R or Ctrl-Shift-F8

(Line Replace) Substitute on current line (prompt for strings).

ESC ( or ESC ) or ESC { or ESC }

Perform one of the following matching searches, depending on text: Search for corresponding bracket matching the bracket at current position in one of the pairs (), [], {}, <>, «». (Nested matching bracket pairs are skipped.) In an HTML or XML file, search for matching tag (nesting considered). Search for matching /* */ comment delimiter. Search for matching #if #else/#elif #endif structures (nesting considered). On an #else or #elif directive, the search direction depends on the command character, i.e. ESC ( searches backward, ESC ) searches forward. In a mailbox file, on any mail header line, search for next or previous mail message, depending on the command character, i.e. ESC ( searches backward, ESC ) searches forward. In a mailbox file or saved mail message, on a MIME separator, search for next or previous MIME separator, depending on the command character, i.e. ESC ( searches backward, ESC ) searches forward.

ESC t or Alt-t or HOP Shift-F8

Search for and move to the location of the definition of identifier at the current cursor position. This command uses the tags file that can be generated with the ctags command (Unix). It opens another file if necessary and automatically saves the current file then.
On an include statement (line beginning with "include" or "#include"), the command opens the included file.
Like with a number of positioning commands, ESC t places the current position on the position marker stack before going to the location of the identifier definition. The command ESC Enter (Alt-Enter) can move back to that position, even if edited files were changed with the command.

HOP ESC t or HOP Ctrl-Shift-F8

Similar, but prompts for identifier.

HOP ESC ( or Alt-F11

Search for a character encoded in the "wrong encoding", i.e. a UTF-8 character in Latin-1 mode, or a Latin-1 character in UTF-8 mode.

Search expressions: Special functions

matches any character

^

(at begin of pattern) restricts match to the begin of a line

$

(at end of pattern) restricts match to the end of a line

[< character set >]

matches any one of a set of characters; the set may be given by listing elements, denoting a range < c1 >...< c2 >, or negating the whole set [^< character set >]

\< character >

matches the character literally (except n or r)

< pattern >*

(a star appended to a plain character of any of the patterns above) matches a repetition of this pattern (zero or more times); not applicable to line end patterns

^V^J (a literal linefeed character, entered with ^V prefix)

searches for any real newline (to be used embedded in the search pattern, does not match on last line)

\n→NEW→

searches for a Unix newline (LF) (to be used embedded in the search pattern, does not match on last line)

\r

searches for DOS/Windows newline (CRLF) (to be used embedded in the search pattern, does not match on last line)

\R→NEW→

searches for Mac newline (CR) (to be used embedded in the search pattern, does not match on last line)

\0→NEW→

searches for NUL character, represented as a pseudo line end

^V^M

searches for CR (carriage return) character embedded in a line

Replacement strings: Special functions

&

is replaced by the matched pattern to be replaced

^V^J or \n

(a linefeed character) embeds a newline (LF character) in the replacement string

\r

(a carriage return character) embeds a CR character in the replacement string

To change the line end type of a line or all lines, use "Lineend type..." from the Options menu.

File operations

ESC w or F2

Save (write back) current text to file (only if modified). Save file information (editing position etc), create file info file if needed.

... with HOP:

Save current file position and other editing information in file info file, so that subsequent editing sessions will start at the current position and remember formatting parameters.

ESC W or Shift-F2

Save (write back) current text to file (unconditionally). Also enable memory for file positions in current directory (creates file info file).

Alt-F2

Save As; save current text to file with different name; file permissions (access modes) are preserved and cloned.

Ctrl-Shift-F2 or HOP Shift-F2

Save to file, and enable memory for file positions in current directory (creates file info file).

F3

Edit another file (prompt for save if current text changed).

Ctrl-F3 or ESC v

View another file (prompt for save if current text changed).

ESC V

Toggle between edit mode and view only mode.

ESC q

Quit the editor (prompt for save if current text changed).

ESC ESC or Ctrl-F2

Exit editing current text (save first if changed), continue with the next file (from the File switcher list); exit mined if there is no subsequent file to edit. Note: If a file name occurs on the command line multiple times (explicitly or by wildcard expansion), file list navigation is not linear. Note: There is a small delay after typing ESC ESC. (This is in order to enable recognition of Alt-function key combinations which are implemented by some terminals or terminal modes by prefixing ESC to the function key escape sequence.) This delay can be avoided by using Ctrl-F2.

ESC +

Edit the next file (from the File switcher list) Note: If a file name occurs on the command line multiple times (explicitly or by wildcard expansion), file list navigation is not linear.

... with HOP:

Edit the last file.

ESC -

Edit the previous file (from the File switcher list)

... with HOP:

Edit the first file.

ESC #

Ask for index into the list of files and edit that file.

^G N # or ESC g N #

Edit Nth file. (^G N f also works.)

ESC # #

Reload file currently being edited.

Menu

ESC Space or Alt-Space or Shift-F10

Open Popup menu.

ESC F10 or Alt-F10 or Ctrl-F10

Open first flag menu (Info menu).

ESC f or Alt-f or F10

Open File menu.

ESC < letter > or Alt-< letter >

Open menu.

ESC I or Alt-I or ESC K or Alt-K or Ctrl-F12

Open the Input Method selection menu. (Alt-I/Alt-K/Ctrl-F12 also works on prompt line)

ESC Q or Alt-Q

Open the Smart Quotes selection menu.

ESC E or Alt-E

Open the Encoding selection menu.

Miscellaneous

ESC = < count >

Repeat a command < count > times (prompts for count). Example: ESC=7< cursor down > moves the cursor 7 lines down. Note: If the function to be repeated is a character to be inserted and the input is keyboard mapped to a multi-character sequence, only the first character of the sequence is inserted repeatedly.

ESC < count >

Repeat a command < count > times (prompts for rest of count); this short form is only accepted, however, if the repeat count consists of at least two digits (this is to avoid confusion with function key escape sequences of certain terminals). Example: ESC77. enters a line of 77 dots, ESC07x enters "xxxxxxx".

^V < function key >

Invoke function as if pressed together with the control key. E.g. ^V < cursor-left > moves left into the parts of a combined character just like Ctrl-cursor-left would do (the latter may depend on proper terminal setup).

^\

Abort current command, e.g. while on prompt line.

ESC ?

Show the current status of the file (name, whether modified, current line, number of lines, characters, and bytes).

... with HOP:

Toggle permanent display of text status line. Note that when editing a file that does not fit completely in memory (e.g. large file on old system), this option may cause considerable swapping. In that case, do not use the feature.

ESC u

Display the character code of the current character in the bottom status line. (In UTF-8 encoded text mode, both the UTF-8 byte sequence and the Unicode value are displayed; in CJK or mapped 8 bit encoded text mode, Han or 8 bit character values and corresponding Unicode values are displayed when applicable.) In non-Latin-1 encoded text mode, additional Unicode information is included, indicating the script, character category, width, combining, and surrogate properties of the character.

... with HOP:

Toggle permanent character code display.

ESC T

Toggle Tab width. Alternates the width interpretation of Tab characters between 2-4-8.

... with HOP:

Toggle Tab expansion (input substitution with spaces).

ESC P

Set page length (number of lines that mined assumes to be on a page). (Useful for status display.)

ESC a

Toggle append mode (append to text buffer/file instead of overwriting).

ESC d

Show current directory / change to another one (also change drive in MSDOS version).
The assumed (relative) file path name as well as file permissions (access modes) are preserved.

ESC n or Set Name... from File menu

Change the file name associated with the text being edited; the file is not actually saved yet but only the new file name is used for saving the next time. The text is detached from the file previously loaded which is not affected.
All current text editing properties (assumed encoding, smart quotes style, margins, ...) as well as file permissions (access modes) are preserved.

ESC .

Redraw the screen.

→NEW→ Alt-F12

(In terminals that support an alternate screen view:)
Switch to normal screen (to view command line history and possibly mouse-copy/paste) until next input.

ESC l

Make screen lower (decrease number of screen lines).

ESC L

Make screen higher (increase number of screen lines).

ESC %

Make screen smaller (decrease screen size).

ESC &

Make screen bigger (increase screen size).

Shift-keypad-Minus

Make font smaller. (Works in mintty and natively in xterm.)

Shift-keypad-Plus

Make font bigger. (Works in mintty and natively in xterm.)

ESC z

Suspend editor process; first write back file if modified (no write if HOPped or given empty file name on prompting). Mined detects (by checking process and group IDs and terminals) whether it is safe to suspend and rejects it otherwise (e.g. if it is run embedded within a terminal, without underlying shell, or from a shell script).

ESC !

Fork off a shell and wait for it to finish.

... with HOP:

Invoke operating system command (prompted for) with paste buffer as input.

F1 or Help or Alt-h or ESC h

Interactive help function. Selection of help topics is offered and prompted; after entering the initial letter, the respective help section is shown.
If another (modified) F1 key, a modified digit key, or a Ctrl-modified punctuation key is entered, a corresponding key assignment help bar is displayed (see F1 F1 etc. below).
The help file mined.hlp is installed with the Mined runtime support library. If this is not installed in one of the standard locations, the environment variable MINEDDIR should be set to point to the directory so mined can find its help file.

F1 F1 or Shift-F1 or Ctrl-F1 or Alt-F1 or Ctrl-Shift-F1 or Alt-Shift-F1

Display a help bar (in the bottom status line) with short indications of the functions assigned to the function keys F2... in the corresponding modified mode (i.e. with Control, Shift, and Alt as requested for the help bar).

... with HOP:

Toggle permanent help bar display.

F1 Ctrl-1 or F1 Alt-1 or F1 Alt-Ctrl-1

Display a help bar (in the bottom status line) with short indications of the accent prefix functions assigned to the digit keys 1..9, 0 in the corresponding modified mode (i.e. with Control and Alt as requested for the help bar).

... with HOP:

Toggle permanent help bar display.

F1 Ctrl-< punctuation key > e.g. F1 Ctrl-,

Display a help bar (in the bottom status line) with short indications of the accent prefix functions assigned to the Ctrl-modified punctuation keys.

... with HOP:

Toggle permanent help bar display.

ESC

While a command is active and prompting (e.g. for a search expression), ESC aborts the current command.

ESC Space

Do nothing, so the Space key aborts the ESC command.

MSDOS keyboard functions

Ctrl-Alt-Space

Set mark (to remember the current location).

Alt-TAB (not in Windows)

HOP / Go to.

Ctrl-* (on keypad)

HOP / Go to.

Ctrl-/ (on keypad)

Search forward.

Alt-/ (on keypad)

Search backward.

Screen size change functions

MSDOS screen size changes depend on a table of common VGA video modes (dosvideo.t).
In the presence of a TSR driver which can change fonts and screen modes while running a program (e.g. the excellent VGAMAX), the actual change effective may occasionally be unexpected. Mined recognises such changes after the next character input and adjusts to them.

Alt-- (on keypad)

Change video lines mode to the mode with the next smaller number of lines but same number of columns. (The number of lines is first tried to be decreased within the current video mode. If it is already the lowest, the next video mode is chosen.)

Alt-+ (on keypad)

Change video lines mode to the mode with the next higher number of lines but same number of columns.

Ctrl-- (on keypad)

Change video mode to the mode with the next smaller total resolution (lines * columns).

Ctrl-+ (on keypad)

Change video mode to the mode with the next higher total resolution.

HOP Ctrl-/Alt- +/- (on keypad)

Several other video mode settings are prompted for (experimental).

<!p>

Emacs mode

Command overview:

^A, ^B, ^E, ^F, ^N, ^P, ^V, M-v, M-b, M-f, M-a, M-e, M-< , M->, ^X[, ^X]

cursor and screen movement

^D

delete character

^O

insert new line

^Q

insert literal character

^@

mark position

^W / M-w

cut / copy to buffer

^K

delete to end of line / delete line end, and append to buffer

M-d / M-k

delete word / delete end of sentence, and append to buffer

^Y

paste buffer

M-y

paste previous buffer, replacing text just pasted

M-u

transform word upper-case

M-l

transform word lower-case

M-c

transform word capitalised (initial upper-case)

^S, ^R

search forward / reverse

M-%

replace with confirmation

M-.

search for identifier definition (using tags file)

^X^S, ^Xs

save file

^X^W

save file as (using different name)

^X^F

edit other file (prompts for name)

^X^B

edit previous file (among those listed on command line)

^X^C

quit editor, prompt for saving text first

^Xk

discard current edit buffer (after confirmation), open new one

^Xi

insert file

^X=

display file statistics

^L

refresh display

^U, ^X^[

repeat (not as generic numeric command parameter)

^H

help

^Z, M-z, ^X^Z

suspend editor

^\ (mined add-on)

HOP (generic function amplifier / expander)

M-x (Deprecated mined add-on)

invoke mined ESC command

ESC ESC (mined add-on)

invoke mined ESC command

<!p>

Windows keyboard mode

^@

mark position

^C

copy selected text area (between marked and current position)

^F

search

^G

goto

^H

replace (with confirm)

^O

open other file

^P

print

^Q

quit

^S

save file

^V

paste

^W

close file

^X

cut selected text area (between mark and current position)

^_

insert control character

<!p>

WordStar mode

^S, ^D, ^E, ^X, ^A, ^F, ^R, ^C, ^W, ^Z, ^H

cursor and screen movement

^G

delete character

^T

delete word

^Y

delete line

^Q^Y

delete to end of line

^N

insert new line

^P

insert control character

^Q^W, ^Q^Z

scroll multiple screen lines

^Q^F

find

^Q^A

find and replace (with HOP: with confirm)

^L

repeat last search

^Q

HOP key

^Q, ^K, ^O

two-key command prefixes

^Q^Q

repeat following command

^B

paragraph justification (word wrap)

^OL

set left margins

^OG

set left margin for first line of paragraph

^OR

set right margin

^KB

set marker

^QB

goto marker

^Kn

(n=0..9) set marker n

^Qn

(n=0..9) goto marker n

^KK

copy between here and marker (not exactly WS function)

^KC

copy (paste) saved text here (not exactly WS function)

^KY

delete between here and marker (not exactly WS function)

^KV

copy (paste) saved text here (not exactly WS function)

^KW

write paste buffer to file

^KR

read (insert) file here

^KS

write (save) edited text to file

^KD

write (save) edited text to file, edit next file

^KX

exit (and save)

^KQ

quit (don't save)

^KL

change current directory

Mined runtime support library

Mined runtime support includes:

PC versions

For hints on PC-specific terminal configuration issues, see PC terminals below.

VMS version

Android version

Terminal environment

On Unix, the terminal type is determined from the environment variable TERM. The termcap/terminfo mechanism is used to derive the actual properties of the terminal; for some terminals (cygwin, xterm, rxvt, vt*), this information is also built-in as a fallback in case terminal information is not available on a system (this is especially useful for the cygwin stand-alone version).

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). Non-trivial screen features (like scroll reverse, add/delete line, erase multiple characters) are used if their support is indicated in the termcap/terminfo description of the terminal unless other information is available (e.g. after terminal version detection, an older xterm is supposed not to support erase characters). Since colour support is often not configured within terminfo but modern terminals do support it, mined always tries to apply colour attributes (if the terminal at least supports ANSI control sequences). A number of other "best practice" approaches are taken to optimize the usage of terminal capabilities, esp. covering different methods of graphics display support (for menu borders).

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 alone (which it considers however since mined 2000.14); 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.

Locale configuration

For encoding recognition from locale environment variables, mined recognises locale specifications typically found in system installations, including those which do not include an explicit encoding suffix. Known character encoding suffixes ("codeset" component of locale name, starting with ".") are recognised regardless of whether the given locale is installed or not. Other encodings are recognised by region suffix (starting with "_") or full locale name or alias.
In addition to hard-coded locale recognition (especially for CJK), locale values and associated encodings are configured in the compile-time configuration file locales.cfg which especially lists locale names that do not have an explicit encoding suffix. You can use these settings (known locale name or generic locale name suffix) even on legacy systems without locale support to indicate the terminal environment properly to mined. For encoding recognition from command-line parameters, mined provides the following options:

In these options, -E specifies

text encoding while +E would specify terminal encoding to be assumed.

The following table lists encodings and major codepages that are recognised by a generic locale suffix or country code; in addition (as mentioned above), a large number of locale names without encoding suffix as found on various systems is known to mined and will cause it to assume the corresponding terminal encoding.

Unicode: UTF-8

suffixes: .UTF-8 / .utf8

Traditional Chinese (Hongkong): Big5 with HKSCS (includes CP950)

suffixes: .BIG5* / .Big5* / .big5* / _HK / _TW (_TW ambiguous, following encoding overrides)

Simplified Chinese: GB18030 (includes CP936, GBK and GB2312)

suffixes: .GB* / .gb* / .EUC-CN / .euccn / _CN.EUC / _CN

Traditional Chinese (Taiwan): CNS (EUC-TW)

suffixes: .EUC-TW / .euctw / .eucTW / _TW.EUC

Japanese: EUC-JP

suffixes: .EUC-JP / .eucjp / .eucJP / .ujis / _JP.EUC / _JP / .euc (.euc ambiguous, more specific string overrides)

Japanese: Shift_JIS / CP932

suffixes: .Shift_JIS / .shiftjis / .sjis / .SJIS

Korean Unified Hangul: UHC / CP949 (includes EUC-KR)

suffixes: .UHC / .EUC-KR / .euckr / .eucKR / _KR.EUC / _KR

Korean: Johab

suffixes: .JOHAB

Vietnamese: VISCII

suffixes: .viscii

Vietnamese: TCVN

suffixes: .tcvn

Thai: TIS-620

suffixes: .tis* / .TIS* / _TH / .iso8859[-]11 / .ISO8859[-]11

Latin-9: ISO 8859-15

suffixes: @euro / .iso8859[-]15 / .ISO8859[-]15

Cyrillic: ISO 8859-5

suffixes: @cyrillic (unless preceded by uz_UZ which indicates UTF-8)

Latin or other: ISO 8859 encodings

suffixes: .iso8859[-]N / .ISO8859[-]N (with number N)

Russian Cyrillic: KOI8-R

suffixes: .koi8r

Ukrainian Cyrillic: KOI8-U

suffixes: .koi8u

Tadjikistan Cyrillic: KOI8-T

suffixes: .koi8t

Russian, Ukrainian, Byelorussian Cyrillic: KOI8-RU

suffixes: .koi

MacRoman:

suffixes: .roman

Windows Latin: CP1252

suffixes: .cp1252

Windows Cyrillic: CP1251

suffixes: .cp1251

PC Latin: CP850

suffixes: .cp850

Windows Hebrew: CP1255

suffixes: .cp1255

Georgian: Georgian-PS

suffixes: .georgianps

Armenian: ARMSCII

suffixes: .ARMSCII-8

Kazachstan Cyrillic: PT154

suffixes: .pt154

Examples: To indicate that mined is running in a UTF-8 terminal (normally auto-detected, included here for demonstration) and should assume GB18030 text encoding by default, invoke either of:

LC_ALL=whatever.UTF-8 TEXTLANG=zh_CN.gbk mined

LC_CTYPE=whatever.UTF-8 LANGUAGE=chinese mined

LANG=whatever.UTF-8 mined -EG

LC_ALL=en_IN mined -E.gbk

mined +EU -E.EUC-CN

mined +EU -E=GB18030

mined +EU -E:GB

Selecting UTF-16 text mode: To tell mined to interpret a file (or make a new file) in UTF-16 encoding, use the following command line options (first two little endian, then big endian):

mined -E:61

mined -E=UTF-16LE

mined -E:16

mined -E=UTF-16BE

mined -E=UTF-16

Selecting ASCII terminal mode: To tell mined to assume that a terminal cannot display anything but ASCII characters, use the command line option +E:AS. Mined implicitly assumes this setting if the environment variable TERM indicates a VT52 terminal.

PC terminals

The following assumptions are made based on environment variables or command-line parameters:

encoding ("codepage")

environment
option
examples

CP850 (PC mapping of Latin-1 character set)

TERM=ansi, ansi-nt, pcansi*, hpansi*, interix* or TERM=cygwin and CYGWIN contains "codepage:oem" or LC_*/LANG indicates ".CP850"
+EP

• Windows console (DOS prompt) window
• Windows console mode telnet (even if called from cygwin console, sets TERM=ansi)

CP437 (IBM PC VGA encoding)

TERM=nansi*, ansi.*, opennt*, *-emx* or LC_*/LANG indicates ".CP437"
+Ep

•

plain DOS

CP1252 (Windows ANSI extension of Latin-1)

TERM=cygwin (unless LC_*/LANG or CYGWIN indicates other encoding)
+EW

• cygwin 1.5 console or application
• older Windows GUI telnet (sets TERM=ansi)

UTF-8

LC_*/LANG indicates ".UTF-8" or (for cygwin 1.7 beta) TERM=cygwin and CYGWIN contains "codepage:utf8"
+U

•

cygwin 1.7 console or application configured for UTF-8 mode

other codepages

LC_*/LANG indicates codepage, e.g. ".CP1250" or ".CP858"
or triggered by DOS codepage information (djgpp version, see note)
+E=CP1250 or other codepage, or respective shortcut

•

cygwin 1.7 console or application configured for respective codepage

Note: It is not unlikely that the assumption about the terminal encoding taken by mined does not match the actual terminal encoding (e.g. mined cannot determine the encoding based on the ambiguous setting TERM=ansi). Environment variables that indicate the character encoding are unfortunately not maintained through telnet or remote login.
Explicitly setting TERM to a suitable value after remote login may help but may not always work (e.g. pcansi is not a known terminal on SunOS). Explicitly setting locale variables, e.g. LC_CTYPE, may indicate the encoding to mined but may cause trouble otherwise; some systems like SunOS are dogmatic about interpreting locale variables and strictly ask corresponding locale data to be installed or they will flood you with bogus error messages. Also not all encodings, esp. PC "codepages", are known as a "locale charmap" on other systems.
In these cases, you can use the explicit +E option to force mined to assume a specific terminal encoding; see the option values listed above for the main DOS encodings.

Note: The encoding emulated by cygwin (as configured, or by default typically CP1252 for cygwin 1.5, UTF-8 for cygwin 1.7) is not the encoding natively applied by the Windows console window (by default typically the DOS codepage CP850). This means that the effective encoding may be different if you invoke the cygwin-compiled mined version and the djgpp-compiled mined version alternatingly; you may notice this by a different range of characters that can be displayed when opening the same file with the two mined versions.
Some Windows Latin characters are poorly displayed by the Windows console in default configuration; cygwin 1.7 can display all characters properly if the Windows console font is configured to "Lucida Console" rather than "Raster Fonts".
In a cygwin console on a non-cygwin system (after remote login), mined assumes ASCII as the terminal encoding by default unless properly indicated by environment variables.

Note: The following DOS codepages are supported; they are mainly provided as terminal codepages, they do not appear in the Encoding menu. However, if you need, you can ask mined to use them as either the assumed terminal encoding (e.g. +E=CP1250 or +E:WE) or even text encoding (e.g. -E=CP1250 or -E:WE) using the names or shortcuts from the list:

CP437

PC
DOS US

CP720

DA
→NEW→ DOS Arabic

CP737

37
DOS Greek

CP775

75
DOS Baltic

CP850

PL
DOS Western European

CP852

52
DOS Central European

CP853

53
South European, Esperanto

CP855

55
DOS Cyrillic

CP857

57
DOS Turkish

CP858

58
DOS Western, CP850 with Euro symbol

CP860

60
DOS Portuguese

CP861

61
DOS Icelandic

CP862

62
DOS Hebrew

CP863

63
DOS French Canadian

CP864E

64
DOS Arabic (CP864E, variant of AR864 (superset of CP864))

CP865

65
DOS Nordic

CP866

66
DOS Russian

CP869

69
DOS Modern Greek

CP874

TI
Windows Thai, superset of ISO-8859-11/TIS-620

CP1125

25
DOS Ukraine

CP1131

31
→NEW→ DOS Byelorussian/Ukrainian

CP1250

WE
Windows Central European

CP1251

WC
Windows Cyrillic

CP1252

WL
Windows Western European

CP1253

WG
Windows Greek

CP1254

WT
Windows Turkish

CP1255

He
Windows Hebrew

CP1256

WA
Windows Arabic

CP1257

WB
Windows Baltic

CP1258

WV
→NEW→ Windows Vietnamese

Note: For the djgpp version of mined, even the font chosen for the Windows console window may affect the effective display encoding. Configure "Raster Fonts" (except of size "10 x 20"!), not "Lucida Console" in order to make sure the effective visual codepage is the same as the one selected with the respective DOS tools (e.g. chcp) and assumed by mined.

Note: Mined (djgpp) tries to determine the DOS/Windows codepage using the DOS API; this can only work if the codepage was properly configured with DOS means (e.g. with CP858 using CHCP 858 or MODE CON CP SELECT=858, maybe enabled by DEVICE=...\DISPLAY.SYS CON=(EGA,858) on old DOS, or MODE CON CP PREP=((codepage list) ...\ega.cpi)); if only the font is switched to a differently encoded one, there is no way to detect this - in this case you can still use environment setting or the +E option as described above to indicate the terminal encoding.

Note: To enable mouse operation in a Windows console window, deactivate "QuickEdit mode" in the properties menu.

Note: If the DOS screen size is changed by a TSR (e.g. VGAMAX using a hotkey), mined does not notice this immediately; in that case, mined adjusts its screen display only after the next key is typed.

Note: Running mined (djgpp) in a dosemu session (DOS emulator on Linux) works fine, even in an xterm-embedded session although not perfectly 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.

Terminal setup and configuration

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 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.

Terminal interworking problems

any terminal: menu border display

•

If the borders of mined menus appear as letters rather than graphic borders, the terminal can unexpectedly not handle VT100 graphics. Use the option -Qa to switch to ASCII borders, or -fff to limit font assumptions.
In a UTF-8 terminal, mined uses Unicode Box Drawing characters by default. If they don't display they are missing in the font used by the terminal. Use the option -Qv to switch to VT100 graphics or -Qa to switch to ASCII graphics. If borders are visible but without corners, use -Qs to switch to simple rectangular borders.

any terminal: slow terminal feature auto-detection

• On a slow remote terminal connection, escape sequences from the terminal (sent for function keys or requested terminal responses) may get delayed and split up. Mined tries to handle delayed parts of escape sequences graciously (→NEW→ improved again); however, this is limited as the explicit ESC key shall also be recognised.
  If messages like "Late screen mode response - ..." (after startup), "...awaiting slow terminal response" (esp. after startup), "...awaiting slow key code sequence" or "...absorbing delayed terminal..." occur, escape sequence detection may be adjusted by setting the environment variable ESCDELAY to a value of 2000 or 3000. (Delay during startup may apparently also be caused by on-demand font loading of rxvt or mlterm, however, mined applies special handling for this case.)
• If proper terminal detection fails for delay reasons, mined may especially not be aware of the terminal encoding (and display line markers as blocks). In this case, exiting and restarting mined should resolve the issue.

xterm

• To enable proper Alt-letter command input (for opening and navigating menus), set the xterm resource metaSendsEscape to true (or with older versions of xterm, set eightBitInput to false) in your X configuration (usually $HOME/.Xdefaults or $HOME/.Xresources) as suggested in the example file Xdefaults.mined in the Mined runtime support library.
• Although it is a waste of keyboard resources to have two indistinguishable sets of keypad keys, most terminals provide no means of distinguish them towards the applications, at least not by default. Especially for a text editor, it is highly desirable to distinguish them in order to have a rich intuitive function key mapping at disposition which mined tries to achieve.
  One approach to improve mapping of useful key functions would be actual keyboard remapping (applicable on some terminals); this is a delicate approach, though, because it may create incompatibilities with other programs that rely strictly on installed terminfo information. Mined provides remapping recommendations for shifted keypad keys (with Shift, Control, Alt and combinations of them) in the configuration sample files Xdefaults.mined (for xterm), konsole/xterm-modified.keytab (for KDE konsole), mlterm/key (for mlterm), in the Mined runtime support library.
  Due to the compatibility limitations mentioned above, however, the two Ins keys remain indistinguishable, and the two Del keys are only distinguishable if the xterm configuration resource *VT100*deleteIsDEL is set. Also, keypad and function key modification with the Alt is ensured with the xterm resource *VT100*metaSendsEscape. Both resources are set to true in the configuration sample file just mentioned.
  These two resources can also be set dynamically with xterm. Mined can be told to do so with the command line option +D. (Unfortunately this handling cannot be enabled by default as it cannot be undone because the previous state cannot be detected.)
• Mined determines the xterm version in order to apply certain workarounds conditionally.
• If you run xterm in VT220 keyboard mode (using xterm option -kt vt220 or setting the configuration resource *keyboardType: vt220) you should make sure to also set the environment variable TERM=vt220 (e.g. using the xterm option -tn vt220 or setting the configuration resource *termName: vt220) so mined can properly set up the keypad functions.
• If you run xterm with the resource modifyCursorKeys or modifyFunctionKeys set to value 1, mined will recognise the according keyboard sequences with the environment variable setting TERM=xterm-sco.

xterm on cygwin

•

On cygwin, as on other systems, the script uterm is recommended to invoke an xterm that is properly configured to run UTF-8, and also to use a best choice of fonts for optimal Unicode coverage. See README.cygwin for more detailed advice.

xterm legacy CJK width mode

•

Mined auto-detects and supports xterm legacy CJK width compatibility mode (xterm -cjk_width); character width and menu border layout are properly adjusted, stylish menu borders (-QQ) and fine-grained scroll bar display are disabled by default. (Note: In this mode, combining characters could unexpectedly change the width of a character by being substituted with its wide precomposed form (e.g. 'a' combined with U+0300) - which an application can hardly handle; this bug was fixed in xterm 224 with a patch contributed by the mined author.)

rxvt

• When starting mined in a fresh rxvt terminal, and maybe even after starting your X server, some display (font?) initialization may take extremely long. If this results in an error message, restart mined to ensure proper terminal properties auto-detection.
• Rxvt does not distinguish between Shift-F1 and F11 / Shift-F2 and F12 / Ctrl-Shift-F1 and Ctrl-F11 / Ctrl-Shift-F2 and Ctrl-F12, so that the F1 and F2 keys modified with Shift cannot be recognised in rxvt by default. They can however be enabled with the keysym definitions in the file Xdefaults.mined in the Mined runtime support library.
• In rxvt, the two keypad Del keys (small keypad, numeric keypad) are automatically distinguished from each other and invoke the Delete character (small keypad) and Cut (numeric keypad) functions, respectively (Ctrl-/Shift-/Alt- alternatives are supported as described in this manual). This works, however, only if mined can recognise rxvt; it is generally a bad idea to set TERM=xterm in rxvt, see also hint below.
• Also in rxvt, the two keypad Ins keys (small keypad left, numeric keypad right) are distinguished. The left Ins key positions the cursor left of the pasted region, the right Ins key positions it right.
• By setting rxvt in the mode that enables distinction between the two keypads, it can unfortunately not distinguish the right keypad modified with Ctrl- anymore, so Ctrl-Home/End/Del cannot work as desired.
• Ctrl-modified punctuation keys can be enabled by following the configuration samples of the file Xdefaults.mined in the Mined runtime support library.
  Note: Ctrl-modified and shifted punctuation keys interfere with ISO 14755 input mode of rxvt; if the following key is entered twice, that mode is aborted and the modified punctuation key becomes effective as an accent prefix in mined.
• To enable proper Alt-letter command input (for opening and navigating menus), set the rxvt resource meta8 to false in your X configuration (usually $HOME/.Xdefaults or $HOME/.Xresources) as suggested in the example file Xdefaults.mined in the Mined runtime support library.
• Later rxvt-unicode provides a CJK terminal emulation. CJK display is buggy for characters that rxvt thinks cannot be displayed, especially for GB18030 (LC_CTYPE=zh_CN.gb18030 rxvt) but also e.g. for EUC-JP (LC_CTYPE=ja_JP.eucjp rxvt); single bytes are then interpreted instead which amounts to an unpredictable screen width and cannot be correctly handled. (This applies mainly to character codes that are not mapped to Unicode but also to many that are mapped.)
  Moreover, CJK width handling is inconsistent for many characters in rxvt CJK mode (rxvt claims to adhere to the locale mechanism in this respect but that's not the case here - character widths are inconsistent with the locale, too).
  Remedy: Don't use rxvt in CJK-encoded mode; mined CJK terminal support is tailored to native CJK terminals (such as cxterm, kterm, hanterm) where it works fine - if you use a UTF-8-capable terminal, use it in UTF-8 mode! Mined can edit CJK-encoded files well in a UTF-8-encoded terminal.
• In rxvt, Unicode characters that are Not Assigned are always displayed as a single-width replacement character. This is not consistent with xterm behaviour which would display them as a double-width replacement if they are located within a double-width Unicode range (which sounds reasonable). This would cause display positioning inconsistencies. Mined has a workaround for some of these cases (assuming that rxvt runs the most recent Unicode width data version available; or actually the same as mined assumes - handling of multiple auto-detected terminal Unicode versions does not cover this special case).
• If the X windows servers has duplicate fonts installed under a common name (e.g. if it comes with a 10x20 non-Unicode font and you install a 10x20 Unicode font in addition), rxvt seems to use the wrong (i.e., non-Unicode) version of the font and does not find special characters like the default marker used in the flags menus (this was observed since rxvt 7.5, rxvt 5.8 was finding the proper font). Use the mined option -F to adapt mined to limited font usage, or fix the X server installation. Or use the script uterm to start rxvt-unicode. To start rxvt-unicode from an xterm, use uterm -rx.
• Due to the scrollbar display workaround for hanterm (see above), the scrollbar position may be shown as blank space instead of coloured (only in rxvt CJK mode with Korean encoding and if you explicitly set TERM=xterm which you shouldn't anyway in rxvt). In this case, coloured scrollbar foreground can be enabled with the environment variable MINEDSCROLLFG="44;36" or MINEDSCROLLFG="38;5;45".
• As a workaround for an xterm bug on cygwin, mined applies terminal size re-adjustment. This may confuse rxvt (being resized to an unexpectedly large window) if it pretends to be xterm.
  Remedy: in rxvt, make sure that the environment variable TERM=rxvt (or rxvt-unicode); the according X resource (Rxvt.termName: rxvt) is also listed in the file Xdefaults.mined in the Mined runtime support library.
• Mined determines the rxvt version in order to use certain features conditionally.
• CJK-mode rxvt: rxvt has some character width bugs when running in CJK encoding; e.g. when running rxvt in Big5 terminal encoding (locale zh_TW), U+FA18 is displayed with wrong screen width while in older version U+FFED was display with wrong screen width; when running rxvt in Shift_JIS terminal encoding, a number of character width bugs occur. Mined does not implement workarounds for those; in general UTF-8 terminal encoding is advisable to be on the safe side.

urxvt

•

This is rxvt-unicode as packaged for cygwin. Invoke it with a proper locale environment variable set to enable UTF-8. See also README.cygwin for more detailed hints.

mlterm

• Bidirectional display handling of mlterm is based on the final display, not regarding any context (such as positioning control, that's why mined implements a workaround for menu display on mlterm). Since version 3.0.7, mlterm supports logical order mouse positioning over right-to-left lines.
• For Shift selection, use the small keypad.
• Recent mlterm before version 3.1.3 has a problem with colour control that may render text unreadable.
• In recent mlterm versions, Control-function keys cannot be used in mined since they are captured as mlterm hotkeys. Use a Control-V prefix as a workaround.
• (Not essential anymore with recent mlterm versions) The Mined runtime support library includes a configuration file mlterm/key which defines enhanced escape sequences for function keys and other modified keys in order to enable the functionality described in this manual. (It also enables the keypad on systems lacking its configuration for mlterm.) It is essential to use this configuration especially for the HOP key (keypad "5") which is oppressed by mlterm by default, and also for Control-punctuation accent prefix functions, and some others.
• In old versions of mlterm, mouse wheel scroll navigation in menus did not work seamlessly due to incorrect escape sequences.
• Do not use mlterm option -n ! It may produce display garbage on unknown and other characters.

cxterm

• Proper configuration is needed to ensure cxterm uses a non-CJK font of appropriate size to avoid ragged display: parameter -fn "-misc-fixed-medium-r-normal--18-*-*-*-*-*-*-*" or X resource cxterm*font: -misc-fixed-medium-r-normal--18-*-*-*-*-*-*-*.
• EUC-JP half-width characters (8EA1-8EDF) are not properly displayed by cxterm in EUC-JP mode (cxterm -JIS, not available in "classic" cxterm).
• Due to the scrollbar display workaround for hanterm (see above), the scrollbar position may be shown as blank space instead of coloured (only in Korean encoding mode which is probably rarely used with cxterm anyway). In this case, coloured scrollbar foreground can be enabled with the environment variable MINEDSCROLLFG="44;36" or MINEDSCROLLFG="38;5;45".
• Note: The configuration sample file Xefaults.mined in the Mined runtime support library includes a section to fix some missing keypad assignments, especially the HOP key (keypad "5") which is ignored by cxterm by default, and the Home and End keys of the numeric keypad.

kterm

• Auto-detection of kterm as a CJK terminal works if the environment variable TERM indicates "kterm"; otherwise mined has to be told that it runs in a CJK terminal and which encoding to use:
  For kterm -km sjis, set LC_CTYPE=ja_JP.sjis (or invoke mined +ES).
  For kterm -km euc, set LC_CTYPE=ja_JP.eucjp (or invoke mined +EJ).
• Note:The configuration sample file Xefaults.mined in the Mined runtime support library includes a section to fix some missing keypad assignments, especially the HOP key (keypad "5") which is ignored by kterm by default, and the Home and End keys of both keypads.
• Note: Mouse wheel scroll navigation in menus does not work seamlessly in kterm because kterm sends incorrect escape sequences on mouse wheel scrolling.
• Note: By default (i.e., without explicit -km option or corresponding *vt100.kanjiMode resource configured), kterm runs in ISO 2022 mode (yes, it does indeed) which is not supported by mined.

hanterm

• CJK display is buggy at the line beginning or after a Tab, often only the second byte of the character code is displayed as an ASCII character instead of displaying the complete CJK character.
• Character attributes in hanterm used to be all mapped to reverse, so there was a workaround to enable a visible position in the scrollbar which is displayed as blank space. The criteria for this workaround to apply are: CJK terminal (detected or configured), TERM=xterm, Korean encoding (UHC or Johab) configured with parameter or locale. Replaced to enable nicer colours in scrollbar. To reactivate workaround for older hanterm, set environment variable MINEDSCROLLFG="0".

KDE 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.
• The Mined runtime support library includes a configuration file konsole/xterm-modified.keytab which defines enhanced escape sequences for function keys and other modified keys in order to enable the functionality described in this manual. Unfortunately, the qt framework used by konsole inhibits the use of some keys and many key combinations.
• It is especially irritating that konsole disregards the middle keypad key ("5" in application mode) completely; so the mined HOP function has to be invoked by alternative means.
  As a remedy, the HOP function is also assigned to the "Menu" key (next to the "Windows" key on PC keyboards) by the configuration sample file konsole/xterm-modified.keytab; follow the installation instruction in that file and select the keyboard type it defines ("xterm with key modifiers") in konsole, "Settings" - "Keyboard" menu.
  Another remedy is to reassign the middle keypad key to the X key symbol Menu (using xmodmap); the script kp5 in the Mined runtime support library does this.

gnome-terminal

• The gnome-terminal uses right mouse click for its own terminal menu. To open a mined menu, use Ctrl-right-mouse-click.
• The gnome-terminal does not support modified keys (e.g. shifted keypad keys).
• The gnome-terminal captures a number of Alt-letter key combinations for its own menu access (which can however also be controlled with the mouse). To disable this unpleasant capturing, so e.g. mined can open its own menus with Alt-letter, configure gnome-terminal as follows:
  Open menu "Edit" - "Keyboard Shortcuts..." and check "Disable all menu access keys". Even then, however, F1 and Ctrl-F1 are suppressed by this quirky terminal.
• Mined implicitly assumes its -f option (for limited font usage with respect to graphic characters) when detecting gnome-terminal.

Mac OS X Terminal and others

• The Mac OS X Terminal app does not support mouse escape sequences. Preferably, use xterm or iTerm 2.
• In iTerm 2, enable mouse reporting in the settings menu Preferences - Profile - Terminal.
• If any Mac terminal (Terminal, xterm, iTerm 2) does not respond to the ESC key, it is likely to be captured by Speech Recognition. Disable Speech Recognition or try Ctrl-ESC.

Linux console

•

Mined detects F11, F12, Shift-F1...Shift-F8 properly (handling the shift of 2 applied by the Linux console to shifted function key codes compared with other terminals); further modified function keys are apparently not supported in the Linux console.

screen

Screen, like luit (see below), is a middle layer between the

actual terminal and the user terminal environment.
Running screen in a cygwin console produces initial garbage input in mined.
[Applies to older screen before version 4: Unfortunately, screen does not pass character width handling of its host terminal transparently to the application but apparently it maintains cursor position information with reference to the system-installed locale data. Which, however, does not always reflect the terminal properties! Yet mined detects the proper width properties of the host terminal (by using pass-through escape sequences of "screen") but only if the environment variable is set to "screen" (the default of "screen").]
Worse, however, screen apparently transforms cursor positioning commands from the application into relative cursor positioning towards the host terminal, which results in grossly incorrect display positionining if e.g. screen runs in a UTF-8 terminal but assumes an 8 bit terminal. Also, it interprets certain UTF-8 continuation bytes as control characters, so even using a workaround it is not possible to fix display for all cases. Mined applies a workaround to fix text positioning and menu display problems with screen. Another workaround fixes many cases of UTF-8 character display but cannot fix all (since screen captures the output of the 0x9C byte). It is recommended to invoke screen only with properly configured locale environment variables to match the actual terminal encoding.

mintty ("Cygwin Terminal")

Mintty is a Windows-based (non-X) terminal running with cygwin.

Mined auto-detects mintty and adjusts certain properties and features accordingly.

• Mined detects font changes that change the CJK ambiguous character width properties of the terminal when notified by mintty if running in UTF-8 mode.
• For good coverage of Unicode characters, recommended fonts for use with mintty are DejaVu Sans Mono, Lucida Console, Courier New, Andale Mono, Everson Mono, SimSun. Discouraged are Lucida Sans Typewriter, Letter Gothic, Courier, Monaco, and older MS CJK fonts, at least for their lack of (proper) graphic characters (for menu borders). Mined uses the glyph detection feature of mintty (since 0.9.9) to configure a nice set of useful line markers and menu graphics.
• If break interruption (Control-\ key) does not work on international keyboards (if AltGr is involved), use the special Control-Break keyboard function instead.
• Note: For right-to-left text editing, the bidi feature of mintty interferes with the scrollbar of mined; you may disable the scrollbar with -o to reduce visual confusion. (Context-dependent scrollbar display is planned for a later version.)
• Note: With the command scripts wined or wined.bat, mined is invoked in a separate Windows terminal session, using mintty if available.
• Note: On some systems, mouse wheel scrolling does not work in mintty if the mintty scrollbar is enabled. It can be disabled in the mintty "Options..." menu, section "Window".
• Note: Mined temporarily disables mintty shortcut keys for Windows functions (like Alt-function keys, Alt-space, Alt-Enter) in order to use them itself. To toggle mintty full-screen mode, open the mintty menu with Shift-right mouse button, item "Fullscreen".
  (With mintty versions before 0.5.1, for proper usage of Unix-like keyboards functions, the following settings are recommended: In Options - Keys, disable the Shortcuts "Window commands" and "Copy and paste". In Options - Text, disable "Show bold as bright".)

Cygwin console

• The cygwin console terminal emulation does not support Shift-F1, Shift-F2 (which cannot be distinguished from F11, F12), Shift-F11, Shift-F12; Control or Alt modified function keys are supported beginning cygwin 1.7.2.
• Mined detects UTF-8 mode of cygwin 1.7 console (by LC_*/LANG setting or for cygwin 1.7 beta by CYGWIN containing "codepage:utf8").
  Note: After rlogin from this console, UTF-8 indication has to be ensured explicitly, e.g. by environment setting, or by mined option +U.
• Note: Cygwin console in UTF-8 mode provides extended Unicode font support if you select "Lucida Console" or another TrueType font from its Properties menu.
• If the Windows program chcp.com is used within cygwin, and the console window is set up to use "Raster Fonts", non-ASCII characters may be mangled.
• Mouse coordinates are not properly reported with wheel scrolling in the cygwin console; for that reason, opening a menu with mouse scrolling does not work.
• See also README.cygwin for more detailed hints on weird details about the Windows console in different modes.
• See also PC terminals above.

Windows console window (DOS command prompt)

• The Windows console window is normally configured to run in CP850 encoding or other legacy encodings (depending on localized Windows configuration), it may also turn out to use CP437. Non-displayable characters are replaced as usual. The configured font may also affect the effective display character set.
• However, if running a cygwin application (like the cygwin version of mined) from a Windows console, the cygwin emulated terminal encoding applies instead, e.g. UTF-8.
• Note: The (djgpp-compiled) DOS version of mined automatically adjusts to the selected console codepage (e.g. using the chcp command), it is advisable to set up the console windows to use "Raster Fonts" if this is used. With the cygwin-compiled version, on the other hand, using a TrueType font is more stable with respect to character set problems.
• With the djgpp-compiled version apparently there is a Ctrl-C problem on older Windows versions. Every first Ctrl-C will display ^C on the screen at the current position without mined noticing it, while every second Ctrl-C will be passed to mined. This problem does not occur on Windows XP. It does occur on Windows ME in a Windows console window. It does not occur with the cygwin-compiled version.
• See also PC terminals above.

Windows PowerShell

•

→NEW→ Mined detects a Windows PowerShell window and adjusts to its limitations.

Poderosa

• This Windows terminal emulator can be used for UTF-8 editing. To ensure proper function, do not use Terminal Type "kterm" or Encoding "euc-jp" or "shift-jis"
• Mined auto-detection and terminal initialization can cause Poderosa to display warning popups. To avoid them, Select Tools - Options... - Terminal; for "Behavior in case of unexpected chars", disable "Display a message box". If you get a notice "Failed to decode characters by the current encoding utf-8.", click "Do not display this message from next time".
• Poderosa does not provide mouse support for applications.

Terminator

• In Edit - Preferences, enable "Use alt key as meta key".
• Terminator does not provide mouse support for applications.

PuTTY

•

This Windows terminal emulation for remote login provides various keyboard (esp. keypad and function key) assignment emulations. In SCO mode, shifted function keys are different from those of xterm SCO function key emulation; both are supported.

Better Terminal and Terminal Emulator (Android)

• There are lots of deficiencies in screen control; mined adapts to Better Terminal.
• There are lots of deficiencies in using a real keyboard.
• To use a real keyboard, in the terminal settings, map Control to Left Alt key.

luit

•

The locale support add-on for text terminals luit which applies encoding transformations (e.g. with LC_ALL=zh_CN.gb18030) often maps characters incorrectly, including using the wrong cell width.

DECterm

On a VMS system, a DECterm window should be started with:

CREATE /TERMINAL /DETACH

• Mined cannot disable flow control option (terminal using ^S and ^Q characters) despite its handling of the TTSYNC and HOSTSYNC terminal driver options. To make them usable, DECterm needs to be configured manually: Options menu - Keyboard... - disable Ctrl-Q, Ctrl-S = Hold; then Options - Save Options.
• On a remote DECterm, numeric keypad and function keys may not work properly without additional X configuration (xmodmap). Also the AltGr key does not work, making some characters unreachable on international keyboards.
• For VT100 graphics characters (used for menu borders), the DECtech fonts (X fonts with -DEC-DECtech encoding) need to be installed on the X server. If the Cygwin/X server is used, the font-bitstream-dpi* packages should be installed to this aim.

dtterm

• With the SCO default font, dtterm does not display non-ASCII characters and even worse, they corrupt further display. Mined does not, however, set its screen encoding assumption to ASCII as dtterm behaves properly with all other fonts (e.g. 10x20, lucidasanstypewriter, courier).
• Home/End, PgUp/PgDn, and HOP keys need to be used with Shift.

SCO Caldera Linux (konsole and xterm)

•

Window size change signals don't seem to be supported.

Haiku Terminal

For a number of deficiencies of the Haiku Terminal application,

it is preferable to use xterm instead. Most notable are display problems with the VT Gothic font; use DejaVu Sans Mono instead.

• No wide characters and combining characters.
• No Alt-letter escape sequences.
• No modified function and cursor keys.
• Ignorance of middle keypad key.
• Cursor visibility problems (cursor colour vs. reverse mode).
• Wrong Control-space key (sends Control-C).
• No mouse controls for wheel scrolling.
• Unconforming mouse mode handling.

Work-around support to enable 8-bit character set on weird terminals

Concerning some especially stupid terminal drivers

Keyboard mapping / Input method preselection

Smart Quotes style configuration

Han info configuration

M

show Mandarin pronunciation

C

show Cantonese pronunciation

J

show Japanese pronunciation

S

show Sino-Japanese pronunciation

H

show Hangul pronunciation

K

show Korean pronunciation

V

show Vietnamese pronunciation

P

show Hanyu Pinlu pronunciation

Y

show Hanyu Pinyin pronunciation

X

show XHC Hanyu Pinyin 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

Common paste buffer configuration

Keypad configuration

Printing configuration

Display layout

Line ends

The indication of DOS line ends (CRLF) and Mac line ends (CR) may be configured with the variables MINEDDOSRET or MINEDUTFDOSRET, and MINEDMACRET or MINEDUTFMACRET, respectively. They are also distinguished by different colours.

Paragraph ends

Tab characters

Long lines

Unicode characters

Display mode of indicators

Display mode of menu borders

Status line highlighting

Scrollbar colour

Menu colour and border style

Combining character display

Interactive Help access

Mined compile-time configuration

Script highlighting

Encodings and Encoding menu

Encodings recognised by locale names

Keyboard mapping (Input method)

Environment variables to configure Printing

MINEDPRINT

Print command to use instead of uprint; the value must contain the string '%s' (quoting recommended) to insert the file name.

FONT

Name of a font file, e.g. LucidaBrightRegular or bodoni.ttf for use with uprint/uniprint (the file must reside in the configured font path), or name of a font as specified with fontconfig (in $HOME/.fonts.conf or /etc/fonts/fonts.conf) for use with uprint/paps.

FONTPATH

Directory search path (separate directory names with ":") for use with uprint/uniprint which uses Truetype fonts.

FONTSIZE

Font size to be used with uprint (paps or uniprint).

LPR

Print spooling command to be used by uprint (or mined itself if uprint does not work) instead of the system-specific print spooling command (e.g. lpr).

PRINTER

Name of printer to spool to.

Unix

$MINEDDIR

directory in which the Mined runtime support library is installed, including the help file mined.hlp and the printing script uprint

mined.hlp

help file for interactive hints (F1 commands); mined looks for the file in $MINEDDIR/help, $0, and a number of other typical directories where program support files are installed on various systems

$MINEDTMP

directory for auxiliary files, first attempt Using this variable and $MINEDUSER (see below), you can establish copy and paste among machines that share network directories but are normally configured to use separate (usually local) temporary directories.

$TMPDIR

directory for auxiliary files, next attempt

$TMP

directory for auxiliary files, next attempt

$TEMP

directory for auxiliary files, next attempt

/usr/tmp

directory for auxiliary files, next attempt

/tmp

directory for auxiliary files, next attempt

Note: $MINEDUSER

user name assumed instead of $USER for building auxiliary file names; using this, common copy-and-paste buffers can be used on a network file system from different machines where the user possibly has different user names

$HOME/.fonts.conf

fonts configuration file for use with uprint/paps; for description, see http://fontconfig.org/fontconfig-user.html or man fonts.conf

minedbuf.< USER >.< PID >.< NN >

temporary file for paste buffer; USER is either $MINEDUSER or $USER

minedbuf.< USER >

file for inter-window paste buffer; USER is either $MINEDUSER or $USER; see descriptions of $MINEDTMP and $MINEDUSER above for how to set up a common inter-window paste buffer in a heterogeneous network

minedrecover.< USER >.< PID >

panic file to rescue text in case of crash or external signal caught

VMS

SYS$MINEDTMP:$MINED$user_BUF.pid_nn

paste buffer

SYS$MINEDTMP:$MINEDBUF$user

inter-window paste buffer

SYS$SCRATCH:$MINEDRECOVER$user$pid

panic file

SYS$SCRATCH:$MINEDPRINT$user$pid$n.lis

print spool file

MINED$HELP

help file (may be configured as a logical name)

If SYS$MINEDTMP is not available,

SYS$SCRATCH is used instead. If SYS$SCRATCH is not available, SYS$LOGIN is used instead.

MSDOS / Windows

%MINEDDIR%\help\mined.hlp

help file, first attempt (to find it)

mined.hlp (in mined program directory)

help file, next attempt

%MINEDTMP%\minedbuf.nn

paste buffer

%MINEDTMP%\minedbuf

inter-window paste buffer

%MINEDTMP%\minedbuf.%MINEDUSER%

inter-window paste buffer, as configured to use the same file as other mined versions in a heterogeneous network; note, however, that %MINEDUSER% will be shortened to 3 characters in pure DOS

%MINEDTMP%\minedsv_.*

panic file

If %MINEDTMP% is not available,

%TEMP% or %TMP% or \ are used.

Mailing list

Acknowledgements