Minimum Profit Configuration Directives
The following configuration values can be set in the configuration files,
executed from the command line or from the Execute MPSL code...
option in
the Edit
menu. So, for example, if you always want automatic indentation,
word wrapping at column 75 and a special ispell command, you can add the
following MPSL code to ~/.mp.mpsl
or /etc/mp.mpsl
:
mp.config.auto_indent = 1; mp.config.word_wrap = 75; mp.config.ispell_cmd = "aspell -a";
All configuration variables are in the mp.config
hash.
mp.config.ansi_rgbcolor
If set to non-zero, the ANSI driver shall use the GUI colors instead of the text ones. Obviously, it should only be used in terminals that support RGB color mode; almost all modern terminal emulators do (default: 0, use standard text colors).
mp.config.auto_indent
Set to 1 if automatic indentation is wanted (default: 0, no indentation).
mp.config.auto_sessions
Set to 1 to automatically load / save sessions on startup / exit (default: 0, no automatic sessions).
mp.config.case_sensitive_search
Set to 1 if searches are to be done in a case-sensitive way (default: 1).
mp.config.ctags_cmd
The external command to be executed when a tag search is requested. By
default is ctags *
. Other useful value is ctags -R
, that search for
tags recursively in subdirectories.
mp.config.dark_mode
Selects dark (1) or light (0) color modes (default: 1).
mp.config.double_page
Set the screen width (in characters) where the double page mode is automatically enabled. If no double page mode is desired, set it to 0 (default: 120).
mp.config.dynamic_tabs
Set to 1 if tab columns are to be inferred from the previous line (default: 0).
mp.config.emacs_scrolling
Set to 1 to select scrolling by half screen jumps instead of line-by-line (default: 0).
mp.config.eol
The end of line character sequence. By default is "\n" on Unix/Linux systems or "\r\n" on MSDOS / Windows.
mp.config.font_face
The font face to be used in GUI environments. By default it's "Mono" on Qt4, GTK and KDE4 and "Lucida Console" on MS Windows.
mp.config.font_size
The font size to be used in GUI environments. By defaults it's 12 on Qt4, KDE and GTK and 10 on MS Windows.
mp.config.font_weight
The font weight to be used in GUI environments. It's a floating point number from 0 to 1, where lower values give thinner fonts and higher values bolder ones. The special value 0 (default) means don't care about the font weight.
mp.config.global_replace
Set to 1 if the replace operation must be done to the end of the file (default: 0, do it only once).
mp.config.html_title
The title to be used when exporting a mptxt file to HTML (default: the output file name).
mp.config.hw_cursor
In text modes, moves the hardware terminal cursor to the position of the file editing cursor. Some terminals interfere with the cursor color used internally (default: 0).
mp.config.ispell_cmd
The external command to be executed as a pipe for spellchecking. It must be
compatible with ispell
, and by default it's "ispell -a". Other useful
values are "aspell -a", if you have aspell
installed (a better
alternative), or "ispell -a -Tutf8", if you happen to be in an UTF-8
environment and must use ispell
.
mp.config.keep_eol
If this option is set, each document will keep its original end of line
sequence when saved. If not set, the string set in mp.config.eol
will be
used regardless of the original one (default: 1).
mp.config.local_sessions
Set to 1 to store session information in the currently working directory instead of in the home directory (default: 0, save sessions in the home directory).
mp.config.make_opts
Additional flags for the make
program (if you have a 4-core CPU, it's
useful to set it as -j 4
) (default: '').
mp.config.mark_eol
If set to 1, end-of-line characters are marked with a special character, instead of being invisible (default: 0, don't mark).
mp.config.maximize
Set to 1 if the GUI window must open maximized (default: 0, no maximize).
mp.config.move_seek_to_line
The line number to be set the cursor to when a successful search is hit (default: 5). If set to 0, the position is not touched.
mp.config.no_text_mouse
Set to 1 to disable mouse support in Curses and win32 console modes (default: 0).
mp.config.preread_lines
The number of lines to read above the first visible line to calculate syntax highlight in blocks (default: 60 lines). There is probably no need to change this, unless using very big comment blocks or the like.
mp.config.recursive_grep
If set, the grep
action is done recursively (default: 0).
mp.config.rtf_font_face
Font face to be used in RTF exporting as normal text. Default is "Times New Roman".
mp.config.rtf_font_size
Font size to be used in RTF exporting for normal text. Default is 12.
mp.config.rtf_mono_font_face
Font face to be used in RTF exporting as verbatim text. Default is "Courier New".
mp.config.rtf_mono_font_size
Font size to be used in RTF exporting for verbatim text. Default is 10.
mp.config.rtf_style_center
RTF export code for centered paragraphs.
mp.config.rtf_style_default
RTF export code for default paragraphs.
mp.config.rtf_style_first
RTF export code for first paragraphs.
mp.config.rtf_style_para
RTF export code for normal paragraphs.
mp.config.rtf_style_verbatim
RTF export code for verbatim paragraphs.
mp.config.rw_max_dist
Used by the seek_repeated_word
action as the maximum distance two
similar words must be separated apart to be considered a repetition
(default: 40 words).
mp.config.rw_num_chars
Used by the seek_repeated_word
action as the number of characters
(from the start or the end) two words must match to be considered
similar and taken into account for repetitions (default: 4
characters).
mp.config.show_line_numbers
Set to 1 to show line numbers to the left of the document (default: 0).
mp.config.smart_bol
If set, the move_bol
action will first move the cursor to the
first non-whitespace character on the line. If the cursor is
already on the first non-whitespace character the the cursor will
move to column position 1 (default: 1).
mp.config.status_format
The status format string to be shown in the status line. By default it's "%m%n %x,%y [%l] %R%O %s %e %t", where each percent-value means:
Tag | Description |
%V | Current MP version |
%m | Modify flag (asterisk or the empty string). If there are pending disk operations (e.g. the file is still being loaded or saved) an exclamation mark is shown instead |
%x | X coordinate (column) |
%y | Y coordinate (line) |
%l | Total number of lines in current document |
%R | Macro recording flag (R or the empty string) |
%O | Overwrite flag (O or the empty string if inserting) |
%s | Syntax highlight in use |
%t | Tag target over the cursor, or the empty string if none |
%n | Document name |
%e | Encoding used in the file, or the empty string if using current locale |
%w | Number of words in the current document (or in the current selection, if any). Slow in big documents. |
%u | Unicode codepoint of the character under the cursor |
%W | Visuap wrapping on flag (W or the empty string) |
%% | A percent sign |
mp.config.tabs_as_spaces
Set to 1 if tabs must be converted to spaces (default: 0, no conversion).
mp.config.tab_size
Tab size in column spaces (default: 8).
mp.config.time_stamp_format
The format for the time stamp (default: "%a, %d %b %Y %H:%M:%S %z").
mp.config.troff_font_size
The font size when exporting an mptxt file to troff.
mp.config.troff_page_height
The page height when exporting an mptxt file to troff.
mp.config.undo_levels
Maximum number of undo levels per document (default: 100).
mp.config.unlink
Set to 1 if the file must be unlinked just before being overwritten (default: 1, do it).
mp.config.use_unicode
If set to nonzero, extended Unicode characters are used in several places like text menus, special characters, games, etc. If set to 0, uses only ASCII or ISO8859-1 characters (default: 1).
mp.config.visual_wrap
If set to nonzero, lines longer that the window or terminal are wrapped automatically to the next line (showing a special mark that a special, soft-break happened). If set to 0, long lines are cropped beyond the right margin (default: 0).
mp.config.word_wrap
The column where word wrapping occurs (default: 0, no word wrapping).
ttcdt <dev@triptico.com>