doc/mp_actions.txt

   1 Minimum Profit Action Reference
   2 ===============================
   3
   4 Minimum Profit _actions_ are editor commands that can be directly
   5 bound to the menu or a key.
   6
   7 about
   8 -----
   9
  10 _About..._
  11
  12 Shows the "About Minimum Profit" information.
  13
  14 build
  15 -----
  16
  17 _Build project..._ (`f2')
  18
  19 Invokes the building of a Make project. If the `Makefile' file exists in the
  20 working directory, all targets are extracted from it and shown in a list dialog
  21 for the user to select one. The selected one will be called as the only argument
  22 for the `make' program and its output read. All output will be catched and shown
  23 in a read-only document. Compiler errors and warnings will be highlighted and
  24 can be navigated by using the `seek_next' and `seek_prev' actions (keys `f3' and
  25 `ctrl-f3'). The `open_under_cursor' action can be used to edit each error or warning.
  26
  27 close
  28 -----
  29
  30 _Close_ (`ctrl-w')
  31
  32 Closes the active document. If there are unsaved changes, a confirmation dialog
  33 is shown.
  34
  35 close_all
  36 ---------
  37
  38 _Close all_
  39
  40 Closes all open documents.
  41
  42 complete
  43 --------
  44
  45 _Complete..._ (`ctrl-u')
  46
  47 Takes the (probably partial) word under the cursor and searches for words in
  48 the current document that start with it. If more than one is found, a list dialog
  49 is shown to make a selection. The word will be replaced with the selected one.
  50
  51 complete_symbol
  52 ---------------
  53
  54 _Symbol completion..._
  55
  56 Uses a similar approach than the `complete' action, but using the current _tags_
  57 file as the completion list. If no _tags_ file exist in the working directory,
  58 the *ctags* program is invoked to build it.
  59
  60 For other uses of the _tags_ file, see `find_tag'.
  61
  62 copy_mark
  63 ---------
  64
  65 _Copy block_ (`ctrl-c')
  66
  67 Copies the currently selected block to the clipboard.
  68
  69 cut_mark
  70 --------
  71
  72 _Cut block_ (`ctrl-x')
  73
  74 Copies the currently selected block to the clipboard and deletes the block.
  75
  76 delete
  77 ------
  78
  79 _Delete character_ (`delete')
  80
  81 Delete the character over the cursor.
  82
  83 delete_left
  84 -----------
  85
  86 _Delete character to the left_ (`backspace')
  87
  88 Deletes the character to the left of the cursor.
  89
  90 delete_line
  91 -----------
  92
  93 _Delete line_ (`ctrl-y')
  94
  95 Deletes the line under the cursor.
  96
  97 document_list
  98 -------------
  99
 100 _Document list_
 101
 102 Shows a dialog with the list of currently open documents. The list cursor will
 103 be over the active one and the documents with pending modifications will be
 104 prefixed with an asterisk. Selecting a different one will make it become the
 105 active.
 106
 107 encoding
 108 --------
 109
 110 _Set charset encoding..._
 111
 112 Shows a dialog asking for a string describing the charset encoding that will
 113 be used when saving or opening new documents. If an empty string is entered,
 114 the current locale will be used. the following set of character encodings are
 115 always available:
 116
 117  * utf8.
 118    Aliases are utf-8, UTF8 and UTF-8.
 119  * iso8859-1.
 120    Aliases are iso-8859-1, ISO-8859-1, ISO8859-1, latin1, latin-1, LATIN1 and LATIN-1.
 121  * utf16 (with endianness detection on input and local endianness on output).
 122    Aliases are utf-16, UTF16, UTF-16, ucs-2, UCS2, UCS-2.
 123  * utf16be (big endian).
 124    Aliases are utf-16be, UTF16BE, UTF-16BE, ucs2be, UCS2BE, ucs-2be and UCS-2BE.
 125  * utf16le (little endian).
 126    Aliases are utf-16le, UTF16LE, UTF-16LE, ucs2le, UCS2LE, ucs-2le and UCS-2LE.
 127  * utf32 (with endianness detection on input and local endianness on output).
 128    Aliases are utf-32, UTF32, UTF-32, ucs-4, ucs4, UCS-4 and UCS4.
 129  * utf32be (big endian).
 130    Aliases are utf-32be, UTF32BE, UTF-32BE, ucs4be, UCS4BE, ucs-4be and UCS-4BE.
 131  * utf32le (little endian).
 132    Aliases are utf-42le, UTF42LE, UTF-42LE, ucs4le, UCS4LE, ucs-4le and UCS-4LE.
 133
 134 If the 'iconv' library is available, there can be many more encodings.
 135
 136 eval
 137 ----
 138
 139 _Execute MPSL code..._ (`escape')
 140
 141 Shows a dialog asking for a string of MPSL code that will be executed.
 142
 143 eval_doc
 144 --------
 145
 146 _Execute document as MPSL_
 147
 148 Executes the active document as MPSL code.
 149
 150 exec_command
 151 ------------
 152
 153 _Run system command..._
 154
 155 Shows a dialog asking for a system command to execute. If the command is
 156 preceded by the pipe symbol (|), the active document will be fed as the
 157 standard input of the command; otherwise, the standard output of the command
 158 will be inserted in the cursor position.
 159
 160 exit
 161 ----
 162
 163 _Exit_ (`ctrl-q')
 164
 165 Closes all documents and exists Minimum Profit.
 166
 167 find_tag
 168 --------
 169
 170 _Search tag..._ (`ctrl-t')
 171
 172 Shows a dialog asking for a tag to search. The _tags_ file will be read from
 173 the working directory and the tag searched there; all symbols starting with it
 174 will be shown in a list dialog. When selecting a tag from that list, the file
 175 containing it will be open and the cursor moved to where the tag is.
 176 This is a useful way of finding where a function or variable is defined.
 177
 178 If no _tags_ file exist in the working directory, the *ctags* program is
 179 invoked to build it.
 180
 181 For other uses of the _tags_ file, see `complete_symbol'.
 182
 183 goto
 184 ----
 185
 186 _Go to line..._ (`ctrl-g')
 187
 188 Shows a dialog asking for a line number. If accepted, the current document
 189 cursor will move to that line (if existent).
 190
 191 grep
 192 ----
 193
 194 _Grep (find inside) files..._
 195
 196 Shows a dialog asking for a string to be searched, and an optional spec of
 197 files to search the string in. If no spec is given, all files in the working
 198 directory are scanned. Matches are shown in a read-only document, and each
 199 match can be directly open by using the 'open_under_cursor' action.
 200
 201 This is a useful way to find where a function or variable is used.
 202
 203 help
 204 ----
 205
 206 _Help on word over cursor_ (`f1')
 207
 208 Picks the word under the cursor and asks the underlying system for help
 209 about that term.
 210
 211 ignore_last_misspell
 212 --------------------
 213
 214 _Ignore last misspelled word_
 215
 216 Ignores the last misspelled word found by `seek_misspelled' by adding it
 217 to a whitelist so it won't be found again.
 218
 219 insert_line
 220 -----------
 221
 222 _Insert line_ (`enter')
 223
 224 Inserts a new line. If the cursor is in the middle of a line,
 225 it's split in two.
 226
 227 insert_space
 228 ------------
 229
 230 _Insert space_ (`space')
 231
 232 Inserts a space, triggering word wrapping, if active.
 233
 234 insert_tab
 235 ----------
 236
 237 _Insert tab_ (`tab')
 238
 239 Inserts a tabulator, triggering word wrapping, if active.
 240
 241 insert_template
 242 ---------------
 243
 244 _Insert template..._
 245
 246 Shows a list dialog with the names of the templates for the user to
 247 select one, that will be inserted in the cursor position.
 248
 249 join_paragraph
 250 --------------
 251
 252 _Join a paragraph in one line_
 253
 254 Joins the text from the cursor position to the next empty line as one
 255 paragraph.
 256
 257 line_options
 258 ------------
 259
 260 _Line options..._
 261
 262 Shows a dialog asking for line configuration options, like word wrapping,
 263 end of line string, etc.
 264
 265 load_session
 266 ------------
 267
 268 _Load session_
 269
 270 Loads a session, previously saved by `save_session'.
 271
 272 mark
 273 ----
 274
 275 _Mark beginning/end of block_ (`f9')
 276
 277 Marks the beginning or the end of the block.
 278
 279 mark_vertical
 280 -------------
 281
 282 _Mark vertical block_ (`ctrl-b')
 283
 284 Marks the beginning or the end of a vertical (also known as
 285 rectangular) block.
 286
 287 menu
 288 ----
 289
 290 _Menu_ (`ctrl-a')
 291
 292 Calls the menu.
 293
 294 mouse_drag_mark
 295 ---------------
 296
 297 _Mark using mouse dragging_ (`mouse-drag')
 298
 299 This action is called by the underlying driver when the mouse is used to drag
 300 over text. It must not be called nor bound to a key.
 301
 302 move_bof
 303 --------
 304
 305 _Beginning of document_ (`ctrl-home')
 306
 307 Moves the cursor to the beginning of the document (first line, first column).
 308
 309 move_bol
 310 --------
 311
 312 _Beginning of line_ (`home')
 313
 314 Moves the cursor to the beginning of the current line (first column).
 315
 316 move_down
 317 ---------
 318
 319 _Line down_ (`cursor-down')
 320
 321 Moves the cursor to the next line.
 322
 323 move_eof
 324 --------
 325
 326 _End of document_ (`ctrl-end')
 327
 328 Moves the cursor to the last line of the document.
 329
 330 move_eol
 331 --------
 332
 333 _End of line_ (`end')
 334
 335 Moves the cursor to the end of the current line.
 336
 337 move_left
 338 ---------
 339
 340 _Character left_ (`cursor-left')
 341
 342 Moves the cursor one character to the left. If it's in the beginning of
 343 a line, moves to the last character of the previous line.
 344
 345 move_mouse_wheel_down
 346 ---------------------
 347
 348 _Mouse wheel down_ (`mouse-wheel-down')
 349
 350 Moves the cursor four lines down.
 351
 352 move_mouse_wheel_up
 353 -------------------
 354
 355 _Mouse wheel up_ (`mouse-wheel-up')
 356
 357 Moves the cursor four lines up.
 358
 359 move_pgdn
 360 ---------
 361
 362 _Page down_ (`page-down')
 363
 364 Moves the cursor a page down.
 365
 366 move_pgup
 367 ---------
 368
 369 _Page up_ (`page-up')
 370
 371 Moves the cursor a page up.
 372
 373 move_right
 374 ----------
 375
 376 _Character right_ (`cursor-right')
 377
 378 Moves the cursor one character to the right. If it's over the end of
 379 the line, moves to the first character of the next line.
 380
 381 move_to_mouse_position
 382 ----------------------
 383
 384 _Move cursor to mouse click_ (`mouse_left_button', `mouse_right_button', `mouse-middle-button')
 385
 386 Moves the cursor to where the mouse is. This action is called by the
 387 underlying system and must not be directly called nor bound to a key.
 388
 389 move_up
 390 -------
 391
 392 _Line up_ (`cursor-up')
 393
 394 Moves the cursor to the previous line.
 395
 396 move_word_left
 397 --------------
 398
 399 _Word left_ (`ctrl-cursor-left')
 400
 401 Moves the cursor to the beginning of the previous word.
 402
 403 move_word_right
 404 ---------------
 405
 406 _Word right_ (`ctrl-cursor-right')
 407
 408 Moves the cursor to the beginning of the next word.
 409
 410 new
 411 ---
 412
 413 _New_
 414
 415 Creates a new unnamed document.
 416
 417 next
 418 ----
 419
 420 _Next_ (`ctrl-n')
 421
 422 Select the next document as the active one. The list of documents
 423 is circular; if the active one is the last, the first one is selected.
 424
 425 open
 426 ----
 427
 428 _Open..._ (`ctrl-o')
 429
 430 Shows a dialog to open a file. Its behaviour and look are system-dependent.
 431
 432 If the document to be opened is password-protected, a dialog asking for the
 433 password will also appear.
 434
 435 open_config_file
 436 ----------------
 437
 438 _Edit configuration file_
 439
 440 Opens the user configuration file for editing. It doesn't have to exist.
 441
 442 open_templates_file
 443 -------------------
 444
 445 _Edit templates file_
 446
 447 Opens the templates file for edition. Templates defined here can be later
 448 inserted by calling `insert_template'. See the `mp_templates.sample' file
 449 included in the documentation for an example of the accepted format.
 450
 451 open_under_cursor
 452 -----------------
 453
 454 _Open file under cursor_ (`ctrl-enter')
 455
 456 Picks the word in the current document under the cursor, accepts it as
 457 a document name and tries to open it. If it's in the format string:number,
 458 is accepted as a file name and a line number.
 459
 460 paste_mark
 461 ----------
 462
 463 _Paste block_ (`ctrl-v')
 464
 465 Pastes the text in the clipboard into the cursor position.
 466
 467 play_macro
 468 ----------
 469
 470 _Play macro_ (`f7')
 471
 472 Replays all keystrokes recorded during the previous _learning mode_,
 473 activated by a call to `record_macro'.
 474
 475 prev
 476 ----
 477
 478 _Previous_
 479
 480 Select the previous document as the active one. The list of documents
 481 is circular; if the active one is the first, the last one is selected.
 482
 483 record_macro
 484 ------------
 485
 486 _Record macro_ (`f10')
 487
 488 Toggles _learning mode_. When active, all keystrokes are recorded to
 489 further execute them by a call to `play_macro'.
 490
 491 redo
 492 ----
 493
 494 _Redo_
 495
 496 Redoes the previously undone operation, if any.
 497
 498 repeated_words_options
 499 ----------------------
 500
 501 _Repeated words options..._
 502
 503 Sets the options for the `seek_repeated_word' action.
 504
 505 replace
 506 -------
 507
 508 _Replace..._ (`ctrl-r')
 509
 510 Shows the search and replace dialog box.
 511
 512 revert
 513 ------
 514
 515 _Revert_
 516
 517 Reverts the active document to the state on disk.
 518
 519 save
 520 ----
 521
 522 _Save..._ (`ctrl-s')
 523
 524 Saves the active document. If it's unnamed, `save_as' is called instead.
 525
 526 save_as
 527 -------
 528
 529 _Save as..._
 530
 531 Shows a dialog asking for a file name to save the current document as.
 532 Its behaviour and look are system-dependent.
 533
 534 save_session
 535 ------------
 536
 537 _Save session_
 538
 539 Saves all documents and its positions as a session to be later loaded
 540 by `load_session'.
 541
 542 section_list
 543 ------------
 544
 545 _Section list..._ (`ctrl-d')
 546
 547 Shows a list with the sections found in the current document. Selecting
 548 one of them moves the cursor there.
 549
 550 seek
 551 ----
 552
 553 _Search text..._ (`ctrl-f')
 554
 555 Shows the search text dialog.
 556
 557 seek_misspelled
 558 ---------------
 559
 560 _Search misspelled word_ (`f5')
 561
 562 Searches for the next misspelled word in the current document. If one
 563 is found, the cursor is moved there. If it's a false positive, the
 564 `ignore_last_misspell' action can be called to add the recently found
 565 word to a whitelist so it won't be found again.
 566
 567 seek_next
 568 ---------
 569
 570 _Search next_ (`f3')
 571
 572 Searches the next occurrence of the string entered by the `seek' action.
 573
 574 seek_next_char
 575 --------------
 576
 577 _Move to next instance of current char_ (`ctrl-page-down')
 578
 579 Searches for the next occurrence of the char under the cursor. This is
 580 useful, for instance, to jump to the next paren or brace.
 581
 582 seek_prev
 583 ---------
 584
 585 _Search previous_ (`ctrl-f3')
 586
 587 Same as `seek_next', but searching backwards.
 588
 589 seek_prev_char
 590 --------------
 591
 592 _Move to previous instance of current char_ (`ctrl-page-up')
 593
 594 Searches for the previous occurrence of the char under the cursor. This is
 595 useful, for instance, to jump to the previous paren or brace.
 596
 597 seek_repeated_word
 598 ------------------
 599
 600 _Search repeated word_ (`f6')
 601
 602 Searches for repeated words. Controlled by the configuration directives
 603 `mp.config.rw_num_chars' and `mp.config.rw_max_dist'. A searching is done
 604 from the cursor position trying to find two words nearer from each
 605 other up to a maximum of the specified distance and that start or
 606 end with the same letters. If a pair is found, the words are
 607 highlighted as spelling errors and the cursor moved over the first
 608 one. Otherwise, a message marking the end is shown and nothing is done.
 609
 610 set_password
 611 ------------
 612
 613 _Password protect..._
 614
 615 Shows a dialog asking (twice) for a password to protect the active document with
 616 when it's saved. From that moment on, each time the document is tried to open
 617 the password will be asked for.
 618
 619 Minimum Profit encrypts documents using a variant of the ARCFOUR algorithm.
 620
 621 sync
 622 ----
 623
 624 _Save modified texts_
 625
 626 Saves all texts with pending modifications.
 627
 628 tab_options
 629 -----------
 630
 631 _Tab options..._
 632
 633 Shows a dialog asking for tabulator configuration options, like tab size,
 634 convert to spaces, etc.
 635
 636 toggle_spellcheck
 637 -----------------
 638
 639 _Toggle spellchecking_
 640
 641 toggles spellchecking. When active, misspelled words will be shown underlined.
 642
 643 undo
 644 ----
 645
 646 _Undo_ (`ctrl-z')
 647
 648 Undoes the last operation.
 649
 650 unmark
 651 ------
 652
 653 _Unmark block_ (`f8')
 654
 655 Unmarks the selected block.
 656
 657 word_count
 658 ----------
 659
 660 _Count words_
 661
 662 Counts the number of words and lines in the active document.
 663
 664 word_wrap_paragraph
 665 -------------------
 666
 667 _Word-wrap a paragraph_ (`f4')
 668
 669 Rebuilds the text from the cursor position to the following empty
 670 line using the wordwrapping setup. Wordwrapping must be set (see
 671 `line_options').
 672
 673 zoom_in
 674 -------
 675
 676 _Bigger font_ (`f12')
 677
 678 Selects a bigger font (only for GUIs).
 679
 680 zoom_out
 681 --------
 682
 683 _Smaller font_ (`f11')
 684
 685 Selects a smaller font (only for GUIs).
 686
 687
 688 ----
 689 Angel Ortega <angel@triptico.com>