Command line options
- Mined can be invoked
- with or without list of file names
- reading from a pipe (reading text from standard input)
- writing into a pipe (writing edited text to standard output)
- using a script that starts it in a new window
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) andcmd2(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
wmined ...- (on Windows) starts a new rxvt terminal in stand-alone mode (i.e. without needing X windows), using Windows look-and-feel, and invokes mined in it; the terminal is configured to run in UTF-8 mode which may work with a future version of rxvt (currently ignored)
Startup options
+number- Mined positions to the given line number.
+/expr- Mined initially searches for the given search expression.
-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.
++- End of options; subsequent file name can start with
"
-" or "+". +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.
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
-Ror+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
-ror+r. +R- Recognise Mac line ends (CR) and indicate them on display;
nothing is transformed with this option.
Can be combined with
-ror+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
-uuand 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.
(Used to be
+uwhich is still valid for compatibility.)
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 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 Mode indication flags listing.
-E=charmap (character set)- Where charmap is a character encoding name (as
reported by the
locale charmapcommand): 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 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.
-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).
+K(input method handling)- (Obsolete with 2000.15 since keyboard mapping is always enabled by default.) Enable keyboard mappings (input methods) even in 8-bit terminal or when editing an 8-bit encoded file; the characters thus entered will mostly only be displayed by substitute indications (as most characters anyway when editing files in an 8-bit terminal not matching the character set).
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
-Uoption or environment setting). In the latter case,-Udeselects 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
-Uor+Uneeds 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/S/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 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 charmapcommand): 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 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
-Eoption (with a single-letter CJK tag) effectively into a combined-Eand+Eoption. 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
+CCand 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.minedin the Mined runtime support library.)
Information display
+?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:
- s: Unicode script
- n: Unicode character name
- d: Unicode character decomposition
- m: mined input mnemonics available for this character
+?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.
(On by default since mined 2000.15.)
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
-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.
Appearance
-QX- Select menu border style, where X is one of
- s: simple border,
- r: rounded corners,
- f: fat border,
- d: double border,
- a: ASCII border (can be combined with another option
-Qsor-Qr), - v: VT100 alternate character set graphics border,
- @: reverse blank border (deprecated),
- 1: (or another digit) add a margin between menu
borders and contents (can be combined with any
other
-Qoption), - Q: stylish selection bar for navigating menu items, see image
(can be combined with another option
-Qsor-Qror-Qfor-Qd). - q: disable stylish selection bar
-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 block 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.
+F-
Revert the effect of one
-Foption (e.g. preconfigured in the environment variable MINED) 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
-4- Set Tab size to 4 rather than 8. The effective Tab size can also be toggled while editing with the ESC T command.
-8- Set Tab size to 8. (May be used on command line to override Tab size being set to 4 be MINED environment variable.) The effective Tab size can also be toggled while editing with the ESC T command.
-+4- Set spacing Tab with size 4; 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 also be toggled while editing with the ESC T command. Tab expansion mode can also be toggled while editing with the HOP ESC T command.
-+8- Set spacing Tab with size 8; 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 also be toggled while editing with the ESC T command. Tab expansion mode can also be toggled while editing with the HOP ESC T command.
-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.
-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.
-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.
-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).
-W- Select WordStar mode. This configures WordStar command key layout and enables many functions of the ^K, ^O, and ^Q menus.
-B- Enforce the Del control character to delete left, Backspace to move left. Should normally not be used, see "Automatic backspace mode adaptation" below.
+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.
-k- Assign the more usual functions "goto line beginning",
"goto line end" and "delete character" to the Home,
End and Del keys of the right keypad ("numeric keypad").
The (assumedly more useful) mined default is to assign
the frequently used paste buffer functions (mark,
copy, cut) 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 is assigned the respective other functions 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. +*-
Enable enhanced mouse control:
Menu items can be navigated with the mouse without
button pressed.
Enabled by default for MinTTY, xterm, gnome-terminal.
-*- Disable enhanced mouse control (if enabled by default or by previous option), otherwise disable mouse support altogether.
-**- Disable mouse support altogether.
-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.
-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- Toggles 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.
(Not really tested as there doesn't seem to exist a
terminal emulator that handles proportional fonts and
cursor positioning correctly.)
All options are also looked for in the environment variable MINED.
It may be desirable to distinguish characters in different
script by displaying their glyphs in different colours.
(This especially allows to distinguish easier between
similar glyphs as they occur in Latin/Greek/Cyrillic scripts.)