1 #LyX 2.4 created this file. For more info see https://www.lyx.org/
5 \save_transient_properties true
6 \origin /systemlyxdir/doc/
9 \renewcommand{\descriptionlabel}[1]{\hspace\labelsep\upshape\bfseries #1:}
10 \renewenvironment{description}{\list{}{%
11 \setlength{\itemsep}{-2pt}
12 \advance\leftmargini6\p@ \itemindent-12\p@
13 \labelwidth\z@ \let\makelabel\descriptionlabel}%
18 \use_default_options false
19 \maintain_unincluded_children no
27 \language_package default
28 \inputencoding auto-legacy
30 \font_roman "default" "default"
31 \font_sans "default" "default"
32 \font_typewriter "default" "default"
33 \font_math "auto" "auto"
34 \font_default_family default
35 \use_non_tex_fonts false
38 \font_typewriter_osf false
40 \font_sf_scale 100 100
41 \font_tt_scale 100 100
44 \default_output_format default
46 \bibtex_command default
47 \index_command default
48 \paperfontsize default
53 \use_package amsmath 1
54 \use_package amssymb 1
57 \use_package mathdots 0
58 \use_package mathtools 0
60 \use_package stackrel 0
61 \use_package stmaryrd 0
62 \use_package undertilde 0
64 \cite_engine_type default
68 \paperorientation portrait
84 \paragraph_separation indent
85 \paragraph_indentation default
87 \math_numbering_side default
91 \paperpagestyle default
92 \tracking_changes false
93 \postpone_fragile_content false
112 \begin_layout Section*
116 \begin_layout Standard
117 This manual documents the
118 \begin_inset Quotes eld
122 \begin_inset Quotes erd
126 These are commands that are used to make \SpecialChar LyX
127 perform specific actions.
129 itself uses these functions internally, and every internal action is
133 \begin_layout Standard
134 LFUNs are also used in the files that define keyboard shortcuts, menu or
136 So if you want to change\SpecialChar breakableslash
137 customize the user interface, you need to deal
139 Furthermore, external programs can use LFUNs to communicate with and
140 \begin_inset Quotes eld
144 \begin_inset Quotes erd
149 Finally, you can also issue LFUNs directly via the so called mini-buffer
150 which can be opened via
153 arg "command-execute"
159 \begin_layout Standard
160 In the following, all LFUNs are listed, categorized by function.
163 \begin_layout Section
164 Layout Functions (Font, Layout and Textclass related)
167 \begin_layout Subsection*
171 \begin_layout Description
172 Action Displays list of layout choices.
175 \begin_layout Description
176 Notion This LFUN opens the dropbox allowing for choice of layout.
179 \begin_layout Description
180 Syntax drop-layouts-choice
183 \begin_layout Subsection*
187 \begin_layout Description
188 Action Splits the current environment with a Separator.
191 \begin_layout Description
192 Syntax environment-split [before|outer|previous]
195 \begin_layout Description
196 Params outer: If this is given, LyX will split the outermost environment in the current nesting hierarchy.
197 \begin_inset Newline newline
200 previous: If this is given, LyX will split the environment in the previous paragraph (if there is one).
201 \begin_inset Newline newline
204 before: If this is given, the new environment will be appended rather than prepended.
207 \begin_layout Description
208 Origin spitz, 23 Dec 2012
211 \begin_layout Subsection*
215 \begin_layout Description
216 Action Toggles the bold font (selection-wise) using mathbf in math.
219 \begin_layout Description
223 \begin_layout Subsection*
227 \begin_layout Description
228 Action Toggles the bold font (selection-wise) using boldsymbol in math.
231 \begin_layout Description
232 Syntax font-boldsymbol
235 \begin_layout Subsection*
239 \begin_layout Description
240 Action Toggles xout (cross-through) in the font (selection-wise).
243 \begin_layout Description
247 \begin_layout Description
248 Origin uwestoehr, 4 April 2017
251 \begin_layout Subsection*
255 \begin_layout Description
256 Action Reverts the settings of the font to the default values (selection-wise).
259 \begin_layout Description
263 \begin_layout Subsection*
267 \begin_layout Description
268 Action Toggles the emphasis font style (selection-wise).
271 \begin_layout Description
275 \begin_layout Subsection*
279 \begin_layout Description
280 Action Toggles Fraktur family font (math-mode, selection-wise).
283 \begin_layout Description
287 \begin_layout Description
288 Origin vermeer, 10 Jan 2002
291 \begin_layout Subsection*
295 \begin_layout Description
296 Action Toggles Italics font shape (math-mode, selection-wise).
299 \begin_layout Description
303 \begin_layout Description
304 Origin vermeer, 10 Jan 2002
307 \begin_layout Subsection*
311 \begin_layout Description
312 Action Toggles nospellcheck status in the font (selection-wise).
315 \begin_layout Description
316 Syntax font-nospellcheck
319 \begin_layout Description
320 Origin spitz, 5 March 2021
323 \begin_layout Subsection*
327 \begin_layout Description
328 Action Toggles Noun text style font (selection-wise).
331 \begin_layout Description
335 \begin_layout Subsection*
339 \begin_layout Description
340 Action Toggles Roman family font (selection-wise).
343 \begin_layout Description
347 \begin_layout Subsection*
351 \begin_layout Description
352 Action Toggles Sans Serif family font (selection-wise).
355 \begin_layout Description
359 \begin_layout Subsection*
363 \begin_layout Description
364 Action Sets font size according to lyx format string.
367 \begin_layout Description
368 Syntax font-size <SIZE>
371 \begin_layout Description
372 Params <SIZE>: tiny|scriptsize|footnotesize|small|normal|large|larger|
373 \begin_inset Newline newline
376 largest|huge|giant|increase|decrease|default
379 \begin_layout Subsection*
383 \begin_layout Description
384 Action Returns the info about the current font.
387 \begin_layout Description
391 \begin_layout Subsection*
395 \begin_layout Description
396 Action Toggles strikeout (strike-through) in the font (selection-wise).
399 \begin_layout Description
400 Syntax font-strikeout
403 \begin_layout Description
404 Origin sanda, 3 May 2009
407 \begin_layout Subsection*
411 \begin_layout Description
412 Action Toggles the typewriter family font (selection-wise).
415 \begin_layout Description
416 Syntax font-typewriter
419 \begin_layout Subsection*
423 \begin_layout Description
424 Action Toggles underline in the font (selection-wise).
427 \begin_layout Description
428 Syntax font-underline
431 \begin_layout Subsection*
435 \begin_layout Description
436 Action Toggles double underline in the font (selection-wise).
439 \begin_layout Description
440 Syntax font-underunderline
443 \begin_layout Description
444 Origin sanda, 5 May 2009
447 \begin_layout Subsection*
451 \begin_layout Description
452 Action Toggles wavy underline in the font (selection-wise).
455 \begin_layout Description
456 Syntax font-underwave
459 \begin_layout Description
460 Origin sanda, 5 May 2009
463 \begin_layout Subsection*
467 \begin_layout Description
468 Action Sets the layout (that is, environment) for the current paragraph.
471 \begin_layout Description
472 Syntax layout <LAYOUT> [ignoreautonests]
475 \begin_layout Description
476 Params <LAYOUT>: the layout to use
477 \begin_inset Newline newline
480 ignoreautonests: If specified, nesting advices will be ignored.
483 \begin_layout Subsection*
487 \begin_layout Description
488 Action Adds a module.
491 \begin_layout Description
492 Notion Adds a module to the list of included modules for the current buffer.
495 \begin_layout Description
496 Syntax layout-module-add <MODULE>
499 \begin_layout Description
500 Params <MODULE>: the module to be added
503 \begin_layout Description
504 Origin rgh, 25 August 2007
507 \begin_layout Subsection*
511 \begin_layout Description
512 Action Clears the module list.
515 \begin_layout Description
516 Notion Clears the list of included modules for the current buffer.
519 \begin_layout Description
520 Syntax layout-modules-clear
523 \begin_layout Description
524 Origin rgh, 25 August 2007
527 \begin_layout Subsection*
531 \begin_layout Description
532 Action Launches the paragraph settings dialog.
535 \begin_layout Description
536 Syntax layout-paragraph
539 \begin_layout Subsection*
543 \begin_layout Description
544 Action Reloads layout information.
547 \begin_layout Description
548 Notion Reloads all layout information for the current buffer from disk, thus recognizing any changes that have been made to layout files on the fly. This is intended to be used only by layout developers and should not be used when one is trying to do actual work.
551 \begin_layout Description
555 \begin_layout Description
556 Origin rgh, 3 September 2007
559 \begin_layout Subsection*
563 \begin_layout Description
564 Action Launches the tabular settings dialog.
567 \begin_layout Description
568 Syntax layout-tabular
571 \begin_layout Description
572 Origin Jug, 31 Jul 2000
575 \begin_layout Subsection*
579 \begin_layout Description
580 Action Toggles the layout (that is, environment) for the current paragraph.
583 \begin_layout Description
584 Notion Contrary to `layout', this function resets the current (or selection) layout to the standard layout it already has the correct layout. Useful for toolbar icons.
587 \begin_layout Description
588 Syntax layout-toggle <LAYOUT> [ignoreautonests]
591 \begin_layout Description
592 Params <LAYOUT>: the layout to toggle
593 \begin_inset Newline newline
596 ignoreautonests: If specified, nesting advices will be ignored.
599 \begin_layout Description
600 Origin lasgouttes, 14 May 2018
603 \begin_layout Subsection*
607 \begin_layout Description
608 Action Update fonts and its metrics.
611 \begin_layout Description
612 Notion Automatically called after zoom, dpi, font names, or norm change.
615 \begin_layout Description
616 Syntax screen-font-update
619 \begin_layout Description
620 Origin ARRae, 13 Aug 2000
623 \begin_layout Subsection*
627 \begin_layout Description
628 Action Sets the text class for the current buffer.
631 \begin_layout Description
632 Syntax textclass-apply <TEXTCLASS>
635 \begin_layout Description
636 Params <TEXTCLASS>: the textclass to set. Note that this must be the filename, minus the ".layout" extension.
639 \begin_layout Subsection*
643 \begin_layout Description
644 Action Loads information for a textclass from disk.
647 \begin_layout Description
648 Syntax textclass-load <TEXTCLASS>
651 \begin_layout Description
652 Params <TEXTCLASS>: the textclass to load. Note that this must be the filename, minus the ".layout" extension.
655 \begin_layout Subsection*
659 \begin_layout Description
660 Action Apply last used text properties.
663 \begin_layout Description
664 Notion These properties are stored via LFUN_TEXTSTYLE_UPDATE, which is automatically triggered when using Text Style dialog.
667 \begin_layout Description
668 Syntax textstyle-apply [<NUM>]textstyle-apply
671 \begin_layout Description
672 Params <NUM>: number of the selection in the internal freefonts stack to be applied.
675 \begin_layout Description
676 Origin leeming, 12 Mar 2003
679 \begin_layout Subsection*
683 \begin_layout Description
684 Action Apply text style and update the settings to be used by LFUN_TEXTSTYLE_APPLY.
687 \begin_layout Description
688 Syntax textstyle-update <FONT_INFO>
691 \begin_layout Description
692 Params <FONT_INFO>: specifies font attributes, e.g. family, series, shape, size, emph, noun, underbar, number, color, language, toggleall.
693 \begin_inset Newline newline
696 Use lyx -dbg action for exact syntax of text-style dialog parameters.
699 \begin_layout Description
700 Origin leeming, 12 Mar 2003
703 \begin_layout Section
704 Editing Functions (Cursor and Mouse Movement, Copy/Paste etc.)
707 \begin_layout Subsection*
711 \begin_layout Description
712 Action Adds an acute accent to the next character typed.
715 \begin_layout Description
719 \begin_layout Subsection*
723 \begin_layout Description
724 Action Adds a breve accent to the next character typed.
727 \begin_layout Description
731 \begin_layout Subsection*
735 \begin_layout Description
736 Action Adds a caron to the next character typed.
739 \begin_layout Description
743 \begin_layout Subsection*
747 \begin_layout Description
748 Action Adds a cedilla to the next character typed.
751 \begin_layout Description
752 Syntax accent-cedilla
755 \begin_layout Subsection*
759 \begin_layout Description
760 Action Adds a circle accent to the next character typed.
763 \begin_layout Description
767 \begin_layout Subsection*
771 \begin_layout Description
772 Action Adds a circumflex to the next character typed.
775 \begin_layout Description
776 Syntax accent-circumflex
779 \begin_layout Subsection*
783 \begin_layout Description
784 Action Adds a dot accent to the next character typed.
787 \begin_layout Description
791 \begin_layout Subsection*
795 \begin_layout Description
796 Action Adds a grave accent to the next character typed.
799 \begin_layout Description
803 \begin_layout Subsection*
804 accent-hungarian-umlaut
807 \begin_layout Description
808 Action Adds a Hungarian umlaut to the next character typed.
811 \begin_layout Description
815 \begin_layout Subsection*
819 \begin_layout Description
820 Action Adds a macron to the next character typed.
823 \begin_layout Description
827 \begin_layout Subsection*
831 \begin_layout Description
832 Action Adds an ogonek accent to the next character typed.
835 \begin_layout Description
839 \begin_layout Subsection*
843 \begin_layout Description
844 Action Adds a perispomeni (Greek circumflex) over the next character typed.
847 \begin_layout Description
848 Syntax accent-perispomeni
851 \begin_layout Subsection*
855 \begin_layout Description
856 Action Adds a tie over the next two character typed.
859 \begin_layout Description
860 Notion The following char will finish the tie.
863 \begin_layout Description
867 \begin_layout Subsection*
871 \begin_layout Description
872 Action Adds a tilde over the next character typed.
875 \begin_layout Description
879 \begin_layout Subsection*
883 \begin_layout Description
884 Action Adds an umlaut over the next character typed.
887 \begin_layout Description
891 \begin_layout Subsection*
895 \begin_layout Description
896 Action Adds a bar under the next character typed.
899 \begin_layout Description
900 Syntax accent-underbar
903 \begin_layout Subsection*
907 \begin_layout Description
908 Action Adds a dot under the next character typed.
911 \begin_layout Description
912 Syntax accent-underdot
915 \begin_layout Subsection*
919 \begin_layout Description
920 Action Accepts all tracked changes in the document.
923 \begin_layout Description
924 Syntax all-changes-accept
927 \begin_layout Description
928 Origin Levon, 16 Oct 2002
931 \begin_layout Subsection*
935 \begin_layout Description
936 Action Rejects all tracked changes in the document.
939 \begin_layout Description
940 Notion Reject does not work recursively; the user may have to repeat the operation.
943 \begin_layout Description
944 Syntax all-changes-reject
947 \begin_layout Description
948 Origin Levon, 16 Oct 2002
951 \begin_layout Subsection*
955 \begin_layout Description
956 Action Start (or remove) Appendix on the given cursor position.
959 \begin_layout Description
963 \begin_layout Description
964 Origin ettrich, 5 May 1998
967 \begin_layout Subsection*
971 \begin_layout Description
972 Action Inserts an argument (short title) inset.
975 \begin_layout Description
976 Syntax argument-insert <argument nr>
979 \begin_layout Description
980 Params <argument nr>: see layout declarations
983 \begin_layout Description
984 Origin vermeer, 12 Aug 2002
987 \begin_layout Subsection*
991 \begin_layout Description
992 Action Adds database, which will be used for bibtex citations.
995 \begin_layout Description
996 Notion Databases are added to the first BibTeX inset (Inset->List/TOC->BibTeX bibliography) found from the cursor position.
999 \begin_layout Description
1000 Syntax bibtex-database-add <DATABASE-NAME>
1003 \begin_layout Description
1004 Origin Ale, 30 May 1997
1007 \begin_layout Subsection*
1011 \begin_layout Description
1012 Action Adds database, which will be used for bibtex citations.
1015 \begin_layout Description
1016 Notion Databases are deleted from the first BibTeX inset (Inset->List/TOC->BibTeX bibliography) found from the cursor position.
1019 \begin_layout Description
1020 Syntax bibtex-database-del <DATABASE-NAME>
1023 \begin_layout Description
1024 Origin Ale, 30 May 1997
1027 \begin_layout Subsection*
1031 \begin_layout Description
1032 Action Clears the list of saved bookmarks.
1035 \begin_layout Description
1036 Syntax bookmark-clear
1039 \begin_layout Description
1040 Origin bpeng, 31 October 2006
1043 \begin_layout Subsection*
1047 \begin_layout Description
1048 Action Moves the cursor to the numbered bookmark, opening the file if necessary. Note that bookmarks are saved per-session, not per file.
1051 \begin_layout Description
1052 Notion Bookmark 0 has a special purpose. It is automatically set
1053 \begin_inset Newline newline
1056 1. to the paragraph you are currently editing
1057 \begin_inset Newline newline
1060 2. to the paragraph from where you are jumping to the last-edited position (jump-back feature)
1061 \begin_inset Newline newline
1064 3. when jumping from crossreference to the requested label by LFUN_LABEL_GOTO.
1067 \begin_layout Description
1068 Syntax bookmark-goto <NUMBER>
1071 \begin_layout Description
1072 Params <NUMBER>: the number of the bookmark to restore.
1075 \begin_layout Description
1076 Origin Dekel, 27 January 2001
1079 \begin_layout Subsection*
1083 \begin_layout Description
1084 Action Save a bookmark.
1087 \begin_layout Description
1088 Notion Saves a numbered bookmark to the sessions file. The number must be between 1 and 9, inclusive. Note that bookmarks are saved per-session, not per file.
1091 \begin_layout Description
1092 Syntax bookmark-save <NUMBER>
1095 \begin_layout Description
1096 Params <NUMBER>: the number of the bookmark to save.
1099 \begin_layout Description
1100 Origin Dekel, 27 January 2001
1103 \begin_layout Subsection*
1107 \begin_layout Description
1108 Action Inserts Box inset.
1111 \begin_layout Description
1112 Syntax box-insert [<TYPE>]
1115 \begin_layout Description
1116 Params <TYPE>: Boxed|Frameless|Framed|ovalbox|Ovalbox|Shadowbox|Shaded|Doublebox
1117 \begin_inset Newline newline
1120 Framed is the default one.
1123 \begin_layout Description
1124 Origin vermeer, 7 Oct 2003
1127 \begin_layout Subsection*
1131 \begin_layout Description
1132 Action Inserts branch inset.
1135 \begin_layout Description
1136 Syntax branch-insert <BRANCH-NAME>
1139 \begin_layout Description
1140 Origin vermeer, 17 Aug 2003
1143 \begin_layout Subsection*
1147 \begin_layout Description
1148 Action For debug purposes only. Convert all [a-zA-Z0-1] characters to single character. Useful when submitting docs to list or bugzilla.
1151 \begin_layout Description
1152 Syntax buffer-anonymize
1155 \begin_layout Description
1156 Origin sanda, Feb 1 2018
1159 \begin_layout Subsection*
1163 \begin_layout Description
1164 Action Move the cursor to the beginning of the document.
1167 \begin_layout Description
1171 \begin_layout Subsection*
1175 \begin_layout Description
1176 Action Move the cursor to the beginning of the document adding the traversed text to the selection.
1179 \begin_layout Description
1180 Syntax buffer-begin-select
1183 \begin_layout Subsection*
1187 \begin_layout Description
1188 Action Move the cursor to the end of the document.
1191 \begin_layout Description
1195 \begin_layout Subsection*
1199 \begin_layout Description
1200 Action Move the cursor to the end of the document adding the traversed text to the selection.
1203 \begin_layout Description
1204 Syntax buffer-end-select
1207 \begin_layout Subsection*
1211 \begin_layout Description
1212 Action Inserts a caption inset.
1215 \begin_layout Description
1216 Syntax caption-insert
1219 \begin_layout Description
1220 Origin Lgb, 18 Jul 2000
1223 \begin_layout Subsection*
1227 \begin_layout Description
1228 Action Moves the cursor to the previous cell inside the table.
1231 \begin_layout Description
1232 Syntax cell-backward
1235 \begin_layout Description
1236 Origin Jug, 22 May 2000
1239 \begin_layout Subsection*
1243 \begin_layout Description
1244 Action Moves the cursor to the next cell inside the table.
1247 \begin_layout Description
1251 \begin_layout Subsection*
1255 \begin_layout Description
1256 Action Splits cell and shifts right part to the next cell (inside the math grid).
1259 \begin_layout Description
1263 \begin_layout Description
1264 Origin Ale, 15 May 1997
1267 \begin_layout Subsection*
1271 \begin_layout Description
1272 Action Accepts tracked change inside the selection.
1275 \begin_layout Description
1276 Syntax change-accept
1279 \begin_layout Description
1280 Origin Levon, 16 Oct 2002
1283 \begin_layout Subsection*
1287 \begin_layout Description
1288 Action Moves the cursor to the position of the next change of the change tracking records.
1291 \begin_layout Description
1295 \begin_layout Description
1296 Origin schmitt, 4 Oct 2006
1299 \begin_layout Subsection*
1303 \begin_layout Description
1304 Action Moves the cursor to the position of the previous change of the change tracking records.
1307 \begin_layout Description
1308 Syntax change-previous
1311 \begin_layout Description
1312 Origin vfr, 4 Apr 2009
1315 \begin_layout Subsection*
1319 \begin_layout Description
1320 Action Rejects tracked change inside the selection.
1323 \begin_layout Description
1324 Syntax change-reject
1327 \begin_layout Description
1328 Origin Levon, 16 Oct 2002
1331 \begin_layout Subsection*
1335 \begin_layout Description
1336 Action Open change tracking dialog for merging and moves the cursor to the position of the next change.
1339 \begin_layout Description
1340 Syntax changes-merge
1343 \begin_layout Description
1344 Origin Levon, 16 Oct 2002
1347 \begin_layout Subsection*
1351 \begin_layout Description
1352 Action Toggles showing of change tracking in typeset output.
1355 \begin_layout Description
1356 Syntax changes-output
1359 \begin_layout Description
1360 Origin spitz, 21 Jan 2005
1363 \begin_layout Subsection*
1367 \begin_layout Description
1368 Action Toggles change tracking to on/off.
1371 \begin_layout Description
1372 Syntax changes-track
1375 \begin_layout Description
1376 Origin levon, 1 Oct 2002
1379 \begin_layout Subsection*
1383 \begin_layout Description
1384 Action Moves the cursor one position logically backwards.
1387 \begin_layout Description
1388 Notion This is not the action which should be bound to the arrow keys, because backwards may be left or right, depending on the language. The arrow keys should be bound to LFUN_CHAR_LEFT or LFUN_CHAR_RIGHT actions, which in turn may employ this one.
1391 \begin_layout Description
1392 Syntax char-backward
1395 \begin_layout Subsection*
1396 char-backward-select
1399 \begin_layout Description
1400 Action Moves the cursor one position logically backwards, adding traversed position to the selection.
1403 \begin_layout Description
1404 Notion See also LFUN_CHAR_BACKWARD.
1407 \begin_layout Description
1408 Syntax char-backward-select
1411 \begin_layout Subsection*
1412 char-delete-backward
1415 \begin_layout Description
1416 Action Deletes one character in the backward direction (usually the "BackSpace" key).
1419 \begin_layout Description
1420 Syntax char-delete-backward [confirm]
1423 \begin_layout Description
1424 Params confirm: Select big insets, do not directly delete them.
1427 \begin_layout Subsection*
1431 \begin_layout Description
1432 Action Deletes one character in the backward direction (usually the "Delete" key).
1435 \begin_layout Description
1436 Syntax char-delete-forward [confirm]
1439 \begin_layout Description
1440 Params confirm: Select big insets, do not directly delete them.
1443 \begin_layout Subsection*
1447 \begin_layout Description
1448 Action Moves the cursor one position logically forward.
1451 \begin_layout Description
1452 Notion This is not the action which should be bound to the arrow keys, because forward may be left or right, depending on the language. The arrow keys should be bound to LFUN_CHAR_LEFT or LFUN_CHAR_RIGHT actions, which in turn may employ this one.
1455 \begin_layout Description
1459 \begin_layout Subsection*
1463 \begin_layout Description
1464 Action Moves the cursor one position logically forward, adding traversed position to the selection.
1467 \begin_layout Description
1468 Notion See also LFUN_CHAR_FORWARD.
1471 \begin_layout Description
1472 Syntax char-forward-select
1475 \begin_layout Subsection*
1479 \begin_layout Description
1480 Action Moves the cursor one position "to the left".
1483 \begin_layout Description
1484 Notion This is the action which should be taken when the "left" key is pressed. Generally, it moves the cursor one position to the left. However, in Bidi text this become slightly more complicated, and there are different modes of cursor movement. In "visual mode", this moves left, plain and simple. In "logical mode", movement is logically forward in RTL paragraphs, and logically backwards in LTR paragraphs.
1487 \begin_layout Description
1491 \begin_layout Subsection*
1495 \begin_layout Description
1496 Action Moves the cursor one position "to the left", adding traversed position to the selection.
1499 \begin_layout Description
1500 Notion See also LFUN_CHAR_LEFT for exact details of the movement.
1503 \begin_layout Description
1504 Syntax char-left-select
1507 \begin_layout Subsection*
1511 \begin_layout Description
1512 Action Moves the cursor one position "to the right".
1515 \begin_layout Description
1516 Notion This is the action which should be taken when the "right" key is pressed. Generally, it moves the cursor one position to the right. However, in Bidi text this become slightly more complicated, and there are different modes of cursor movement. In "visual mode", this moves right, plain and simple. In "logical mode", movement is logically forward in LTR paragraphs, and logically backwards in RTL paragraphs.
1519 \begin_layout Description
1523 \begin_layout Subsection*
1527 \begin_layout Description
1528 Action Moves the cursor one position "to the right", adding traversed position to the selection.
1531 \begin_layout Description
1532 Notion See also LFUN_CHAR_RIGHT for exact details of the movement.
1535 \begin_layout Description
1536 Syntax char-right-select
1539 \begin_layout Subsection*
1543 \begin_layout Description
1544 Action Transposes the character at the cursor with the one before it.
1547 \begin_layout Description
1548 Syntax chars-transpose
1551 \begin_layout Description
1552 Origin Lgb, 25 Apr 2001
1555 \begin_layout Subsection*
1559 \begin_layout Description
1560 Action Inserts citation from loaded citation database.
1563 \begin_layout Description
1564 Syntax citation-insert [<KEY>[|<TEXT_BEFORE>]]
1567 \begin_layout Description
1568 Params <KEY>: Citation (shortcut listed in available citations).
1569 \begin_inset Newline newline
1572 <TEXT_BEFORE>: text which should appear before citation.
1575 \begin_layout Description
1576 Origin AAS, 97-02-23
1579 \begin_layout Subsection*
1583 \begin_layout Description
1584 Action Opens the corresponding pdf/url for a given citation inset.
1587 \begin_layout Description
1588 Syntax citation-open [EXTERNAL] TARGET
1591 \begin_layout Description
1592 Params <TARGET>: URL (https:,file:) of the document.
1593 \begin_inset Newline newline
1596 <EXTERNAL>: Use external executable script for finding target
1597 \begin_inset Newline newline
1600 and launching viewer. In this case TARGET consists of author and year
1601 \begin_inset Newline newline
1604 and will be passed as an input argument to the script.
1607 \begin_layout Description
1608 Origin Sanda, 16 Aug 2020
1611 \begin_layout Subsection*
1615 \begin_layout Description
1616 Action Pastes text from the active clipboard (retains formatting if the clipboard contains formatted text). Pastes plain text if plain text is on the clipboard, but tries to interpret it in special ways for certain insets, e.g. converting csv data to rows and columns if the paste happens in a tabular inset.
1619 \begin_layout Description
1620 Notion Historically, LFUN_CLIPBOARD_PASTE was introduced as a counterpart of LFUN_PRIMARY_SELECTION_PASTE: It behaved exactly the same, but the source is the clipboard, not the selection.
1623 \begin_layout Description
1624 Syntax clipboard-paste [<ARG>]
1627 \begin_layout Description
1628 Params <ARG>: "paragraph" will cause pasting as one paragraph, i.e. "Join lines".
1631 \begin_layout Description
1632 Origin Georg, 10 Jul 2006
1635 \begin_layout Subsection*
1636 clipboard-paste-simple
1639 \begin_layout Description
1640 Action Pastes plain text from the active clipboard even if formatted LyX content is in the clipboard. Pastes plain text if plain text is on the clipboard, without trying to interpret it in special ways for certain insets, e.g. converting csv data to rows and columns if the paste happens in a tabular inset.
1643 \begin_layout Description
1644 Syntax clipboard-paste-simple [<ARG>]
1647 \begin_layout Description
1648 Params <ARG>: "paragraph" will cause pasting as one paragraph, i.e. "Join lines".
1651 \begin_layout Subsection*
1655 \begin_layout Description
1656 Action Switches the focus to the minibuffer so that the user can type in there. If necessary, it opens the minibuffer toolbar.
1659 \begin_layout Description
1660 Notion Usually bound to M-x shortcut.
1663 \begin_layout Description
1664 Syntax command-execute
1667 \begin_layout Subsection*
1671 \begin_layout Description
1672 Action Try to complete the word or command at the cursor position.
1675 \begin_layout Description
1679 \begin_layout Description
1680 Origin sts, Feb 19 2008
1683 \begin_layout Subsection*
1687 \begin_layout Description
1688 Action Accept suggested completion.
1691 \begin_layout Description
1692 Syntax completion-accept
1695 \begin_layout Description
1696 Origin sanda, Sep 08 2008
1699 \begin_layout Subsection*
1703 \begin_layout Description
1704 Action Try to cancel completion, either the popup or the inline completion.
1707 \begin_layout Description
1708 Syntax completion-cancel
1711 \begin_layout Description
1712 Origin sts, Sep 07 2008
1715 \begin_layout Subsection*
1719 \begin_layout Description
1720 Action Show the inline completion at the cursor position.
1723 \begin_layout Description
1724 Syntax completion-inline
1727 \begin_layout Description
1728 Origin sts, Feb 19 2008
1731 \begin_layout Subsection*
1735 \begin_layout Description
1736 Action Show the completion popup at the cursor position.
1739 \begin_layout Description
1740 Syntax completion-popup
1743 \begin_layout Description
1744 Origin sts, Feb 19 2008
1747 \begin_layout Subsection*
1751 \begin_layout Description
1752 Action Copies the current selection to the clipboard.
1755 \begin_layout Description
1759 \begin_layout Subsection*
1763 \begin_layout Description
1764 Action Cuts to the clipboard.
1767 \begin_layout Description
1771 \begin_layout Subsection*
1775 \begin_layout Description
1776 Action Decrease the nesting depth of the (selected) paragraph(s) inside lists.
1779 \begin_layout Description
1780 Syntax depth-decrement
1783 \begin_layout Subsection*
1787 \begin_layout Description
1788 Action Increase the nesting depth of the (selected) paragraph(s) inside lists.
1791 \begin_layout Description
1792 Syntax depth-increment
1795 \begin_layout Subsection*
1796 dialog-disconnect-inset
1799 \begin_layout Description
1800 Action Closes opened connection to opened inset.
1803 \begin_layout Description
1804 Notion Connection is used for apply functions.
1807 \begin_layout Description
1808 Syntax dialog-disconnect-inset <INSET-NAME>
1811 \begin_layout Description
1812 Origin leeming, 25 Feb 2003
1815 \begin_layout Subsection*
1819 \begin_layout Description
1820 Action Hides showed dialog. Counterpart to LFUN_DIALOG_SHOW .
1823 \begin_layout Description
1824 Syntax dialog-hide <NAME>
1827 \begin_layout Description
1828 Params See LFUN_DIALOG_SHOW .
1831 \begin_layout Description
1832 Origin leeming, 25 Feb 2003
1835 \begin_layout Subsection*
1839 \begin_layout Description
1840 Action Shows hidden dialog or creates new one for a given function/inset settings etc.
1843 \begin_layout Description
1844 Syntax dialog-show <NAME> [<DATA>]
1847 \begin_layout Description
1848 Params <NAME>: aboutlyx|bibitem|bibtex|box|branch|changes|character|citation|
1849 \begin_inset Newline newline
1852 compare|counter|document|errorlist|ert|external|file|findreplace|findreplaceadv|float|
1853 \begin_inset Newline newline
1856 graphics|href|include|index|index_print|info|label|line|listings|log|mathdelimiter|
1857 \begin_inset Newline newline
1860 mathmatrix|mathspace|nomenclature|nomencl_print|note|paragraph|phantom|prefs|
1861 \begin_inset Newline newline
1864 print|ref|sendto|space|spellchecker|symbols|tabular|tabularcreate|
1865 \begin_inset Newline newline
1868 thesaurus|texinfo|toc|view-source|vspace|wrap|<SPECIAL>
1869 \begin_inset Newline newline
1872 <SPECIAL>: latexlog|vclog
1873 \begin_inset Newline newline
1876 <DATA>: data, usually settings for the given dialog. Use debug mode for the details.
1879 \begin_layout Description
1880 Origin leeming, 17 Jun 2003
1883 \begin_layout Subsection*
1884 dialog-show-new-inset
1887 \begin_layout Description
1888 Action Shows hidden dialog or create new one for a given inset settings etc.
1891 \begin_layout Description
1892 Notion Internally uses LFUN_DIALOG_SHOW with processed data for a given inset.
1895 \begin_layout Description
1896 Syntax dialog-show-new-inset <NAME> [<DATA>]
1899 \begin_layout Description
1900 Params See LFUN_DIALOG_SHOW .
1903 \begin_layout Description
1904 Origin leeming, 25 Feb 2003
1907 \begin_layout Subsection*
1911 \begin_layout Description
1912 Action Toggles dialog between showed/hidden state.
1915 \begin_layout Description
1916 Notion Internally uses LFUN_DIALOG_SHOW , LFUN_DIALOG_HIDE .
1919 \begin_layout Description
1920 Syntax dialog-toggle <NAME> [<DATA>]
1923 \begin_layout Description
1924 Params See LFUN_DIALOG_SHOW .
1927 \begin_layout Description
1928 Origin spitz, 30 Apr 2007
1931 \begin_layout Subsection*
1935 \begin_layout Description
1936 Action Updates the dialog values from the inset/paragraph/document.
1939 \begin_layout Description
1940 Syntax dialog-update <NAME>
1943 \begin_layout Description
1944 Params <NAME>: paragraph|prefs|<INSET>
1945 \begin_inset Newline newline
1951 \begin_layout Description
1952 Origin leeming, 25 Feb 2003
1955 \begin_layout Subsection*
1959 \begin_layout Description
1960 Action Moves the cursor one line in downward direction.
1963 \begin_layout Description
1967 \begin_layout Subsection*
1971 \begin_layout Description
1972 Action Moves the cursor one line in downward direction adding the current position to the selection.
1975 \begin_layout Description
1979 \begin_layout Subsection*
1983 \begin_layout Description
1984 Action Inserts an ERT inset.
1987 \begin_layout Description
1991 \begin_layout Description
1992 Origin Jug, 18 Feb 2000
1995 \begin_layout Subsection*
1999 \begin_layout Description
2000 Action Clears the selection. If no text is selected call LFUN_FINISHED_FORWARD. Inside math mode jumps out of the math inset.
2003 \begin_layout Description
2007 \begin_layout Description
2008 Origin Lgb, 17 May 2001
2011 \begin_layout Subsection*
2015 \begin_layout Description
2016 Action Cancel background export process.
2019 \begin_layout Description
2020 Syntax export-cancel
2023 \begin_layout Description
2024 Origin rgh, 10 December 2017
2027 \begin_layout Subsection*
2031 \begin_layout Description
2032 Action Inserts another LyX file.
2035 \begin_layout Description
2036 Syntax file-insert [<FILE>] [ignorelang]
2039 \begin_layout Description
2040 Params <FILE>: Filename to be inserted. ignorelang: If given, the (main) language of the inserted file is ignored (the context language is used).
2043 \begin_layout Subsection*
2044 file-insert-plaintext
2047 \begin_layout Description
2048 Action Inserts plain text file.
2051 \begin_layout Description
2052 Syntax file-insert-plaintext [<FILE>]
2055 \begin_layout Description
2056 Params <FILE>: Filename to be inserted.
2059 \begin_layout Description
2060 Origin CFO-G, 19 Nov 1997
2063 \begin_layout Subsection*
2064 file-insert-plaintext-para
2067 \begin_layout Description
2068 Action Inserts plain text file as paragraph (i.e. join lines).
2071 \begin_layout Description
2072 Syntax file-insert-plaintext-para [<FILE>]
2075 \begin_layout Description
2076 Params <FILE>: Filename to be inserted.
2079 \begin_layout Description
2080 Origin Levon, 14 Feb 2001
2083 \begin_layout Subsection*
2087 \begin_layout Description
2088 Action Inserts CharStyle, Custom inset or XML short element.
2091 \begin_layout Description
2092 Notion Look into the Customization manual for more information about these elements.
2093 \begin_inset Newline newline
2096 To make this command enabled the layout file for the document class you're using has to load the character styles. There are a few contained in the Logical Markup module. You can also of course create some yourself.
2097 \begin_inset Newline newline
2100 For dissolving the element see LFUN_INSET_DISSOLVE.
2103 \begin_layout Description
2104 Syntax flex-insert Name
2107 \begin_layout Description
2108 Params Name: This name must be defined either in your layout file or imported by some module. The definition is InsetLayout Name or InsetLayout <Flex:Name>. The Flex: prefix is optional.
2111 \begin_layout Description
2112 Sample flex-insert Code
2115 \begin_layout Subsection*
2119 \begin_layout Description
2120 Action Inserts a float inset.
2123 \begin_layout Description
2124 Syntax float-insert <TYPE>
2127 \begin_layout Description
2128 Params <TYPE>: type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given.
2131 \begin_layout Description
2132 Origin Lgb, 27 Jun 2000
2135 \begin_layout Subsection*
2139 \begin_layout Description
2140 Action Inserts the list of floats in the document.
2143 \begin_layout Description
2144 Syntax float-list-insert <TYPE>
2147 \begin_layout Description
2148 Params <TYPE>: type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given.
2151 \begin_layout Description
2152 Origin Lgb, 3 May 2001
2155 \begin_layout Subsection*
2159 \begin_layout Description
2160 Action Inserts float insets as in LFUN_FLOAT_INSERT but span multiple columns.
2163 \begin_layout Description
2164 Notion Corresponds to the starred floats (figure*, table*, etc.) in LaTeX.
2167 \begin_layout Description
2168 Syntax float-wide-insert <TYPE>
2171 \begin_layout Description
2172 Params <TYPE>: type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given.
2175 \begin_layout Description
2176 Origin Lgb, 31 Oct 2001
2179 \begin_layout Subsection*
2183 \begin_layout Description
2184 Action Inserts a footnote inset.
2187 \begin_layout Description
2188 Syntax footnote-insert
2191 \begin_layout Description
2192 Origin Jug, 7 Mar 2000
2195 \begin_layout Subsection*
2199 \begin_layout Description
2200 Action Reloads the image if necessary.
2203 \begin_layout Description
2204 Syntax graphics-reload
2207 \begin_layout Description
2208 Origin vfr, 10 Aug 2009
2211 \begin_layout Subsection*
2215 \begin_layout Description
2216 Action Set the group for the graphics inset on the cursor position.
2219 \begin_layout Description
2220 Syntax graphics-set-group [<GROUP>]
2223 \begin_layout Description
2224 Params <GROUP>: Id for an existing group. In case the Id is an empty string, the graphics inset is removed from the current group.
2227 \begin_layout Description
2228 Origin sanda, 6 May 2008
2231 \begin_layout Subsection*
2235 \begin_layout Description
2236 Action Set the same group for all graphics insets in the marked block.
2239 \begin_layout Description
2240 Syntax graphics-unify [<GROUP>]
2243 \begin_layout Description
2244 Params <GROUP>: Id for an existing group. In case the Id is an empty string, the group Id from the first graphics inset will be used.
2247 \begin_layout Description
2248 Origin sanda, 7 Feb 2018
2251 \begin_layout Subsection*
2255 \begin_layout Description
2256 Action Inserts hyperlinks into the document (clickable in pdf output).
2259 \begin_layout Description
2260 Notion Hyperlink target can be set via selection + hyperlink-insert function.
2263 \begin_layout Description
2264 Syntax href-insert [<TARGET>]
2267 \begin_layout Description
2268 Origin CFO-G, 21 Nov 1997
2271 \begin_layout Subsection*
2275 \begin_layout Description
2276 Action Only active in IPA inset.
2279 \begin_layout Description
2280 Notion Dummy function which is only active in a IPA inset. It's used to toggle the IPA toolbar if the cursor moves into an IPA inset.
2283 \begin_layout Description
2287 \begin_layout Description
2288 Origin spitz, 20 May 2012
2291 \begin_layout Subsection*
2295 \begin_layout Description
2296 Action Inserts Index entry.
2299 \begin_layout Description
2300 Notion It automatically takes the word on the cursor position.
2303 \begin_layout Description
2304 Syntax index-insert [<TYPE:Name>]
2307 \begin_layout Description
2308 Params <TYPE:Name>: name of the index, if multiple indices are defined. With an empty argument, the default index is selected.
2311 \begin_layout Description
2312 Origin leeming, 3 Aug 2000
2315 \begin_layout Subsection*
2319 \begin_layout Description
2320 Action Inserts list of Index entries on a new page.
2323 \begin_layout Description
2324 Syntax index-print [<TYPE:Name>]
2327 \begin_layout Description
2328 Params <TYPE:Name>: name of the index, if multiple indices are defined. With an empty argument, the default index is selected.
2331 \begin_layout Description
2332 Origin Lgb, 27 Feb 1997
2335 \begin_layout Subsection*
2339 \begin_layout Description
2340 Action Tags all occurrences of the word before the cursor with the index inset at cursor.
2343 \begin_layout Description
2344 Notion It automatically takes the word on the cursor position.
2347 \begin_layout Description
2348 Syntax index-tag-all
2351 \begin_layout Description
2352 Origin spitz, 5 Nov 2022
2355 \begin_layout Subsection*
2359 \begin_layout Description
2360 Action Inserts special Index macros into the document.
2363 \begin_layout Description
2364 Syntax indexmacro-insert <type>
2367 \begin_layout Description
2368 Params <type>: see, seealso, subentry, sortkey.
2371 \begin_layout Description
2372 Origin spitz, 20 Feb 2022
2375 \begin_layout Subsection*
2379 \begin_layout Description
2380 Action Displays shortcuts, lyxrc, package and textclass availability and menu information in a non-editable boxed InsetText.
2383 \begin_layout Description
2384 Notion Apart from lfun arguments you can use the following method:
2385 \begin_inset Newline newline
2388 1. input the type and argument of this inset, e.g. "menu paste", in the work area.
2389 \begin_inset Newline newline
2392 2. select the text and run info-insert lfun.
2395 \begin_layout Description
2396 Syntax info-insert <TYPE> <ARG>
2399 \begin_layout Description
2400 Params <TYPE>: date|moddate|fixdate|time|modtime|fixtime|shortcut|shortcuts|lyxrc| lyxinfo|package|textclass|menu|l7n|icon|buffer|vcs
2401 \begin_inset Newline newline
2404 <ARG>: argument for a given type. Look into InsetInfo.h for detailed description.
2405 \begin_inset Newline newline
2408 date: current date (formatted and localized)
2409 \begin_inset Newline newline
2412 moddate: date of last modification (saving) (formatted and localized)
2413 \begin_inset Newline newline
2416 fixdate: a static date (formatted and localized)
2417 \begin_inset Newline newline
2420 time: current time (formatted and localized)
2421 \begin_inset Newline newline
2424 modtime: time of last modification (saving) (formatted and localized)
2425 \begin_inset Newline newline
2428 fixtime: a static time (formatted and localized)
2429 \begin_inset Newline newline
2432 shortcut[s]: name of lfun (e.g math-insert
2435 \begin_inset Newline newline
2438 lyxrc: name of rc_entry (e.g. bind_file)
2439 \begin_inset Newline newline
2442 lyxinfo: "version" - used version of LyX
2443 \begin_inset Newline newline
2446 package: name of latex package (e.g. listings)
2447 \begin_inset Newline newline
2450 textclass: name of textclass (e.g. article)
2451 \begin_inset Newline newline
2454 menu: name of lfun used in menu
2455 \begin_inset Newline newline
2458 l7n: localizable string.
2459 \begin_inset Newline newline
2462 icon: icon of lfun used in toolbar or direct icon name
2463 \begin_inset Newline newline
2466 buffer: "name"|"name-noext"|"path"|"class" vcs: "tree-revision"|"revision"|"author"|"date"|"time"
2469 \begin_layout Description
2470 Sample command-sequence info-insert buffer path; info-insert buffer name
2473 \begin_layout Description
2474 Origin bpeng, 7 Oct 2007
2477 \begin_layout Subsection*
2481 \begin_layout Description
2482 Action Apply data for an inset.
2485 \begin_layout Description
2486 Notion LFUN_INSET_APPLY is sent from the dialogs when the data should be applied. This is either changed to LFUN_INSET_MODIFY or LFUN_INSET_INSERT depending on the context where it is called.
2489 \begin_layout Description
2490 Syntax inset-apply <ARGS>
2493 \begin_layout Description
2494 Params See LFUN_INSET_INSERT .
2497 \begin_layout Subsection*
2501 \begin_layout Description
2502 Action Move the cursor to the beginning of the current inset if it is not already there. If the cursor is already at the beginning of the current inset, move it to the beginning of the enclosing inset or the main work area, respectively, if there is no enclosing inset.
2505 \begin_layout Description
2509 \begin_layout Description
2510 Origin lasgouttes, 16 Mar 2009
2513 \begin_layout Subsection*
2517 \begin_layout Description
2518 Action Move the cursor to the beginning of the current inset if it is not already there. If the cursor is already at the beginning of the current inset, move it to the beginning of the enclosing inset or the main work area, respectively, if there is no enclosing inset (adding the traversed text to the selection).
2521 \begin_layout Description
2522 Syntax inset-begin-select
2525 \begin_layout Description
2526 Origin lasgouttes, 16 Mar 2009
2529 \begin_layout Subsection*
2533 \begin_layout Description
2534 Action Copies the inset to the clipboard as a certain type.
2537 \begin_layout Description
2538 Notion Currently used only for InsetInfo where its content is copied as a text.
2541 \begin_layout Description
2542 Syntax inset-copy-as
2545 \begin_layout Description
2546 Origin vfr, 18 Apr 2010
2549 \begin_layout Subsection*
2553 \begin_layout Description
2554 Action Dissolve the current inset into text.
2557 \begin_layout Description
2558 Syntax inset-dissolve [<INSET>]
2561 \begin_layout Description
2562 Params <INSET>: this can be used to make sure the right kind of inset is dissolved. For example "dissolve" entry in the charstyles sub-menu should only dissolve the charstyle inset, even if the cursor is inside several nested insets of different type.
2563 \begin_inset Newline newline
2566 For values see lyx::InsetLayout::lyxtype_ .
2569 \begin_layout Description
2570 Origin JSpitz, 7 Aug 2006
2573 \begin_layout Subsection*
2577 \begin_layout Description
2578 Action Edit the inset at cursor with an external application, if one is attributed. If the inset is file based, the referenced file is edited. Otherwise, the inset contents is written to a temporary file, the inset is locked, and the temporary file is edited. In this case, LFUN_INSET_END_EDIT must be called to overtake the changes and unlock the inset after editing is finished.
2581 \begin_layout Description
2582 Syntax inset-edit [<INSET_PARAMS>]
2585 \begin_layout Description
2586 Params <INSET_PARAMS>: Parameters for the inset.
2587 \begin_inset Newline newline
2590 Currently only the filename will be considered.
2593 \begin_layout Description
2594 Origin spitz, 27 Apr 2006
2597 \begin_layout Subsection*
2601 \begin_layout Description
2602 Action Move the cursor to the end of the current inset if it is not already there. If the cursor is already at the end of the current inset, move it to the end of the enclosing inset or the main work area, respectively, if there is no enclosing inset.
2605 \begin_layout Description
2609 \begin_layout Description
2610 Origin lasgouttes, 16 Mar 2009
2613 \begin_layout Subsection*
2617 \begin_layout Description
2618 Action End editing the inset at cursor with an external application. This replaces the inset contents with the contents of the temporary file, deletes the file and unlocks the inset.
2621 \begin_layout Description
2622 Syntax inset-end-edit
2625 \begin_layout Description
2626 Origin gb, 11 Oct 2015
2629 \begin_layout Subsection*
2633 \begin_layout Description
2634 Action Move the cursor to the end of the current inset if it is not already there. If the cursor is already at the end of the current inset, move it to the end of the enclosing inset or the main work area, respectively, if there is no enclosing inset (adding the traversed text to the selection).
2637 \begin_layout Description
2638 Syntax inset-end-select
2641 \begin_layout Description
2642 Origin lasgouttes, 16 Mar 2009
2645 \begin_layout Subsection*
2649 \begin_layout Description
2650 Action Apply the given commands on insets of a given name.
2653 \begin_layout Description
2654 Notion WARNING: use at your own risks; this function gives you too many ways of shooting yourself in the foot. A typical example is inset-forall Note note-insert which starts an infinite loop. This is mitigated by the fact that the number of actions is arbitrarily limited to 100000. Note also that inset-forall does not update metrics between iterations, which can lead to bugs. This has to be eventually fixed.
2657 \begin_layout Description
2658 Syntax inset-forall <NAME> <LFUN-COMMAND>
2659 \begin_inset Newline newline
2662 <NAME>: Type of Inset. If <NAME> is *, all insets are matched. The name is used like for InsetLayout in layout files: "Note" matches all note insets, while "Note:Note" only matches LyX yellow note insets.
2665 \begin_layout Description
2666 Sample Remove all index insets:
2667 \begin_inset Newline newline
2670 inset-forall Index char-delete-forward
2671 \begin_inset Newline newline
2675 \begin_inset Newline newline
2678 inset-forall Note inset-toggle close
2679 \begin_inset Newline newline
2682 Open all branch insets of branch "myBranch":
2683 \begin_inset Newline newline
2686 inset-forall Branch:myBranch inset-toggle open
2687 \begin_inset Newline newline
2690 Transform all yellow notes to comments
2691 \begin_inset Newline newline
2694 inset-forall Note:Note inset-modify note Note Comment
2695 \begin_inset Newline newline
2698 Try to put LyX in an infinite loop if there is at least a Note:
2699 \begin_inset Newline newline
2702 inset-forall Note char-backward
2705 \begin_layout Description
2706 Origin lasgouttes, 27 Nov 2009
2709 \begin_layout Subsection*
2713 \begin_layout Description
2714 Action Insert new inset (type given by the parameters).
2717 \begin_layout Description
2718 Syntax inset-insert <INSET> <ARGS>
2721 \begin_layout Description
2722 Params <INSET>: <bibitem|bibtex|citation|ert|listings|external|graphics|tabular|
2723 \begin_inset Newline newline
2726 hyperlink|include|index|label|line|nomencl|vspace|ref|toc|script>
2727 \begin_inset Newline newline
2730 <ARGS>: depends on the given inset. Use "lyx -dbg action" to explore.
2733 \begin_layout Description
2734 Sample inset-insert ref LatexCommand <Format> reference "<label name>"
2737 \begin_inset Newline newline
2740 where <label name> is the name of the referenced label and <Format> is one of the following:
2741 \begin_inset Newline newline
2745 \begin_inset Newline newline
2748 eqref -- (<reference>)
2749 \begin_inset Newline newline
2753 \begin_inset Newline newline
2756 vpageref -- on <page>
2757 \begin_inset Newline newline
2760 vref -- <reference> on <page>
2761 \begin_inset Newline newline
2764 formatted -- Formatted reference
2767 \begin_layout Subsection*
2771 \begin_layout Description
2772 Action Inserts the inset's content (in ToC pane) at the position of the cursor.
2775 \begin_layout Description
2776 Syntax inset-insert-copy
2779 \begin_layout Description
2780 Origin spitz, 1 Nov 2022
2783 \begin_layout Subsection*
2787 \begin_layout Description
2788 Action Modify some properties of an inset.
2791 \begin_layout Description
2792 Notion Used for argument, bibitem, bibtex, box, branch, caption, citation, command, ert, external, float, graphics, include, index, info, label, line, listings, newline, newpage, nomencl, note, phantom, quotes, ref, script, separator, space, tabular, vspace and wrap insets.
2795 \begin_layout Description
2796 Syntax inset-modify <INSET> <ARGS>
2797 \begin_inset Newline newline
2800 inset-modify changetype <TYPE>
2803 \begin_layout Description
2804 Sample Change a Note inset into a Comment inset:
2805 \begin_inset Newline newline
2808 inset-modify note Note Comment
2809 \begin_inset Newline newline
2812 Change a Box into an Ovalbox:
2813 \begin_inset Newline newline
2816 inset-modify changetype Ovalbox
2817 \begin_inset Newline newline
2820 Change a quotation mark to e[nglish style], l[eft side = opening], s[ingle = inner, secondary]
2821 \begin_inset Newline newline
2824 inset-modify changetype els
2825 \begin_inset Newline newline
2828 Change only the style of a quotation mark, maintaining the other aspects (. = wildcard)
2829 \begin_inset Newline newline
2832 inset-modify changetype e..
2833 \begin_inset Newline newline
2839 \begin_layout Subsection*
2843 \begin_layout Description
2844 Action Select all contents of an inset.
2847 \begin_layout Description
2848 Notion There are 3 successive levels: select current cell, select all cells of inset, select the inset from outside (in the enclosing inset).
2851 \begin_layout Description
2852 Syntax inset-select-all
2855 \begin_layout Description
2856 Origin vfr, 22 Aug 2009; lasgouttes 1 Nov 2014
2859 \begin_layout Subsection*
2863 \begin_layout Description
2864 Action Open the inset's properties dialog.
2867 \begin_layout Description
2868 Notion Used for bibitem, bibtex, box, branch, citation, ert, external, float, graphics, href, include, index, index_print, label, line, listings, note, phantom, ref, space, tabular, vspace, wrap insets.
2871 \begin_layout Description
2872 Syntax inset-settings <INSET>
2875 \begin_layout Description
2876 Params <INSET>: <bibitem|bibtex|box|branch|citation|ert|external|float|
2877 \begin_inset Newline newline
2880 graphics|href|include|index|index_print|label|line|
2881 \begin_inset Newline newline
2884 listings|note|phantom|ref|space|tabular|vspace|wrap>.
2887 \begin_layout Subsection*
2891 \begin_layout Description
2892 Action Splits the current inset into two at current position.
2895 \begin_layout Description
2896 Syntax inset-split [<INSET>]
2899 \begin_layout Description
2900 Params <INSET>: this can be used to make sure the right kind of inset is dissolved. For example "split" entry in the charstyles sub-menu should only dissolve the charstyle inset, even if the cursor is inside several nested insets of different type.
2901 \begin_inset Newline newline
2904 For values see lyx::InsetLayout::lyxtype_ .
2907 \begin_layout Description
2908 Origin spitz, 22 Dec 2020
2911 \begin_layout Subsection*
2915 \begin_layout Description
2916 Action Toggles the collapsible inset at cursor position, or the inset we are currently in.
2919 \begin_layout Description
2920 Syntax inset-toggle [<ARG>]
2923 \begin_layout Description
2924 Params <ARG>: <open|close|toggle|assign>.
2925 \begin_inset Newline newline
2928 open/close/toggle are for collapsible insets. toggle is used when no argument is given.
2929 \begin_inset Newline newline
2932 assign synchronize the branch-inset with activation status of the branch. Used for global toggling when changed activation.
2935 \begin_layout Description
2936 Origin lasgouttes, 19 Jul 2001
2939 \begin_layout Subsection*
2943 \begin_layout Description
2944 Action Inserts an IPA inset.
2947 \begin_layout Description
2951 \begin_layout Description
2952 Origin spitz, 05 Mar 2012
2955 \begin_layout Subsection*
2959 \begin_layout Description
2960 Action Inserts special IPA macros into the document.
2963 \begin_layout Description
2964 Syntax ipamacro-insert <CHAR>
2967 \begin_layout Description
2968 Params <CHAR>: tone-falling, tone-rising, tone-high-rising, tone-low-rising, tone-high-rising-falling, deco bottomtiebar, deco toptiebar.
2971 \begin_layout Description
2972 Origin spitz, 22 Aug 2012
2975 \begin_layout Subsection*
2979 \begin_layout Description
2980 Action Turn off the loaded keyboard map.
2983 \begin_layout Description
2987 \begin_layout Subsection*
2991 \begin_layout Description
2992 Action Turn on the primary keyboard map.
2995 \begin_layout Description
2996 Notion Maps were widely used in past, when X-windows didn't have nowadays keyboard support. They can be still used to maintain uniform keyboard layout across the various platforms.
2997 \begin_inset Newline newline
3000 The language is to be set in the Preferences dialog.
3003 \begin_layout Description
3004 Syntax keymap-primary
3007 \begin_layout Subsection*
3011 \begin_layout Description
3012 Action Turn on the secondary keyboard map.
3015 \begin_layout Description
3016 Syntax keymap-secondary
3019 \begin_layout Subsection*
3023 \begin_layout Description
3024 Action Toggles keyboard maps (first/second/off).
3027 \begin_layout Description
3028 Syntax keymap-toggle
3031 \begin_layout Description
3032 Origin leeming, 30 Mar 2004
3035 \begin_layout Subsection*
3036 label-copy-as-reference
3039 \begin_layout Description
3040 Action Copies the label at the cursor as a cross-reference to be pasted elsewhere.
3043 \begin_layout Description
3044 Syntax copy-label-as-reference <LABEL>
3047 \begin_layout Description
3048 Params <LABEL>: The label to copy (for multi-line math)
3051 \begin_layout Description
3052 Origin sts, 16 Nov 2008
3055 \begin_layout Subsection*
3059 \begin_layout Description
3060 Action Goto a label.
3063 \begin_layout Description
3064 Syntax label-goto [<LABEL>]
3067 \begin_layout Description
3068 Params <LABEL>: Requested label. If no label is given and reference is on cursor position, Bookmark 0 is saved and cursor moves to the position of referenced label.
3071 \begin_layout Description
3072 Origin Ale, 6 Aug 1997
3075 \begin_layout Subsection*
3079 \begin_layout Description
3080 Action Inserts label to text or displayed formula.
3083 \begin_layout Description
3084 Syntax label-insert [<LABEL>]
3087 \begin_layout Description
3088 Params <LABEL>: Requested label. If no label is given dialog requesting name will be opened.
3091 \begin_layout Subsection*
3092 label-insert-as-reference
3095 \begin_layout Description
3096 Action Inserts the label (in ToC pane) as a cross-reference at the position of the cursor.
3099 \begin_layout Description
3100 Syntax label-insert-as-reference
3103 \begin_layout Description
3104 Origin vfr, 7 Apr 2009
3107 \begin_layout Subsection*
3111 \begin_layout Description
3112 Action Set language from the current cursor position.
3115 \begin_layout Description
3116 Syntax language <LANG> [set]
3119 \begin_layout Description
3120 Params <LANG>: Requested language. Look in lib/languages for the list. "language reset" or "language" (without param) reset to the document language. set: If used, the language will be set to the specified language. Otherwise, the language will be toggled (i.e., if the current language is LANG, switch to the document language or the default language, if LANG is the document language).
3123 \begin_layout Description
3124 Origin Dekel, 2 Mar 2000
3127 \begin_layout Subsection*
3131 \begin_layout Description
3132 Action Move the cursor to the beginning of the (screen) line.
3135 \begin_layout Description
3139 \begin_layout Subsection*
3143 \begin_layout Description
3144 Action Move the cursor to the beginning of the (screen) line adding the traversed text to the selection.
3147 \begin_layout Description
3148 Syntax line-begin-select
3151 \begin_layout Subsection*
3155 \begin_layout Description
3156 Action Deletes the letters to the end of the (screen) line or deletes the selection.
3159 \begin_layout Description
3160 Syntax line-delete-forward
3163 \begin_layout Subsection*
3167 \begin_layout Description
3168 Action Move the cursor to the end of the (screen) line.
3171 \begin_layout Description
3175 \begin_layout Subsection*
3179 \begin_layout Description
3180 Action Move the cursor to the end of the (screen) line adding the traversed text to the selection.
3183 \begin_layout Description
3184 Syntax line-end-select
3187 \begin_layout Subsection*
3191 \begin_layout Description
3192 Action Inserts a new listings inset.
3195 \begin_layout Description
3196 Syntax listing-insert
3199 \begin_layout Description
3200 Origin Herbert, 10 Nov 2001; bpeng, 2 May 2007
3203 \begin_layout Subsection*
3207 \begin_layout Description
3208 Action Inserts a marginal note.
3211 \begin_layout Description
3212 Syntax marginalnote-insert
3215 \begin_layout Description
3216 Origin Lgb, 26 Jun 2000
3219 \begin_layout Subsection*
3223 \begin_layout Description
3224 Action Disable selecting of text-region.
3227 \begin_layout Description
3231 \begin_layout Subsection*
3235 \begin_layout Description
3236 Action Enable selecting of text-region.
3239 \begin_layout Description
3240 Notion After enabling you can simply move arrow keys to get selected region.
3243 \begin_layout Description
3247 \begin_layout Subsection*
3251 \begin_layout Description
3252 Action Toggle between LFUN_MARK_ON and LFUN_MARK_OFF .
3255 \begin_layout Description
3259 \begin_layout Description
3260 Origin Andre, May 5 2006
3263 \begin_layout Subsection*
3267 \begin_layout Description
3268 Action Inserts a line break or new line.
3271 \begin_layout Description
3272 Syntax newline-insert [<ARG>]
3275 \begin_layout Description
3276 Params <ARG>: <newline|linebreak> default: newline
3279 \begin_layout Description
3280 Origin spitz, 25 Mar 2008
3283 \begin_layout Subsection*
3287 \begin_layout Description
3288 Action Inserts a new page.
3291 \begin_layout Description
3292 Syntax newpage-insert <ARG>
3295 \begin_layout Description
3296 Params <ARG>: <newpage|pagebreak|clearpage|cleardoublepage> default: newpage
3299 \begin_layout Description
3300 Origin uwestoehr, 24 Nov 2007
3303 \begin_layout Subsection*
3307 \begin_layout Description
3308 Action Inserts Nomenclature entry.
3311 \begin_layout Description
3312 Notion It automatically takes the word on the cursor position if no symbol is given.
3315 \begin_layout Description
3316 Syntax nomencl-insert [<SYMBOL>]
3319 \begin_layout Description
3320 Origin Ugras, 4 Nov 2006
3323 \begin_layout Subsection*
3327 \begin_layout Description
3328 Action Inserts list of Nomenclature entries.
3331 \begin_layout Description
3332 Syntax nomenclature-print
3335 \begin_layout Description
3336 Origin Ugras, 4 Nov 2006
3339 \begin_layout Subsection*
3343 \begin_layout Description
3344 Action Inserts Note on the current cursor position, move selection inside the inset.
3347 \begin_layout Description
3348 Syntax note-insert [<TYPE>]
3351 \begin_layout Description
3352 Params <TYPE>: <Note|Greyedout|Comment> default: Note
3355 \begin_layout Subsection*
3359 \begin_layout Description
3360 Action Moves the cursor to the beginning of next Note inset.
3363 \begin_layout Description
3367 \begin_layout Subsection*
3371 \begin_layout Description
3372 Action Move the current group in the downward direction in the structure of the document.
3375 \begin_layout Description
3376 Notion The "group" can be Part/Chapter/Section/etc. It moves the whole substructure of the group.
3379 \begin_layout Description
3383 \begin_layout Description
3384 Origin Vermeer, 23 Mar 2006
3387 \begin_layout Subsection*
3391 \begin_layout Description
3392 Action Moves the current group in the downward direction in the hierarchy of the document structure.
3395 \begin_layout Description
3396 Notion Part -> Chapter -> Section -> etc.
3399 \begin_layout Description
3403 \begin_layout Description
3404 Origin Vermeer, 23 Mar 2006
3407 \begin_layout Subsection*
3411 \begin_layout Description
3412 Action Moves the current group in the upward direction in the hierarchy of the document structure.
3415 \begin_layout Description
3416 Notion Part <- Chapter <- Section <- etc.
3419 \begin_layout Description
3423 \begin_layout Description
3424 Origin Vermeer, 23 Mar 2006
3427 \begin_layout Subsection*
3431 \begin_layout Description
3432 Action Move the current group in the upward direction in the structure of the document.
3435 \begin_layout Description
3436 Notion The "group" can be Part/Chapter/Section/etc. It moves the whole substructure of the group.
3439 \begin_layout Description
3443 \begin_layout Description
3444 Origin Vermeer, 23 Mar 2006
3447 \begin_layout Subsection*
3451 \begin_layout Description
3452 Action Breaks the current paragraph at the current location.
3455 \begin_layout Description
3456 Notion Removes the selection.
3459 \begin_layout Description
3460 Syntax paragraph-break [<LAYOUT>] [ignoresep]
3463 \begin_layout Description
3464 Params <LAYOUT>: "inverse" - decreases depth by one (or change layout to default layout) when the cursor is at the end of the line.
3465 \begin_inset Newline newline
3468 ignoresep: Do not account for paragraph separators while breaking.
3471 \begin_layout Subsection*
3475 \begin_layout Description
3476 Action Move the cursor to the next paragraph (or beginning of the current one) in downward direction.
3479 \begin_layout Description
3480 Syntax paragraph-down
3483 \begin_layout Description
3484 Origin Asger, 1 Oct 1996
3487 \begin_layout Subsection*
3488 paragraph-down-select
3491 \begin_layout Description
3492 Action Move the cursor and select the text to the next paragraph (or beginning of the current one) in downward direction.
3495 \begin_layout Description
3496 Syntax paragraph-down-select
3499 \begin_layout Description
3500 Origin Asger, 1 Oct 1996
3503 \begin_layout Subsection*
3507 \begin_layout Description
3508 Action Jump to a paragraph given by its id number and optionally the desired position within the paragraph. If given four arguments id_start, pos_start, id_end, pos_end, perform a selection from start to end.
3511 \begin_layout Description
3512 Notion Note that id number of paragraph is not the sequential number of paragraph seen on the screen. Moreover the id is unique for all opened buffers (documents). Both ids must belong to the same buffer.
3515 \begin_layout Description
3516 Syntax paragraph-goto <PAR_ID> <POS_IN_PAR> [<PAR_ID> <POS_IN_PAR>]
3519 \begin_layout Description
3520 Params <PAR_ID>: paragraph id
3521 \begin_inset Newline newline
3524 <POS_IN_PAR>: desired position within the paragraph
3527 \begin_layout Description
3528 Origin Dekel, 26 Aug 2000 gmunch, 5 Sep 2016
3531 \begin_layout Subsection*
3535 \begin_layout Description
3536 Action Moves the current paragraph downwards in the document.
3539 \begin_layout Description
3540 Syntax paragraph-move-down
3543 \begin_layout Description
3544 Origin Edwin, 8 Apr 2006
3547 \begin_layout Subsection*
3551 \begin_layout Description
3552 Action Moves the current paragraph upwards in the document.
3555 \begin_layout Description
3556 Notion Movement through the document will possibly break the paragraph-depth (e.g. itemize structure).
3559 \begin_layout Description
3560 Syntax paragraph-move-up
3563 \begin_layout Description
3564 Origin Edwin, 8 Apr 2006
3567 \begin_layout Subsection*
3571 \begin_layout Description
3572 Action Change paragraph settings.
3575 \begin_layout Description
3576 Notion Modifies the current paragraph, or currently selected paragraphs. This function only modifies, and does not override, existing settings. Note that the "leftindent" indent setting is deprecated.
3579 \begin_layout Description
3580 Syntax paragraph-params [<INDENT>] [<SPACING>] [<ALIGN>] [<OTHERS>]
3583 \begin_layout Description
3593 \begin_inset Newline newline
3598 paragraph_spacing default|single|onehalf|double|other SIZE
3599 \begin_inset Newline newline
3604 align block|left|right|center|default
3605 \begin_inset Newline newline
3610 labelwidthstring WIDTH|
3615 \begin_layout Description
3616 Origin rgh, Aug 15 2007
3619 \begin_layout Subsection*
3620 paragraph-params-apply
3623 \begin_layout Description
3624 Action Change paragraph settings.
3627 \begin_layout Description
3628 Notion Overwrite all nonspecified settings to the default ones. Use paragraph-params lfun if you don't want to overwrite others settings.
3631 \begin_layout Description
3632 Syntax paragraph-params-apply <INDENT> <SPACING> <ALIGN> <OTHERS>
3635 \begin_layout Description
3636 Params For parameters see LFUN_PARAGRAPH_PARAMS
3639 \begin_layout Description
3640 Origin leeming, 30 Mar 2004
3643 \begin_layout Subsection*
3647 \begin_layout Description
3648 Action Move cursor to beginning of current paragraph and select to the end in downward direction
3651 \begin_layout Description
3652 Notion This function is by default bound to triple mouse click
3655 \begin_layout Description
3656 Syntax paragraph-select
3659 \begin_layout Description
3660 Origin Kornel, 16 Apr 2019
3663 \begin_layout Subsection*
3667 \begin_layout Description
3668 Action Move the cursor to the next paragraph (or beginning of the current one) in upward direction.
3671 \begin_layout Description
3675 \begin_layout Description
3676 Origin Asger, 1 Oct 1996
3679 \begin_layout Subsection*
3683 \begin_layout Description
3684 Action Move the cursor and select the text to the next paragraph (or beginning of the current one) in upward direction.
3687 \begin_layout Description
3688 Syntax paragraph-up-select
3691 \begin_layout Description
3692 Origin Asger, 1 Oct 1996
3695 \begin_layout Subsection*
3699 \begin_layout Description
3700 Action Pastes material (text or picture) from the active clipboard.
3703 \begin_layout Description
3704 Syntax paste [<TYPE>|<NUM>]
3707 \begin_layout Description
3708 Params <TYPE>: emf|pdf|png|jpeg|linkback|wmf|latex|html
3709 \begin_inset Newline newline
3712 <NUM>: number of the selection in the internal clipboard stack to be pasted.
3715 \begin_layout Subsection*
3719 \begin_layout Description
3720 Action Inserts phantom on the current cursor position, move selection inside the inset.
3723 \begin_layout Description
3724 Syntax phantom-insert [<TYPE>]
3727 \begin_layout Description
3728 Params <TYPE>: <Phantom|HPhantom|VPhantom> default: Phantom
3731 \begin_layout Description
3732 Origin uwestoehr, 30 Jan 2009
3735 \begin_layout Subsection*
3739 \begin_layout Description
3740 Action Inserts a new preview inset.
3743 \begin_layout Description
3744 Syntax preview-insert
3747 \begin_layout Description
3748 Origin vfr, 28 Mar 2010
3751 \begin_layout Subsection*
3752 primary-selection-paste
3755 \begin_layout Description
3756 Action Pastes the currently selected text.
3759 \begin_layout Description
3760 Notion Primary selection mechanism is X11/Wayland-only thing.
3763 \begin_layout Description
3764 Syntax primary-selection-paste [<ARG>]
3767 \begin_layout Description
3768 Params <ARG>: "paragraph" will cause pasting as one paragraph, i.e. "Join lines".
3771 \begin_layout Subsection*
3775 \begin_layout Description
3776 Action Inserts quotes according to the type and quote-language preference.
3779 \begin_layout Description
3780 Notion Currently 15 different quote styles are distinguished (see params).
3783 \begin_layout Description
3784 Syntax quote-insert [<LEVEL>] [<SIDE>] [<STYLE>]
3787 \begin_layout Description
3788 Params <LEVEL>: 'inner' for (i.e., secondary, usually single) quotes, otherwise outer (i.e., primary, usually double) quotes will be used.
3789 \begin_inset Newline newline
3792 <SIDE>: 'opening' for opening quotes, 'closing' for closing quotes, otherwise the side will be guessed from the context.
3793 \begin_inset Newline newline
3796 <STYLE>: 'british' for `British' quote style (with ``inner quotation'')
3797 \begin_inset Newline newline
3800 'cjk' for Chinese/Japanese/Korean corner bracket quotation marks
3801 \begin_inset Newline newline
3804 'cjk-angle' for Chinese/Japanese/Korean angle bracket quotation marks
3805 \begin_inset Newline newline
3808 'danish' for >>Danish<< quote style (with >inner quotation<)
3809 \begin_inset Newline newline
3812 'english' for ``English'' quote style (with `inner quotation')
3813 \begin_inset Newline newline
3816 'french' for <<french>> quote style (with ``inner quotation'')
3817 \begin_inset Newline newline
3820 'frenchin' for <<frenchin>> quote style (with <<inner quotation>>) ["in" = Imprimerie Nationale]
3821 \begin_inset Newline newline
3824 'german' for ,,German`` quote style (with ,inner quotation`)
3825 \begin_inset Newline newline
3828 'plain' for "Plain" quote style (with 'inner quotation')
3829 \begin_inset Newline newline
3832 'polish' for ,,Polish'' quote style (with ,inner quotation')
3833 \begin_inset Newline newline
3836 'swedish' for ''Swedish'' quote style (with 'inner quotation')
3837 \begin_inset Newline newline
3840 'swedishg' for >>swedishg>> quote style (with 'inner quotation') ["g" = Guillemets]
3841 \begin_inset Newline newline
3844 'swiss' for <<Swiss>> quote style (with <inner quotation>)
3845 \begin_inset Newline newline
3848 'russian' for <<Russian>> quote style (with ,,inner quotation``)
3849 \begin_inset Newline newline
3852 'dynamic' for Dynamic quotation marks which inherit the global document style
3853 \begin_inset Newline newline
3856 If no quote style is specified, the document-wide will be used.
3859 \begin_layout Subsection*
3863 \begin_layout Description
3864 Action Redoes the last thing undone.
3867 \begin_layout Description
3871 \begin_layout Subsection*
3875 \begin_layout Description
3876 Action Go to the next label or cross-reference.
3879 \begin_layout Description
3880 Syntax reference-next
3883 \begin_layout Description
3884 Origin Dekel, 14 Jan 2001
3887 \begin_layout Subsection*
3891 \begin_layout Description
3892 Action Repeat the given command.
3895 \begin_layout Description
3896 Notion fails when the repeat count is greater than 10000.
3899 \begin_layout Description
3900 Syntax repeat <COUNT> <LFUN-COMMAND>
3903 \begin_layout Description
3904 Origin Andre, 27 Oct 2003
3907 \begin_layout Subsection*
3911 \begin_layout Description
3912 Action Moves the cursor one page in downward direction.
3915 \begin_layout Description
3919 \begin_layout Subsection*
3923 \begin_layout Description
3924 Action Moves the cursor one screen in downward direction adding the current position to the selection.
3927 \begin_layout Description
3928 Syntax screen-down-select
3931 \begin_layout Subsection*
3935 \begin_layout Description
3936 Action Recenters the screen on the current cursor position.
3939 \begin_layout Description
3940 Syntax screen-recenter
3943 \begin_layout Subsection*
3947 \begin_layout Description
3948 Action Repositions the screen such that the cursor is visible.
3951 \begin_layout Description
3952 Syntax screen-show-cursor
3955 \begin_layout Description
3956 Origin vfr, 25 Mar 2009
3959 \begin_layout Subsection*
3963 \begin_layout Description
3964 Action Moves the cursor one page in upward direction.
3967 \begin_layout Description
3971 \begin_layout Subsection*
3975 \begin_layout Description
3976 Action Moves the cursor one page in upward direction adding the current position to the selection.
3979 \begin_layout Description
3980 Syntax screen-up-select
3983 \begin_layout Subsection*
3987 \begin_layout Description
3988 Action Inserts a subscript or superscript inset.
3991 \begin_layout Description
3992 Syntax script-insert <TYPE>
3995 \begin_layout Description
3996 Params <TYPE>: subscript|superscript
3999 \begin_layout Description
4000 Origin Georg, 23 Nov 2010
4003 \begin_layout Subsection*
4007 \begin_layout Description
4008 Action Scroll the buffer view.
4011 \begin_layout Description
4012 Notion Only scrolls the screen up or down; does not move the cursor.
4015 \begin_layout Description
4016 Syntax scroll <TYPE> <QUANTITY>
4019 \begin_layout Description
4020 Params <TYPE>: line|page
4021 \begin_inset Newline newline
4024 <QUANTITY>: up|down|<number>
4027 \begin_layout Description
4028 Origin Abdel, Dec 27 2007
4031 \begin_layout Subsection*
4035 \begin_layout Description
4036 Action Set search string buffer.
4039 \begin_layout Description
4040 Syntax search-string-set [<DATA>]
4043 \begin_layout Description
4044 Params <DATA>: string to search for. If no parameter is given, use (word under) selection.
4047 \begin_layout Description
4048 Origin stwitt, spitz, Feb 12 2021
4051 \begin_layout Subsection*
4055 \begin_layout Description
4056 Action Select the whole section.
4059 \begin_layout Description
4060 Notion The cursor should be in a section heading before calling this lfun.
4063 \begin_layout Description
4064 Syntax section-select
4067 \begin_layout Description
4068 Origin vfr, 05 May 2009
4071 \begin_layout Subsection*
4075 \begin_layout Description
4076 Action Pastes the internal selection text in permanent selection.
4079 \begin_layout Description
4080 Notion Created in order to have middle mouse button pasting correct (bound to command-alternatives selection-paste ; primary-selection-paste paragraph).
4083 \begin_layout Description
4084 Syntax selection-paste
4087 \begin_layout Description
4088 Origin lasgouttes, 14 Jan 2009
4091 \begin_layout Subsection*
4095 \begin_layout Description
4096 Action Inserts an environment separator or latex paragraph break.
4099 \begin_layout Description
4100 Syntax separator-insert [<ARG>]
4103 \begin_layout Description
4104 Params <ARG>: <plain|parbreak|latexpar> default: plain
4107 \begin_layout Description
4108 Origin ef, 2 May 2014
4111 \begin_layout Subsection*
4115 \begin_layout Description
4116 Action Inserts one of horizontal space insets.
4119 \begin_layout Description
4120 Syntax space-insert <NAME> [<LEN>]
4123 \begin_layout Description
4124 Params <NAME>: normal, protected, visible, thin, quad, qquad, enspace, enskip, negthinspace, negmedspace, negthickspace, hfill, hfill*, dotfill, hrulefill, hspace, hspace*
4125 \begin_inset Newline newline
4128 Only in math mode: med and thick.
4129 \begin_inset Newline newline
4132 <LEN>: length for custom spaces (hspace, hspace* for protected)
4135 \begin_layout Description
4136 Origin spitz, 20 May 2003, Mar 17 2008
4139 \begin_layout Subsection*
4143 \begin_layout Description
4144 Action Inserts various characters into the document.
4147 \begin_layout Description
4148 Syntax specialchar-insert <CHAR>
4151 \begin_layout Description
4152 Params <CHAR>: hyphenation, allowbreak, ligature-break, slash, nobreakdash, dots, end-of-sentence, menu-separator, lyx, tex, latex, latex2e.
4155 \begin_layout Description
4156 Origin spitz, 6 Dec 2007
4159 \begin_layout Subsection*
4163 \begin_layout Description
4164 Action Add the word under the cursor to the respective spell checker dictionary. The default for the language is retrieved from the cursor position.
4167 \begin_layout Description
4168 Syntax spelling-add [<STRING>] [<LANG>]
4171 \begin_layout Description
4172 Params <WORD>: word to add <LANG>: language name (see file languages)
4175 \begin_layout Description
4176 Origin spitz, 18 Jan 2010
4179 \begin_layout Subsection*
4183 \begin_layout Description
4184 Action Add the word under the cursor to the document's local spell checker dictionary. The default for the language is retrieved from the cursor position.
4187 \begin_layout Description
4188 Syntax spelling-add-local [<STRING>] [<LANG>]
4191 \begin_layout Description
4192 Params <WORD>: word to add <LANG>: language name (see file languages)
4195 \begin_layout Description
4196 Origin spitz, 6 Mar 2021
4199 \begin_layout Subsection*
4200 spelling-continuously
4203 \begin_layout Description
4204 Action Toggle continuous spell checking.
4207 \begin_layout Description
4208 Syntax spelling-continuously
4211 \begin_layout Description
4212 Origin vfr, 24 March 2013
4215 \begin_layout Subsection*
4219 \begin_layout Description
4220 Action Let the spell checker ignore the word under the cursor in the current session for the given language. The default for the language is retrieved from the cursor position.
4223 \begin_layout Description
4224 Syntax spelling-ignore [<WORD>] [<LANG>]
4227 \begin_layout Description
4228 Params <WORD>: word to ignore <LANG>: language name (see file languages)
4231 \begin_layout Description
4232 Origin spitz, 18 Jan 2010
4235 \begin_layout Subsection*
4239 \begin_layout Description
4240 Action Remove the word under the cursor from the respective spell checker dictionary. The default for the language is retrieved from the cursor position.
4243 \begin_layout Description
4244 Syntax spelling-remove [<STRING>] [<LANG>]
4247 \begin_layout Description
4248 Params <WORD>: word to remove <LANG>: language name (see file languages)
4251 \begin_layout Description
4252 Origin SWitt, 28 July 2010
4255 \begin_layout Subsection*
4256 spelling-remove-local
4259 \begin_layout Description
4260 Action Remove the word under the cursor from the document's local spell checker dictionary. The default for the language is retrieved from the cursor position.
4263 \begin_layout Description
4264 Syntax spelling-remove-local [<STRING>] [<LANG>]
4267 \begin_layout Description
4268 Params <WORD>: word to remove <LANG>: language name (see file languages)
4271 \begin_layout Description
4272 Origin spitz, 7 Mar 2021
4275 \begin_layout Subsection*
4279 \begin_layout Description
4280 Action Delete a tab or up to an equivalent amount of spaces from a listings inset.
4283 \begin_layout Description
4284 Notion It also works on a selection - it removes a tab or spaces from the beginning of each line spanned by the selection. This is useful if you want to indent/unindent multiple lines in one action.
4287 \begin_layout Description
4291 \begin_layout Description
4292 Origin vfr, Sep 30 2008
4295 \begin_layout Subsection*
4299 \begin_layout Description
4300 Action Insert a tab into a listings inset.
4303 \begin_layout Description
4304 Notion It also works on a selection.
4307 \begin_layout Description
4311 \begin_layout Description
4312 Origin vfr, Sep 30 2008
4315 \begin_layout Subsection*
4319 \begin_layout Description
4320 Action Modify properties of tabulars and table-like math environments.
4323 \begin_layout Description
4324 Syntax tabular-feature <FEATURE> [<ARG>]
4327 \begin_layout Description
4328 Params Generally see LFUN_INSET_INSERT for further details.
4329 \begin_inset Newline newline
4332 <FEATURE>: append-row|append-column|delete-row|delete-column|copy-row|
4333 \begin_inset Newline newline
4336 copy-column|move-column-right|move-column-left|move-row-down|move-row-up|
4337 \begin_inset Newline newline
4340 set-line-top|set-line-bottom|set-line-left|set-line-right|
4341 \begin_inset Newline newline
4344 toggle-line-top|toggle-line-bottom|toggle-line-left|toggle-line-right|
4345 \begin_inset Newline newline
4348 set-ltrim-top|set-rtrim-top|set-ltrim-bottom|set-rtrim-bottom
4349 \begin_inset Newline newline
4352 toggle-ltrim-top|toggle-rtrim-top|toggle-ltrim-bottom|toggle-rtrim-bottom
4353 \begin_inset Newline newline
4356 align-left|align-right|align-center|align-block|align-decimal|set-decimal-point|
4357 \begin_inset Newline newline
4360 valign-top|valign-bottom|valign-middle|longtabular-align-left|
4361 \begin_inset Newline newline
4364 longtabular-align-center|longtabular-align-right|m-align-left|m-align-right|
4365 \begin_inset Newline newline
4368 m-align-center|m-valign-top|m-valign-bottom|m-valign-middle|multicolumn|
4369 \begin_inset Newline newline
4372 reset-formal-default|set-all-lines|toggle-all-lines|unset-all-lines|
4373 \begin_inset Newline newline
4376 toggle-longtabular|set-longtabular|unset-longtabular|set-pwidth|
4377 \begin_inset Newline newline
4380 set-mpwidth|set-rotate-tabular|unset-rotate-tabular|toggle-rotate-tabular|
4381 \begin_inset Newline newline
4384 set-rotate-cell|unset-rotate-cell|toggle-rotate-cell|set-usebox|set-lthead|
4385 \begin_inset Newline newline
4388 unset-lthead|set-ltfirsthead|unset-ltfirsthead|set-ltfoot|unset-ltfoot|
4389 \begin_inset Newline newline
4392 set-ltlastfoot|unset-ltlastfoot|set-ltnewpage|toggle-ltcaption|
4393 \begin_inset Newline newline
4396 set-special-column|set-special-multicolumn|set-special-multirow|
4397 \begin_inset Newline newline
4400 toggle-booktabs|set-booktabs|unset-booktabs|set-top-space|set-bottom-space|
4401 \begin_inset Newline newline
4404 set-interline-space|tabular-valign-top|tabular-valign-middle|
4405 \begin_inset Newline newline
4408 tabular-valign-bottom|set-tabular-width|toggle-varwidth-column|
4409 \begin_inset Newline newline
4412 set-border-lines|toggle-border-lines|set-inner-lines|toggle-inner-lines Various math-environment features are handled as well, e.g. add-vline-left/right for
4413 \begin_inset Newline newline
4416 the Grid/Array environment.
4417 \begin_inset Newline newline
4420 <ARG>: additional argument for some commands, use debug mode to explore its values.
4423 \begin_layout Description
4424 Origin gm, 10 Dec 2015
4427 \begin_layout Subsection*
4431 \begin_layout Description
4432 Action Inserts table into the document.
4435 \begin_layout Description
4436 Notion See LFUN_TABULAR_FEATURE for some more details about tabular modifications.
4439 \begin_layout Description
4440 Syntax tabular-insert [<ROWS> <COLUMNS>]
4443 \begin_layout Description
4444 Params In case no arguments are given show insert dialog.
4447 \begin_layout Description
4448 Origin Jug, 12 Apr 2000
4451 \begin_layout Subsection*
4452 tabular-style-insert
4455 \begin_layout Description
4456 Action Inserts table of a given style into the document.
4459 \begin_layout Description
4460 Notion See LFUN_TABULAR_FEATURE for some more details about tabular modifications.
4463 \begin_layout Description
4464 Syntax tabular-style-insert <style> <ROWS> <COLUMNS>
4467 \begin_layout Description
4468 Params Valid styles are the names of the files in lib/tabletemplates, minus _1x<n> and .lyx suffix.
4471 \begin_layout Description
4472 Origin spitz, 25 Mar 2019
4475 \begin_layout Subsection*
4479 \begin_layout Description
4480 Action Look up thesaurus entries with respect to the word under the cursor.
4483 \begin_layout Description
4484 Syntax thesaurus-entry [<STRING>] [lang=<LANG>]
4487 \begin_layout Description
4488 Params <STRING>: word to look up <LANG>: language (see file languages)
4491 \begin_layout Description
4492 Origin Levon, 20 Jul 2001
4495 \begin_layout Subsection*
4499 \begin_layout Description
4500 Action Undoes the last edit.
4503 \begin_layout Description
4507 \begin_layout Subsection*
4511 \begin_layout Description
4512 Action Inserts a single unicode character.
4515 \begin_layout Description
4516 Syntax unicode-insert <CHAR1> <CHAR2> ...
4519 \begin_layout Description
4520 Params <CHARn>: The character to insert, given as its code point, in hexadecimal.
4523 \begin_layout Description
4524 Sample unicode-insert 0x0100 0x0259
4527 \begin_layout Description
4528 Origin Lgb, 22 Oct 2006
4531 \begin_layout Subsection*
4535 \begin_layout Description
4536 Action Moves the cursor one line in upward direction.
4539 \begin_layout Description
4543 \begin_layout Subsection*
4547 \begin_layout Description
4548 Action Moves the cursor one line in upward direction adding the current position to the selection.
4551 \begin_layout Description
4555 \begin_layout Subsection*
4559 \begin_layout Description
4560 Action Moves the cursor to the logically previous beginning of a word.
4563 \begin_layout Description
4564 Notion This is not the action which should be bound to the arrow keys, because backwards may be left or right, depending on the language. The arrow keys should be bound to LFUN_WORD_LEFT or LFUN_WORD_RIGHT actions, which in turn may employ this one.
4567 \begin_layout Description
4568 Syntax word-backward
4571 \begin_layout Subsection*
4572 word-backward-select
4575 \begin_layout Description
4576 Action Moves the cursor to the logically previous beginning of a word, adding the logically traversed text to the selection.
4579 \begin_layout Description
4580 Notion See also LFUN_WORD_BACKWARD.
4583 \begin_layout Description
4584 Syntax word-backward-select
4587 \begin_layout Subsection*
4591 \begin_layout Description
4592 Action Capitalizes the words in the selection (i.e. the first letters) or the first letter of word at cursor position.
4595 \begin_layout Description
4596 Syntax word-capitalize [<SEL_TYPE>]
4599 \begin_layout Description
4600 Params <SEL_TYPE>: if this is equal to "partial", then the default word starts at cursor position (emacs-style). Otherwise, the whole word is considered.
4603 \begin_layout Subsection*
4604 word-delete-backward
4607 \begin_layout Description
4608 Action Deletes characters to the beginning of the word (usually the "C+BackSpace" key).
4611 \begin_layout Description
4612 Syntax word-delete-backward [confirm]
4615 \begin_layout Description
4616 Params confirm: Select big insets, do not directly delete them.
4619 \begin_layout Subsection*
4623 \begin_layout Description
4624 Action Deletes characters to the end of the word (usually the "C+Delete" key).
4627 \begin_layout Description
4628 Syntax word-delete-forward [confirm]
4631 \begin_layout Description
4632 Params confirm: Select big insets, do not directly delete them.
4635 \begin_layout Subsection*
4639 \begin_layout Description
4640 Action Search for next occurrence of a string.
4643 \begin_layout Description
4644 Syntax word-find [<DATA>]
4647 \begin_layout Description
4648 Params <DATA>: data encoded from Find dialog (see lyx::find2string()). If no parameter is given, search with last find-dialog data is used for search (i.e. find-next).
4651 \begin_layout Description
4652 Origin Andre, Jan 7 2004
4655 \begin_layout Subsection*
4659 \begin_layout Description
4660 Action Search for a given string in backward direction.
4663 \begin_layout Description
4664 Notion Case sensitive, match words. If no argument given, last search repeated.
4667 \begin_layout Description
4668 Syntax word-find-backward [<STRING>]
4671 \begin_layout Description
4672 Origin Etienne, 20 Feb 1998
4675 \begin_layout Subsection*
4679 \begin_layout Description
4680 Action Search for a given string in forward direction.
4683 \begin_layout Description
4684 Notion Case sensitive, match words. If no argument given, last search repeated.
4687 \begin_layout Description
4688 Syntax word-find-forward [<STRING>]
4691 \begin_layout Description
4692 Origin Etienne, 16 Feb 1998
4695 \begin_layout Subsection*
4699 \begin_layout Description
4700 Action Search for next occurrence of a pattern.
4703 \begin_layout Description
4704 Syntax word-findadv [<DATA>]
4707 \begin_layout Description
4708 Params <DATA>: data encoded from FindAdv dialog (see lyx::findadv2string()). If no parameter is given, search with last find-dialog data is used for search (i.e. find-next).
4711 \begin_layout Description
4712 Origin Tommaso, Nov 15 2007
4715 \begin_layout Subsection*
4719 \begin_layout Description
4720 Action Moves the cursor to the logically next beginning of a word.
4723 \begin_layout Description
4724 Notion This is not the action which should be bound to the arrow keys, because forward may be left or right, depending on the language. The arrow keys should be bound to LFUN_WORD_LEFT or LFUN_WORD_RIGHT actions, which in turn may employ this one.
4727 \begin_layout Description
4731 \begin_layout Subsection*
4735 \begin_layout Description
4736 Action Moves the cursor to the logically next beginning of a word, adding the logically traversed text to the selection.
4739 \begin_layout Description
4740 Notion See also LFUN_WORD_FORWARD.
4743 \begin_layout Description
4744 Syntax word-forward-select
4747 \begin_layout Subsection*
4751 \begin_layout Description
4752 Action Moves the cursor to the next beginning of a word "on the left".
4755 \begin_layout Description
4756 Notion This is the action which should be taken when the (e.g., ctrl-) "left" key is pressed. Generally, it moves the cursor to the next beginning of a word on the left. However, in Bidi text this become slightly more complicated, and there are different modes of cursor movement. In "visual mode", this moves left, plain and simple. In "logical mode", movement is logically forward in RTL paragraphs, and logically backwards in LTR paragraphs.
4759 \begin_layout Description
4763 \begin_layout Description
4764 Origin dov, 28 Oct 2007
4767 \begin_layout Subsection*
4771 \begin_layout Description
4772 Action Moves the cursor to the next beginning of a word "on the left", adding *logically* traversed text to the selection.
4775 \begin_layout Description
4776 Notion See also LFUN_WORD_LEFT for exact details of the movement.
4779 \begin_layout Description
4780 Syntax word-left-select
4783 \begin_layout Description
4784 Origin dov, 28 Oct 2007
4787 \begin_layout Subsection*
4791 \begin_layout Description
4792 Action Change the words in the selection or word at cursor position to lower case.
4795 \begin_layout Description
4796 Syntax word-lowcase [<SEL_TYPE>]
4799 \begin_layout Description
4800 Params <SEL_TYPE>: if this is equal to "partial", then the default word starts at cursor position (emacs-style). Otherwise, the whole word is considered.
4803 \begin_layout Subsection*
4807 \begin_layout Description
4808 Action Replace a string in the document.
4811 \begin_layout Description
4812 Syntax word-replace [<DATA>]
4815 \begin_layout Description
4816 Params <DATA>: data is of the form "<replacestring>
4817 \begin_inset Newline newline
4821 \begin_inset Newline newline
4824 <casesensitive> <matchword> <all> <forward> <findnext>"
4827 \begin_layout Description
4828 Origin Andre, Jan 7 2004
4831 \begin_layout Subsection*
4835 \begin_layout Description
4836 Action Moves the cursor to the next beginning of a word "on the right".
4839 \begin_layout Description
4840 Notion This is the action which should be taken when the (e.g., ctrl-) "right" key is pressed. Generally, it moves the cursor to the next beginning of a word on the right. However, in Bidi text this become slightly more complicated, and there are different modes of cursor movement. In "visual mode", this moves right, plain and simple. In "logical mode", movement is logically forward in LTR paragraphs, and logically backwards in RTL paragraphs.
4843 \begin_layout Description
4847 \begin_layout Description
4848 Origin dov, 28 Oct 2007
4851 \begin_layout Subsection*
4855 \begin_layout Description
4856 Action Moves the cursor to the next beginning of a word "on the right", adding *logically* traversed text to the selection.
4859 \begin_layout Description
4860 Notion See also LFUN_WORD_RIGHT for exact details of the movement.
4863 \begin_layout Description
4864 Syntax word-right-select
4867 \begin_layout Description
4868 Origin dov, 28 Oct 2007
4871 \begin_layout Subsection*
4875 \begin_layout Description
4876 Action Puts the word where the cursor stands into the selection.
4879 \begin_layout Description
4883 \begin_layout Description
4884 Origin Andre, 11 Sep 2002
4887 \begin_layout Subsection*
4891 \begin_layout Description
4892 Action Change the words in the selection or word at cursor position to upper case.
4895 \begin_layout Description
4896 Syntax word-upcase [<SEL_TYPE>]
4899 \begin_layout Description
4900 Params <SEL_TYPE>: if this is equal to "partial", then the default word starts at cursor position (emacs-style). Otherwise, the whole word is considered.
4903 \begin_layout Subsection*
4907 \begin_layout Description
4908 Action Inserts floats wrapped by the text around.
4911 \begin_layout Description
4912 Syntax wrap-insert <TYPE>
4915 \begin_layout Description
4916 Params <TYPE>: table|figure
4919 \begin_layout Description
4920 Origin Dekel, 7 Apr 2002
4923 \begin_layout Section
4924 Math Editor Functions
4927 \begin_layout Subsection*
4928 in-mathmacrotemplate
4931 \begin_layout Description
4932 Action Only active in Math Macro definition.
4935 \begin_layout Description
4936 Notion Dummy function which is only active in a Math Macro definition. It's used to toggle the Math Macro toolbar if the cursor moves into a Math Macro definition.
4939 \begin_layout Description
4940 Syntax in-mathmacrotemplate
4943 \begin_layout Description
4944 Origin sts, 06 January 2008
4947 \begin_layout Subsection*
4951 \begin_layout Description
4952 Action Inserts an extended matrix as provided by the amsmath package.
4955 \begin_layout Description
4956 Syntax math-matrix <COLS> <ROWS> [<DECORATION>]
4959 \begin_layout Description
4960 Params <DECORATION>: Decoration determines the LaTeX name of the matrix that should be created. Possible values include pmatrix, bmatrix, Bmatrix, vmatrix, Vmatrix, smallmatrix, and matrix. The default is 'matrix'.
4963 \begin_layout Description
4964 Sample math-ams-matrix 3 3 bmatrix
4967 \begin_layout Subsection*
4971 \begin_layout Description
4972 Action Inserts math fixed size delimiters (e.g. parentheses, brackets) enclosing expression.
4975 \begin_layout Description
4976 Syntax math-bigdelim <LSIZE> <LDELIM> <RSIZE> <RDELIM>
4979 \begin_layout Description
4980 Params <L/RSIZE>: bigl/r|Bigl/r|biggl/r|Biggl/r
4981 \begin_inset Newline newline
4984 <L/RDELIM>: TeX code for delimiter. See Delimiter dialog for delimiters to be used.
4987 \begin_layout Description
4988 Sample math-bigdelim "Bigl" "
4995 \begin_layout Description
4996 Origin Enrico & Georg, 7 May 2006
4999 \begin_layout Subsection*
5003 \begin_layout Description
5004 Action Inserts math delimiters (e.g. parentheses, brackets) enclosing expression.
5007 \begin_layout Description
5008 Syntax math-delim [<LEFT>] [<RIGHT>]
5011 \begin_layout Description
5012 Params <LEFT/RIGHT>: Delimiters to be used. Each delimiter can be specified by either a LaTeX name or a valid character. ( is the default letter.
5015 \begin_layout Description
5016 Sample math-delim { rangle
5019 \begin_layout Description
5020 Origin Alejandro, 18 Jun 1996
5023 \begin_layout Subsection*
5027 \begin_layout Description
5028 Action Creates a new displayed equation in text mode. Toggles inlined/display formula in math mode.
5031 \begin_layout Description
5032 Syntax math-display [<ARG>]
5035 \begin_layout Description
5036 Params <ARG>: this argument will be passed to LFUN_MATH_INSERT when creating new equation from the text mode.
5039 \begin_layout Description
5040 Origin Alejandro, 18 Jun 1996
5043 \begin_layout Subsection*
5047 \begin_layout Description
5048 Action Calls external program and passes the current expression/equation as an argument for the calculation in the format appropriate to the given language.
5051 \begin_layout Description
5052 Notion Selection can be used to determine the input for the external program.
5055 \begin_layout Description
5056 Syntax math-extern <LANG> [<COMMAND>]
5059 \begin_layout Description
5060 Params <LANG>: octave|maxima|maple|mathematica|script
5061 \begin_inset Newline newline
5064 where "script" stands for the external script (normalized expression will be passed)
5067 \begin_layout Description
5068 Sample math-extern maple simplify
5071 \begin_layout Description
5072 Origin Andre, 24 Apr 2001
5075 \begin_layout Subsection*
5079 \begin_layout Description
5080 Action Changes the text style used in math.
5083 \begin_layout Description
5084 Syntax math-font-style <STYLE>
5087 \begin_layout Description
5088 Params <STYLE>: mathnormal|mathcal|mathfrak|mathrm|mathsf|mathbf|textnormal
5089 \begin_inset Newline newline
5092 |textrm|textsf|texttt|textbf|textmd|textit|textsc|textsl|textup
5095 \begin_layout Description
5096 Origin vfr, 9 jan 2009
5099 \begin_layout Subsection*
5103 \begin_layout Description
5104 Action Inserts math objects and symbols.
5107 \begin_layout Description
5108 Notion When <ARG> is a _single_ math inset with more than one cell (such as "x_y^z" or "
5110 frac{x}{y}"), the content of cell(0) is replaced by the current selection (only works if the selection is in mathed). As an example, if "abc" is selected in mathed, "math-insert
5112 frac{x}{y}" replaces "abc" with "
5114 frac{abc}{y}", and "math-insert x_y^z" replaces "abc" with "abc_y^z". If nothing is selected (or the selection is not in mathed), math-insert works as expected.
5117 \begin_layout Description
5118 Syntax math-insert <ARG>
5121 \begin_layout Description
5122 Params <ARG>: Symbol or LaTeX code to be inserted.
5125 \begin_layout Subsection*
5129 \begin_layout Description
5130 Action Toggles the position of the limits from above/below to the right side an vice versa in integral symbol, a limit, a summation, etc.
5133 \begin_layout Description
5134 Notion Put the cursor before the symbol with the limits and then invoke math-limits.
5137 \begin_layout Description
5138 Syntax math-limits [<STATE>]
5141 \begin_layout Description
5142 Params <STATE>: limits|nolimits
5145 \begin_layout Subsection*
5149 \begin_layout Description
5150 Action Inserts a math macro definition at the cursor position in the text.
5153 \begin_layout Description
5154 Syntax math-macro <NAME> [<NARGS>] [def]
5157 \begin_layout Description
5158 Params <NAME>: The name of the macro, e.g. "mymacro".
5159 \begin_inset Newline newline
5162 <NARGS>: The number of parameters of the macro. Default is 0. "def": Has no effect anymore, just for compatibility with former LyX versions.
5165 \begin_layout Description
5166 Origin ale, 10 May 1997; sts, 21 Dec 2007
5169 \begin_layout Subsection*
5170 math-macro-add-greedy-optional-param
5173 \begin_layout Description
5174 Action Add a greedy optional parameter.
5177 \begin_layout Description
5178 Notion Add a greedy optional parameter which eats the value from the following cells in mathed which are in the [value] format.
5181 \begin_layout Description
5182 Syntax math-macro-add-greedy-optional-param
5185 \begin_layout Description
5186 Origin sts, 06 January 2008
5189 \begin_layout Subsection*
5190 math-macro-add-optional-param
5193 \begin_layout Description
5194 Action Add an optional parameter.
5197 \begin_layout Description
5198 Notion Insert an optional parameter just behind the already existing optional parameters.
5201 \begin_layout Description
5202 Syntax math-macro-add-optional-param
5205 \begin_layout Description
5206 Origin sts, 06 January 2008
5209 \begin_layout Subsection*
5210 math-macro-add-param
5213 \begin_layout Description
5214 Action Add a parameter.
5217 \begin_layout Description
5218 Notion Add a parameter to a Math Macro.
5221 \begin_layout Description
5222 Syntax math-macro-add-param <NUM>
5225 \begin_layout Description
5226 Params <NUM>: The number of the parameter behind which the new one will be added (1 for the first, i.e. use 0 for add a parameter at the left), defaults to the last one.
5229 \begin_layout Description
5230 Origin sts, 06 January 2008
5233 \begin_layout Subsection*
5234 math-macro-append-greedy-param
5237 \begin_layout Description
5238 Action Append a greedy parameter.
5241 \begin_layout Description
5242 Notion Append a greedy parameter to a Math Macro which eats the following mathed cell in every instance of the macro in the buffer.
5245 \begin_layout Description
5246 Syntax math-macro-append-greedy-param
5249 \begin_layout Description
5250 Origin sts, 06 January 2008
5253 \begin_layout Subsection*
5257 \begin_layout Description
5258 Action Fold a Math Macro.
5261 \begin_layout Description
5262 Notion Fold the Math Macro the cursor is in if it was unfolded, i.e. displayed as
5267 \begin_layout Description
5268 Syntax math-macro-fold
5271 \begin_layout Description
5272 Origin sts, 06 January 2008
5275 \begin_layout Subsection*
5276 math-macro-make-nonoptional
5279 \begin_layout Description
5280 Action Make a parameter non-optional.
5283 \begin_layout Description
5284 Notion Turn the last optional parameter of a Math Macro into a non-optional parameter. The default value is remembered to be reused later if the user changes his mind.
5287 \begin_layout Description
5288 Syntax math-macro-make-nonoptional
5291 \begin_layout Description
5292 Origin sts, 06 January 2008
5295 \begin_layout Subsection*
5296 math-macro-make-optional
5299 \begin_layout Description
5300 Action Make a parameter optional.
5303 \begin_layout Description
5304 Notion Turn the first non-optional parameter of a Math Macro into an optional parameter with a default value.
5307 \begin_layout Description
5308 Syntax math-macro-make-optional
5311 \begin_layout Description
5312 Origin sts, 06 January 2008
5315 \begin_layout Subsection*
5316 math-macro-remove-greedy-param
5319 \begin_layout Description
5320 Action Remove a greedy parameter.
5323 \begin_layout Description
5324 Notion Remove a greedy parameter of a Math Macro and spit out the values of it in every instance of the macro in the buffer. If it is an optional parameter the [valud] format is used.
5327 \begin_layout Description
5328 Syntax math-macro-remove-greedy-param
5331 \begin_layout Description
5332 Origin sts, 06 January 2008
5335 \begin_layout Subsection*
5336 math-macro-remove-optional-param
5339 \begin_layout Description
5340 Action Remove the last optional parameter.
5343 \begin_layout Description
5344 Notion Remove the last optional parameter of a Math Macro and remove it in all the instances of the macro in the buffer.
5347 \begin_layout Description
5348 Syntax math-macro-remove-optional-param
5351 \begin_layout Description
5352 Origin sts, 06 January 2008
5355 \begin_layout Subsection*
5356 math-macro-remove-param
5359 \begin_layout Description
5360 Action Remove the last parameter.
5363 \begin_layout Description
5364 Notion Remove the last parameter of a Math Macro and remove its value in all instances of the macro in the buffer.
5367 \begin_layout Description
5368 Syntax math-macro-remove-param <NUM>
5371 \begin_layout Description
5372 Params <NUM>: The number of the parameter to be deleted (1 for the first), defaults to the last one.
5375 \begin_layout Description
5376 Origin sts, 06 January 2008
5379 \begin_layout Subsection*
5383 \begin_layout Description
5384 Action Unfold a Math Macro.
5387 \begin_layout Description
5388 Notion Unfold the Math Macro the cursor is in, i.e. display it as
5393 \begin_layout Description
5394 Syntax math-macro-unfold
5397 \begin_layout Description
5398 Origin sts, 06 January 2008
5401 \begin_layout Subsection*
5405 \begin_layout Description
5406 Action Inserts a matrix.
5409 \begin_layout Description
5410 Syntax math-matrix <COLS> <ROWS> [<ALIGN>]
5413 \begin_layout Description
5414 Params <ALIGN>: Alignment is a word composed of the vertical alignment (b, c or t) (i.e. 1 char) and the horizontal alignments (l, c or r) (i.e. <COL> chars).
5417 \begin_layout Description
5418 Sample math-matrix 3 3 bccc
5421 \begin_layout Subsection*
5425 \begin_layout Description
5426 Action In text mode enters math mode (i.e. puts math insets on the current cursor position), in math mode enters text mode inside math expression.
5429 \begin_layout Description
5430 Notion If there is some selected text, it puts the text inside created math box.
5433 \begin_layout Description
5434 Syntax math-mode [on|<ARG>]
5437 \begin_layout Description
5438 Params <ARG>: eventual argument (LaTeX code) is passed to LFUN_MATH_INSERT .
5439 \begin_inset Newline newline
5442 "on": allow only entering of math mode from text mode.
5445 \begin_layout Description
5446 Origin Alejandro, 4 Jun 1996
5449 \begin_layout Subsection*
5453 \begin_layout Description
5454 Action Mutates the type of math inset to the newly selected one.
5457 \begin_layout Description
5458 Syntax math-mutate <TYPE>
5461 \begin_layout Description
5462 Params <TYPE>: none|simple|equation|eqnarray|align|alignat|xalignat|xxalignat| multline|gather|flalign
5465 \begin_layout Description
5466 Origin Andre, 23 May 2001
5469 \begin_layout Subsection*
5470 math-number-line-toggle
5473 \begin_layout Description
5474 Action Toggles numbering of the current formula line.
5477 \begin_layout Description
5478 Notion Must be in display formula mode.
5481 \begin_layout Description
5482 Syntax math-number-line-toggle
5485 \begin_layout Description
5486 Origin Alejandro, 18 Jun 1996
5489 \begin_layout Subsection*
5493 \begin_layout Description
5494 Action Toggles numbering/labeling of the current formula.
5497 \begin_layout Description
5498 Notion Must be in display formula mode.
5501 \begin_layout Description
5502 Syntax math-number-toggle
5505 \begin_layout Description
5506 Origin Alejandro, 4 Jun 1996
5509 \begin_layout Subsection*
5513 \begin_layout Description
5514 Action Changes arbitrarily the size used by math fonts inside a context.
5517 \begin_layout Description
5518 Notion Provides an interface to the LaTeX math mode font size commands.
5521 \begin_layout Description
5522 Syntax math-size <STYLE>
5525 \begin_layout Description
5537 \begin_layout Description
5538 Origin Alejandro, 15 Aug 1996; sanda, 14 Jun 2008
5541 \begin_layout Subsection*
5545 \begin_layout Description
5546 Action Inserts space into math expression.
5549 \begin_layout Description
5550 Notion Use spacebar after entering this space to change type of space.
5553 \begin_layout Description
5554 Syntax math-space [<TYPE>] [<LEN>]
5557 \begin_layout Description
5558 Params <TYPE>: negative spaces: !|negthinspace|negmedspace|negthickspace
5559 \begin_inset Newline newline
5562 positive spaces: ,|thinspace|:|medspace|;|thickspace|enskip|quad|qquad
5563 \begin_inset Newline newline
5566 custom space: hspace
5567 \begin_inset Newline newline
5570 "," used by default.
5571 \begin_inset Newline newline
5574 Note that ! is equivalent to negthinspace, , = thinspace, : = medspace, and ; = thickspace.
5575 \begin_inset Newline newline
5578 <LEN>: length for custom spaces (hspace)
5581 \begin_layout Description
5582 Origin Andre, 25 Jul 2001; sanda, 16 Jun 2008
5585 \begin_layout Subsection*
5589 \begin_layout Description
5590 Action Enters subscript expression in math expression.
5593 \begin_layout Description
5594 Syntax math-subscript
5597 \begin_layout Description
5598 Origin vermeer, 12 Dec 2001
5601 \begin_layout Subsection*
5605 \begin_layout Description
5606 Action Enters superscript expression in math expression.
5609 \begin_layout Description
5610 Syntax math-superscript
5613 \begin_layout Description
5614 Origin vermeer, 12 Dec 2001
5617 \begin_layout Subsection*
5621 \begin_layout Description
5622 Action Enters regexp mode (i.e., puts regexp insets on the current cursor position). Used by the advanced search dialog.
5625 \begin_layout Description
5626 Notion If there is any selected text, then it is moved inside the created regexp inset.
5629 \begin_layout Description
5630 Syntax regexp-mode [<ARG>]
5633 \begin_layout Description
5634 Params <ARG>: eventual argument (regular expression).
5637 \begin_layout Description
5638 Origin Tommaso, 4 Oct 2008
5641 \begin_layout Section
5642 Buffer Fuctions (File and Window related)
5645 \begin_layout Subsection*
5649 \begin_layout Description
5650 Action Activate the branch.
5653 \begin_layout Description
5654 Syntax branch-activate <BRANCH>
5657 \begin_layout Description
5658 Params <BRANCH>: The branch to activate
5661 \begin_layout Description
5662 Sample lyx -x "branch-activate answers" -e pdf2 finalexam.lyx
5663 \begin_inset Newline newline
5666 could be used to export a pdf with the answers branch included without one's having to open LyX and activate the branch manually.
5669 \begin_layout Description
5670 Origin rgh, 27 May 2008
5673 \begin_layout Subsection*
5677 \begin_layout Description
5678 Action Add a branch to the buffer's BranchList.
5681 \begin_layout Description
5682 Syntax branch-add <BRANCH>
5685 \begin_layout Description
5686 Params <BRANCH>: Name of the branch to add
5689 \begin_layout Description
5690 Origin spitz, 7 Jul 2009
5693 \begin_layout Subsection*
5697 \begin_layout Description
5698 Action Create new branch and directly put the branch inset into the document.
5701 \begin_layout Description
5702 Syntax branch-add-insert [<NAME>]
5705 \begin_layout Description
5706 Params <NAME>: Branch name. If it is not specified, you will be asked.
5709 \begin_layout Description
5710 Origin sanda, 10 Jul 2009
5713 \begin_layout Subsection*
5717 \begin_layout Description
5718 Action De-activate the branch.
5721 \begin_layout Description
5722 Syntax branch-deactivate <BRANCH>
5725 \begin_layout Description
5726 Params <BRANCH>: The branch to deactivate
5729 \begin_layout Description
5730 Origin rgh, 27 May 2008
5733 \begin_layout Subsection*
5737 \begin_layout Description
5738 Action Toggles inversion status of branch inset.
5741 \begin_layout Description
5742 Syntax branch-invert
5745 \begin_layout Description
5746 Origin rgheck, 12 July 2016
5749 \begin_layout Subsection*
5750 branch-master-activate
5753 \begin_layout Description
5754 Action Activate the branch in the master buffer.
5757 \begin_layout Description
5758 Syntax branch-master-activate <BRANCH>
5761 \begin_layout Description
5762 Params <BRANCH>: The branch to activate
5765 \begin_layout Description
5766 Sample lyx -x "branch-activate answers" -e pdf2 finalexam.lyx
5767 \begin_inset Newline newline
5770 could be used to export a pdf with the answers branch included without one's having to open LyX and activate the branch manually.
5773 \begin_layout Description
5774 Origin spitz, 30 Sep 2012
5777 \begin_layout Subsection*
5778 branch-master-deactivate
5781 \begin_layout Description
5782 Action De-activate the branch in the master buffer.
5785 \begin_layout Description
5786 Syntax branch-master-deactivate <BRANCH>
5789 \begin_layout Description
5790 Params <BRANCH>: The branch to deactivate
5793 \begin_layout Description
5794 Origin spitz, 30 Sep 2012
5797 \begin_layout Subsection*
5801 \begin_layout Description
5802 Action Open/close all insets of selected branch (depending on its activation status).
5805 \begin_layout Description
5806 Syntax branch-sync-all
5809 \begin_layout Description
5810 Origin sanda, 15 April 2022
5813 \begin_layout Subsection*
5817 \begin_layout Description
5818 Action Rename all branches of a given name in a document.
5821 \begin_layout Description
5822 Syntax branches-rename <OLDNAME> <NEWNAME>
5825 \begin_layout Description
5826 Params <OLDNAME>: Current name of the branch to be renamed <NEWNAME>: New name of the branch
5829 \begin_layout Description
5830 Origin spitz, 9 Jul 2009
5833 \begin_layout Subsection*
5837 \begin_layout Description
5838 Action Saves the current buffer to a temporary file.
5841 \begin_layout Description
5842 Notion Saves the current buffer to a file named "#filename#". This LFUN is called automatically by LyX, to "autosave" the current buffer.
5845 \begin_layout Description
5846 Syntax buffer-auto-save
5849 \begin_layout Subsection*
5853 \begin_layout Description
5854 Action Loads the given child document.
5857 \begin_layout Description
5858 Notion The current document is treated as a parent.
5861 \begin_layout Description
5862 Syntax buffer-child-open <FILE>
5865 \begin_layout Description
5866 Params <FILE>: Filename of the child. The directory of the parent is assumed by default.
5869 \begin_layout Description
5870 Origin Ale, 28 May 1997
5873 \begin_layout Subsection*
5877 \begin_layout Description
5878 Action Runs chktex for the current document.
5881 \begin_layout Description
5882 Syntax buffer-chktex
5885 \begin_layout Description
5886 Origin Asger, 30 Oct 1997
5889 \begin_layout Subsection*
5893 \begin_layout Description
5894 Action Closes the current buffer.
5897 \begin_layout Description
5898 Notion Closes the current buffer, asking whether to save it, etc, if the buffer has been modified.
5901 \begin_layout Description
5905 \begin_layout Subsection*
5909 \begin_layout Description
5910 Action Closes all buffers.
5913 \begin_layout Description
5914 Notion Closes all buffers, asking whether to save it, etc, if a buffer has been modified.
5917 \begin_layout Description
5918 Syntax buffer-close-all
5921 \begin_layout Subsection*
5925 \begin_layout Description
5926 Action Exports the current buffer (document) to the given format.
5929 \begin_layout Description
5930 Syntax buffer-export [<FORMAT>] [<DEST>]
5933 \begin_layout Description
5934 Params <FORMAT> is either "custom" or one of the formats which you can find in Tools->Preferences->File formats->Format. Usual format you will enter is "pdf2" (pdflatex), "pdflatex" (plain tex for pdflatex) or "ps" for postscript.
5935 \begin_inset Newline newline
5938 In case of "custom" you will be asked for a format you want to start from and for the command that you want to apply to this format. Internally the control is then passed to LFUN_BUFFER_EXPORT_CUSTOM.
5939 \begin_inset Newline newline
5942 If absent or "default", then the default output format of the document is used.
5943 \begin_inset Newline newline
5946 <DEST> If present, this argument provides the export destination filename. Its containing folder will also be the destination folder, where all the needed external files will be copied.
5949 \begin_layout Description
5950 Origin Lgb, 29 Jul 1997
5953 \begin_layout Subsection*
5957 \begin_layout Description
5958 Action Opens a dialog for exporting the current buffer.
5961 \begin_layout Description
5962 Syntax buffer-export-as [<FORMAT>]
5965 \begin_layout Description
5966 Params <FORMAT> is the export format initially selected in the dialog. You can pass any of the formats which you can find in Tools->Preferences->File formats->Format, provided it has the "document" flag set. If no format is specified the dialog will start with the default output format of the current document.
5969 \begin_layout Description
5970 Sample buffer-export-as pdf2
5973 \begin_layout Description
5974 Origin tommaso, 6 Oct 2011
5977 \begin_layout Subsection*
5978 buffer-export-custom
5981 \begin_layout Description
5982 Action Exports the current buffer (document) from the given format using the given command on it.
5985 \begin_layout Description
5986 Syntax buffer-export-custom <FORMAT> <COMMAND>
5989 \begin_layout Description
5990 Params <FORMAT> format to start from (LyX will care to produce such intermediate file).
5991 \begin_inset Newline newline
5994 <COMMAND> this command will be launched on the file. Note that you can use "$$FName" string to qualify the intermediate file.
5997 \begin_layout Description
5998 Sample buffer-export-custom dvi dvips -f $$FName -o myfile.ps
6001 \begin_layout Description
6002 Origin leeming, 27 Mar 2004
6005 \begin_layout Subsection*
6006 buffer-external-modification-clear
6009 \begin_layout Description
6010 Action Clear the external modification flag on the current buffer.
6013 \begin_layout Description
6014 Syntax buffer-external-modification-clear
6017 \begin_layout Description
6018 Origin gm, 2 March 2017
6021 \begin_layout Subsection*
6025 \begin_layout Description
6026 Action Applies a command to all non-hidden buffers.
6029 \begin_layout Description
6030 Notion a buffer is `hidden' if it is internally open in LyX, but not visible in any window.
6033 \begin_layout Description
6034 Syntax buffer-forall <LFUN-COMMAND>
6037 \begin_layout Description
6038 Params <LFUN-COMMAND>: The command to be applied to the buffers.
6041 \begin_layout Description
6042 Sample Close all Notes in all buffers:
6043 \begin_inset Newline newline
6046 buffer-forall inset-forall Note inset-toggle close
6047 \begin_inset Newline newline
6050 Toggle change tracking on buffers:
6051 \begin_inset Newline newline
6054 buffer-forall changes-track
6055 \begin_inset Newline newline
6058 Toggle read-only for buffers:
6059 \begin_inset Newline newline
6062 buffer-forall buffer-toggle-read-only
6063 \begin_inset Newline newline
6066 Show statistics for individual buffers:
6067 \begin_inset Newline newline
6070 buffer-forall statistics
6071 \begin_inset Newline newline
6074 Activate the branch named "Solutions" in buffers:
6075 \begin_inset Newline newline
6078 buffer-forall branch-activate Solutions
6079 \begin_inset Newline newline
6082 Export buffers to PDF (pdflatex):
6083 \begin_inset Newline newline
6086 buffer-forall buffer-export pdf2
6087 \begin_inset Newline newline
6093 \begin_layout Description
6094 Origin skostysh, 20 Jul 2012
6097 \begin_layout Subsection*
6101 \begin_layout Description
6102 Action Import a given file as a lyx document.
6105 \begin_layout Description
6106 Notion File can be imported iff lyx file format is (transitively) reachable via defined converters in preferences. Look in the File->Import menu to get an idea of the currently active import formats.
6109 \begin_layout Description
6110 Syntax buffer-import <FORMAT> [<FILE>]
6113 \begin_layout Description
6114 Origin Asger, 24 Jul 1998
6117 \begin_layout Subsection*
6121 \begin_layout Description
6122 Action Set language of the current document.
6125 \begin_layout Description
6126 Syntax buffer-language <LANG>
6129 \begin_layout Description
6130 Params <LANG>: language name. See lib/languages for list.
6133 \begin_layout Description
6134 Origin leeming, 30 Mar 2004
6137 \begin_layout Subsection*
6141 \begin_layout Description
6142 Action Moves the current tab one spot to the right.
6145 \begin_layout Description
6146 Syntax buffer-move-next
6149 \begin_layout Description
6150 Origin skostysh, 7 Apr 2015
6153 \begin_layout Subsection*
6154 buffer-move-previous
6157 \begin_layout Description
6158 Action Moves the current tab one spot to the left.
6161 \begin_layout Description
6162 Syntax buffer-move-previous
6165 \begin_layout Description
6166 Origin skostysh, 7 Apr 2015
6169 \begin_layout Subsection*
6173 \begin_layout Description
6174 Action Creates a new buffer (that is, document) and switches to it.
6177 \begin_layout Description
6178 Notion Implicit path can be set in Preferences dialog.
6181 \begin_layout Description
6182 Syntax buffer-new [<FILE>]
6185 \begin_layout Description
6186 Params <FILE>: filename of created file with absolute path.
6189 \begin_layout Subsection*
6193 \begin_layout Description
6194 Action Creates a new buffer (that is, document) from a template.
6197 \begin_layout Description
6198 Notion Path for new files and templates can be set in Preferences dialog. Template will be asked for via Open-dialog.
6201 \begin_layout Description
6202 Syntax buffer-new-template [<FILE>] [<TEMPLATE FILE>]
6205 \begin_layout Description
6206 Params <FILE>: filename of created file with absolute path. If empty or "newfile", a file with appropriate name is generated. <TEMPLATE FILE>: filename of template with absolute path. If empty, a dialog is opened to select the new file.
6209 \begin_layout Subsection*
6213 \begin_layout Description
6214 Action Switch to the next opened document.
6217 \begin_layout Description
6218 Notion Note that this does not necessarily mean next in tabbar (for full list see View menu).
6221 \begin_layout Description
6225 \begin_layout Subsection*
6229 \begin_layout Description
6230 Action Apply the given settings to the current document.
6233 \begin_layout Description
6234 Syntax buffer-params-apply [<ARGS>]
6237 \begin_layout Description
6238 Params <ARGS>: contains the particular settings to be saved. They obey the syntax you can find in document header of usual .lyx file.
6241 \begin_layout Description
6242 Origin leeming, 30 Mar 2004
6245 \begin_layout Subsection*
6249 \begin_layout Description
6250 Action Switch to the previous opened document.
6253 \begin_layout Description
6254 Syntax buffer-previous
6257 \begin_layout Subsection*
6261 \begin_layout Description
6262 Action Reverts opened document.
6265 \begin_layout Description
6266 Syntax buffer-reload [dump]
6269 \begin_layout Description
6270 Params dump: do not ask for any confirmation, just reload. All changes will be lost.
6273 \begin_layout Description
6274 Origin Asger, 2 Feb 1997
6277 \begin_layout Subsection*
6281 \begin_layout Description
6282 Action Removes the auxiliary file before next export to assure export is done afresh.
6285 \begin_layout Description
6286 Syntax buffer-reset-export
6289 \begin_layout Description
6290 Origin spitz, 27 Dec 2019
6293 \begin_layout Subsection*
6294 buffer-save-as-default
6297 \begin_layout Description
6298 Action Save the current document settings as default.
6301 \begin_layout Description
6302 Notion The file will will be saved into ~/.lyx/templates/defaults.lyx .
6305 \begin_layout Description
6306 Syntax buffer-save-as-default [<ARGS>]
6309 \begin_layout Description
6310 Params <ARGS>: contains the particular settings to be saved. They obey the syntax you can find in document header of usual .lyx file.
6313 \begin_layout Description
6314 Origin leeming, 30 Mar 2004
6317 \begin_layout Subsection*
6321 \begin_layout Description
6322 Action Display and switch to the given buffer.
6325 \begin_layout Description
6326 Syntax buffer-switch <BUFFER>
6329 \begin_layout Description
6330 Params <BUFFER>: path and filename of already opened (but possibly hidden) document which is to be shown.
6333 \begin_layout Subsection*
6334 buffer-toggle-compression
6337 \begin_layout Description
6338 Action Toggles compression of the current document on/off.
6341 \begin_layout Description
6342 Syntax buffer-toggle-compression
6345 \begin_layout Description
6346 Origin bpeng, 27 Apr 2006
6349 \begin_layout Subsection*
6350 buffer-toggle-read-only
6353 \begin_layout Description
6354 Action Toggle editing mode of the current document between read/write and read-only.
6357 \begin_layout Description
6358 Notion This function is not allowed if the file is under version control, since read-only flag is often used in version control file locking.
6361 \begin_layout Description
6362 Syntax buffer-toggle-read-only
6365 \begin_layout Description
6366 Origin Lgb, 27 May 1997
6369 \begin_layout Subsection*
6373 \begin_layout Description
6374 Action Exports the current document and put the result into the temporary directory.
6377 \begin_layout Description
6378 Notion In case you are already viewing the exported document (see LFUN_BUFFER_VIEW) the output will be rewritten - updated. This is useful in case your viewer is able to detect such changes (e.g. ghostview for postscript).
6381 \begin_layout Description
6382 Syntax buffer-update [<FORMAT>]
6385 \begin_layout Description
6386 Params <FORMAT>: The format to display, where this is one of the formats defined in the Tools>Preferences>File Formats dialog, use the "Short name" field. If no format is given, the default format as specified in the same dialog is used.
6389 \begin_layout Description
6390 Origin Dekel, 5 Aug 2000
6393 \begin_layout Subsection*
6397 \begin_layout Description
6398 Action Displays current buffer in chosen format.
6401 \begin_layout Description
6402 Notion Displays the contents of the current buffer in the chosen format, for example, PDF or DVI. This runs the necessary converter, calls the defined viewer, and so forth.
6405 \begin_layout Description
6406 Syntax buffer-view [<FORMAT>]
6409 \begin_layout Description
6410 Params <FORMAT>: The format to display, where this is one of the formats defined (in the current GUI) in the Tools>Preferences>File Formats dialog. If no format is given, the default format as specified in the same dialog is used.
6413 \begin_layout Subsection*
6417 \begin_layout Description
6418 Action Opens the file that was created from last preview of this buffer.
6421 \begin_layout Description
6422 Notion This LFUN is called by the "Show Output Anyway" button in the LaTeX Errors dialog. It can also be called by the user, which is useful if the document takes a long time to compile, and you just want to see the last previewed version.
6425 \begin_layout Description
6426 Syntax buffer-view-cache
6429 \begin_layout Subsection*
6433 \begin_layout Description
6434 Action Saves the current buffer.
6437 \begin_layout Description
6438 Notion Saves the current buffer to disk, using the filename that is already associated with the buffer, asking for one if none is yet assigned.
6441 \begin_layout Description
6442 Syntax buffer-write [force]
6445 \begin_layout Description
6446 Params force: write even if buffer is not marked as modified.
6449 \begin_layout Subsection*
6453 \begin_layout Description
6454 Action Save all changed documents.
6457 \begin_layout Description
6458 Syntax buffer-write-all
6461 \begin_layout Description
6462 Origin rgh, gpothier 6 Aug 2007
6465 \begin_layout Subsection*
6469 \begin_layout Description
6470 Action Rename and save current buffer.
6473 \begin_layout Description
6474 Syntax buffer-write-as <FILENAME>
6477 \begin_layout Description
6478 Params <FILENAME>: New name of the buffer/file. A relative path is with respect to the original location of the buffer/file.
6481 \begin_layout Subsection*
6482 buffer-write-as-template
6485 \begin_layout Description
6486 Action Rename and save current buffer in the local templates directory.
6489 \begin_layout Description
6490 Syntax buffer-write-as-template <FILENAME>
6493 \begin_layout Description
6494 Params <FILENAME>: New name of the buffer/file. A relative path is with respect to the original location of the buffer/file.
6497 \begin_layout Subsection*
6501 \begin_layout Description
6502 Action Sets the zoom of the screen fonts.
6505 \begin_layout Description
6506 Syntax buffer-zoom [<ZOOM>]
6509 \begin_layout Description
6510 Params <ZOOM>: The target zoom value in %; the default is the default zoom as saved in preferences.
6513 \begin_layout Description
6514 Origin daniel, 28 Oct 2016
6517 \begin_layout Subsection*
6521 \begin_layout Description
6522 Action Increases the zoom of the screen fonts.
6525 \begin_layout Description
6526 Syntax buffer-zoom-in [<ZOOM>]
6529 \begin_layout Description
6530 Params <ZOOM>: The zoom value addition in % (neg. or pos.); the default is 10% of the default zoom as saved in preferences.
6533 \begin_layout Description
6534 Origin vfr, 30 Mar 2009
6537 \begin_layout Subsection*
6541 \begin_layout Description
6542 Action Decreases the zoom of the screen fonts.
6545 \begin_layout Description
6546 Syntax buffer-zoom-out [<ZOOM>]
6549 \begin_layout Description
6550 Params <ZOOM>: The zoom value abstraction in % (neg. or pos.); the default is 10% of the default zoom as saved in preferences.
6553 \begin_layout Description
6554 Origin vfr, 30 Mar 2009
6557 \begin_layout Subsection*
6561 \begin_layout Description
6562 Action Generates the code (literate programming).
6565 \begin_layout Description
6566 Notion Latex file with extension
6568 literate_extension is generated. Then LyX invokes
6570 build_command (with a default of ``make'') to generate the code and
6572 build_error_filter to process the compilation error messages.
6573 \begin_inset Newline newline
6576 In case you want to process your literate file with a script, or some other program, just insert in your lyxrc file an entry with:
6577 \begin_inset Newline newline
6582 build_command "my_script my_arguments"
6583 \begin_inset Newline newline
6588 build_error_filter differs from the
6590 literate_error_filter only in that the former will identify error messages from your compiler.
6593 \begin_layout Description
6594 Syntax build-program
6597 \begin_layout Subsection*
6601 \begin_layout Description
6602 Action Open LyX document.
6605 \begin_layout Description
6606 Syntax file-open [<FILE>]
6609 \begin_layout Description
6610 Params <FILE>: Filename to be opened.
6613 \begin_layout Subsection*
6617 \begin_layout Description
6618 Action Open the given help file according to the language setting.
6621 \begin_layout Description
6622 Syntax help-open <FILE>[.lyx]
6625 \begin_layout Description
6626 Params <FILE>: any document from (/usr/share/)doc directory.
6629 \begin_layout Description
6630 Origin Jug, 27 Jun 1999
6633 \begin_layout Subsection*
6637 \begin_layout Description
6638 Action Sets icon size of toolbars.
6641 \begin_layout Description
6642 Syntax icon-size [<SIZE>]
6645 \begin_layout Description
6646 Params <SIZE> : the icon size in px or one of the logical settings small|normal|big|huge|giant, the default is normal (whose size in px is icon set dependent).
6649 \begin_layout Description
6653 \begin_layout Subsection*
6657 \begin_layout Description
6658 Action Helper function for master-related actions
6661 \begin_layout Description
6662 Notion In a buffer, the function will be disabled if the buffer has no master or children. It thus allows to enable actions only in documents with master/children
6665 \begin_layout Description
6666 Syntax ifrelatives <ACTION>
6669 \begin_layout Description
6670 Origin spitz, 2 January 2020
6673 \begin_layout Subsection*
6677 \begin_layout Description
6678 Action Terminates the current LyX instance.
6681 \begin_layout Description
6682 Notion Terminates the current LyX instance, asking whether to save modified documents, etc.
6685 \begin_layout Description
6689 \begin_layout Subsection*
6693 \begin_layout Description
6694 Action Open lyxfiles (templates/examples). Create a view if he have none.
6697 \begin_layout Description
6698 Syntax lyxfiles-open [<TYPE>]
6701 \begin_layout Description
6702 Params <TYPE>: templates or examples. Default is templates.
6705 \begin_layout Description
6706 Origin spitz, 10 Feb 2021
6709 \begin_layout Subsection*
6710 master-buffer-export
6713 \begin_layout Description
6714 Action Exports the master buffer (document) to the given format.
6717 \begin_layout Description
6718 Syntax master-buffer-export [<FORMAT>] [<DEST>]
6721 \begin_layout Description
6722 Params <FORMAT> is one of the formats which you can find in Tools->Preferences->File formats->Format. Usual format you will enter is "pdf2" (pdflatex), "pdflatex" (plain tex for pdflatex) or "ps" for postscript.
6723 \begin_inset Newline newline
6726 Note that "custom" is not allowed in this case.
6727 \begin_inset Newline newline
6730 If absent or "default", then the default output format of the document is used.
6731 \begin_inset Newline newline
6734 <DEST> If present, this argument provides the export destination filename. Its containing folder will also be the destination folder, where all the needed external files will be copied.
6737 \begin_layout Description
6738 Origin rkh, 18 April 2018
6741 \begin_layout Subsection*
6742 master-buffer-forall
6745 \begin_layout Description
6746 Action Applies a command to a buffer and all it children, starting from the master.
6749 \begin_layout Description
6750 Syntax master-buffer-forall <LFUN-COMMAND>
6753 \begin_layout Description
6754 Params <LFUN-COMMAND>: The command to be applied to the buffers.
6757 \begin_layout Description
6758 Sample Close all Notes in buffers:
6759 \begin_inset Newline newline
6762 master-buffer-forall inset-forall Note inset-toggle close
6763 \begin_inset Newline newline
6766 Toggle change tracking on buffers:
6767 \begin_inset Newline newline
6770 master-buffer-forall changes-track
6771 \begin_inset Newline newline
6774 Toggle read-only for buffers:
6775 \begin_inset Newline newline
6778 master-buffer-forall buffer-toggle-read-only
6779 \begin_inset Newline newline
6782 Show statistics for individual buffers:
6783 \begin_inset Newline newline
6786 master-buffer-forall statistics
6787 \begin_inset Newline newline
6790 Activate the branch named "Solutions" in buffers:
6791 \begin_inset Newline newline
6794 master-buffer-forall branch-activate Solutions
6795 \begin_inset Newline newline
6801 \begin_layout Description
6802 Origin spitz, 31 Dec 2019
6805 \begin_layout Subsection*
6806 master-buffer-update
6809 \begin_layout Description
6810 Action Update (export) the document built from the master buffer, if the current buffer is part of a master/child document.
6813 \begin_layout Description
6814 Syntax master-buffer-update [<FORMAT>]
6817 \begin_layout Description
6818 Params <FORMAT>: The format to display, where this is one of the formats defined (in the current GUI) in the Tools>Preferences>File Formats dialog. If no format is given, the default format as specified in the same dialog is used.
6821 \begin_layout Description
6822 Origin Tommaso, 20 Sep 2007
6825 \begin_layout Subsection*
6829 \begin_layout Description
6830 Action Show a preview built from the master buffer, if available. if the current buffer is part of a master/child document.
6833 \begin_layout Description
6834 Syntax master-buffer-view [<FORMAT>]
6837 \begin_layout Description
6838 Params <FORMAT>: The format to display, where this is one of the formats defined (in the current GUI) in the Tools>Preferences>File Formats dialog. If no format is given, the default format as specified in the same dialog is used.
6841 \begin_layout Description
6842 Origin Tommaso, 20 Sep 2007
6845 \begin_layout Subsection*
6849 \begin_layout Description
6850 Action Opens the menu given by its name.
6853 \begin_layout Description
6854 Syntax menu-open <NAME>
6857 \begin_layout Description
6858 Params <NAME>: menu name. See various .inc files in lib/ui for candidates.
6861 \begin_layout Subsection*
6865 \begin_layout Description
6866 Action Close the current tab group.
6869 \begin_layout Description
6870 Notion This only closes the work areas, not the buffers themselves. The still opened buffers can be visualized in another tab group.
6873 \begin_layout Description
6874 Syntax tab-group-close
6877 \begin_layout Description
6878 Origin Abdel, 21 Feb 2008
6881 \begin_layout Subsection*
6885 \begin_layout Description
6886 Action Switch to the next tab group in split view.
6889 \begin_layout Description
6890 Syntax tab-group-next
6893 \begin_layout Subsection*
6897 \begin_layout Description
6898 Action Switch to the previous tab group in split view.
6901 \begin_layout Description
6902 Syntax tab-group-previous
6905 \begin_layout Subsection*
6909 \begin_layout Description
6910 Action Toggles movability of a given toolbar between true/false.
6913 \begin_layout Description
6914 Syntax toolbar-movable <NAME>
6917 \begin_layout Description
6918 Params <NAME>: *|standard|extra|table|math|mathmacrotemplate| minibuffer|review|view/update|math_panels|vcs| view-others|update-others
6921 \begin_layout Description
6922 Origin daniel, 12 July 2016
6925 \begin_layout Subsection*
6929 \begin_layout Description
6930 Action Sets visibility of a given toolbar to on, off, or auto.
6933 \begin_layout Description
6934 Notion Skipping "auto" when allowauto is false.
6937 \begin_layout Description
6938 Syntax toolbar-set <NAME> [on|off|auto]
6941 \begin_layout Description
6942 Params <NAME>: standard|extra|table|math|mathmacrotemplate|
6943 \begin_inset Newline newline
6946 minibuffer|review|view/update|math_panels|vcs| view-others|update-others
6949 \begin_layout Description
6950 Origin spitz, 17 Dec 2020
6953 \begin_layout Subsection*
6957 \begin_layout Description
6958 Action Toggles visibility of a given toolbar between on/off/auto.
6961 \begin_layout Description
6962 Notion Skipping "auto" when allowauto is false.
6965 \begin_layout Description
6966 Syntax toolbar-toggle <NAME> [allowauto]
6969 \begin_layout Description
6970 Params <NAME>: standard|extra|table|math|mathmacrotemplate|
6971 \begin_inset Newline newline
6974 minibuffer|review|view/update|math_panels|vcs| view-others|update-others
6977 \begin_layout Description
6978 Origin Edwin, 21 May 2007
6981 \begin_layout Subsection*
6985 \begin_layout Description
6986 Action Various UI visibility-toggling actions.
6989 \begin_layout Description
6990 Syntax ui-toggle <statusbar|menubar|scrollbar|frame|fullscreen>
6993 \begin_layout Description
6994 Params statusbar : Toggle visibility of the statusbar.
6995 \begin_inset Newline newline
6998 menubar : Toggle visibility of the menubar.
6999 \begin_inset Newline newline
7002 scrollbar : Toggle visibility of the scrollbar.
7003 \begin_inset Newline newline
7006 frame : Toggle visibility of the frames around editing window.
7007 \begin_inset Newline newline
7010 zoomslider : Toggle visibility of the zoom slider in statusbar.
7011 \begin_inset Newline newline
7014 zoomlevel : Toggle visibility of the zoom level display in statusbar.
7015 \begin_inset Newline newline
7018 statistics-w : Toggle visibility of the document word count in statusbar.
7019 \begin_inset Newline newline
7022 statistics-cb : Toggle visibility of the document character count (incl. blanks) in statusbar.
7023 \begin_inset Newline newline
7026 statistics-c : Toggle visibility of the document character count (excl. blanks) in statusbar.
7027 \begin_inset Newline newline
7030 fullscreen : Toggle fullscreen mode. This also covers calling the previous functions. However LFUN_TOOLBAR_TOGGLE for the custom tweaks of the toolbars should be used.
7033 \begin_layout Description
7034 Origin sanda, 9 Feb 2007
7037 \begin_layout Subsection*
7041 \begin_layout Description
7042 Action Close the current document work area.
7045 \begin_layout Description
7046 Notion Close the current work area. If no other work areas are showing the buffer, then close the associated buffer as well.
7049 \begin_layout Description
7053 \begin_layout Description
7054 Origin Tommaso, 15 Sep 2012
7057 \begin_layout Subsection*
7061 \begin_layout Description
7062 Action Creates another split view of current buffer.
7065 \begin_layout Description
7066 Notion All split views act in the same way independently.
7069 \begin_layout Description
7070 Syntax view-split <vertical|horizontal>
7073 \begin_layout Description
7074 Params horizontal : The work areas are laid out side by side.
7075 \begin_inset Newline newline
7078 vertical : The work areas laid out vertically.
7081 \begin_layout Description
7082 Origin Abdel, 20 Feb 2008
7085 \begin_layout Subsection*
7089 \begin_layout Description
7090 Action Closes the current LyX window.
7093 \begin_layout Description
7097 \begin_layout Description
7098 Origin Abdel, 23 Oct 2006
7101 \begin_layout Subsection*
7105 \begin_layout Description
7106 Action Creates new empty LyX window.
7109 \begin_layout Description
7110 Notion Already opened documents from the previous window can be found under View menu.
7113 \begin_layout Description
7114 Syntax window-new [<GEOMETRY>]
7117 \begin_layout Description
7118 Params <GEOMETRY>: pass the geometry of the window. This parameter is currently accepted only on Windows platform.
7121 \begin_layout Description
7122 Origin Abdel, 21 Oct 2006
7125 \begin_layout Section
7126 System Functions (Preferences, LyX Server etc.)
7129 \begin_layout Subsection*
7130 bibtex-database-list
7133 \begin_layout Description
7134 Action Lists the available databases (separated by path separator common on the used OS).
7137 \begin_layout Description
7138 Notion Used by bibliographic managers
7141 \begin_layout Description
7142 Syntax bibtex-database-list
7145 \begin_layout Description
7146 Origin bpiwowar, 18 December 2022
7149 \begin_layout Subsection*
7150 buffer-toggle-output-sync
7153 \begin_layout Description
7154 Action Toggles including of resources for forward/reverse search of the given document.
7157 \begin_layout Description
7158 Notion When toggled on, SyncTeX is invoked for PDF, while srcltx package is used for DVI. Custom LaTeX macro can be defined in preferences.
7161 \begin_layout Description
7162 Syntax buffer-toggle-output-sync
7165 \begin_layout Description
7166 Origin sanda, 25 May 2010
7169 \begin_layout Subsection*
7173 \begin_layout Description
7174 Action Executes a command defined in a .def file.
7177 \begin_layout Description
7178 Notion The definitions are by default read from lib/commands/default.def.
7179 \begin_inset Newline newline
7182 A .def file allows to define a command with
7184 define "<NAME>" "<LFUN>" where <NAME> is the name of the new command and <LFUN> is the lfun code to be executed (see e.g. LFUN_COMMAND_SEQUENCE).
7186 def_file "FileName" allows to include another .def file.
7187 \begin_inset Newline newline
7190 This is particularly useful in connection with toolbar buttons: Since the name of the button image for this lfun is lib/images/commands/<NAME>.png this is the way to assign an image to a complex command-sequence.
7193 \begin_layout Description
7197 \begin_layout Description
7198 Params <NAME>: Name of the command that must be called.
7201 \begin_layout Description
7202 Origin broider, 2 Oct 2007
7205 \begin_layout Subsection*
7209 \begin_layout Description
7210 Action Cancels sequence prepared by LFUN_META_PREFIX .
7213 \begin_layout Description
7217 \begin_layout Subsection*
7218 command-alternatives
7221 \begin_layout Description
7222 Action Runs the first listed command that is enabled.
7225 \begin_layout Description
7226 Notion This can be used to bind multiple functions to a single key, and then which one is used will depend upon the context.
7229 \begin_layout Description
7230 Syntax command-alternatives <CMDS>
7233 \begin_layout Description
7234 Params <CMDS>: Sequence of commands separated by semicolons.
7237 \begin_layout Description
7238 Sample command-alternatives completion-accept;cell-forward
7241 \begin_layout Description
7242 Origin rgh, 24 September 2008
7245 \begin_layout Subsection*
7249 \begin_layout Description
7250 Action Run more commands (LFUN and its parameters) in a sequence.
7253 \begin_layout Description
7254 Syntax command-sequence <CMDS>
7257 \begin_layout Description
7258 Params <CMDS>: Sequence of commands separated by semicolons.
7261 \begin_layout Description
7262 Sample command-sequence cut; ert-insert; self-insert
7264 ; paste; self-insert {}; inset-toggle;
7267 \begin_layout Description
7268 Origin Andre, 11 Nov 1999
7271 \begin_layout Subsection*
7272 cursor-follows-scrollbar-toggle
7275 \begin_layout Description
7276 Action Determine whether to keep cursor inside the editing window regardless of the scrollbar movement.
7279 \begin_layout Description
7280 Syntax toggle-cursor-follows-scrollbar
7283 \begin_layout Description
7284 Origin ARRae, 2 Dec 1997
7287 \begin_layout Subsection*
7291 \begin_layout Description
7292 Action Set debug output level.
7295 \begin_layout Description
7296 Syntax debug-level-set <LEVEL>
7299 \begin_layout Description
7300 Params <LEVEL>: comma separated list of levels or the correspondent number of their combination. 0 is equivalent to disabling all debug events. See lyx -dbg for the current list of debug levels and their numbers.
7303 \begin_layout Description
7304 Origin sanda, 28 Dec 2009
7307 \begin_layout Subsection*
7311 \begin_layout Description
7312 Action toggle a mode where more information is given in UI
7315 \begin_layout Description
7316 Notion in so called "devel" mode, the information given in the status bar is more precise, and the help documents are open in editing mode.
7319 \begin_layout Description
7320 Syntax devel-mode-toggle
7323 \begin_layout Description
7324 Origin lasgouttes, 23 Jul 2017
7327 \begin_layout Subsection*
7331 \begin_layout Description
7332 Action Sets the cursor position in the previewed (dvi/pdf) file based on the row number in LyX window.
7335 \begin_layout Description
7336 Notion The external program used for forward search call can be specified in LyX Output preferences. See Additional manual for details of these settings.
7339 \begin_layout Description
7340 Syntax forward-search
7343 \begin_layout Description
7344 Origin sanda, 14 Apr 2010
7347 \begin_layout Subsection*
7351 \begin_layout Description
7352 Action Apply the given settings to user preferences.
7355 \begin_layout Description
7356 Syntax lyxrc-apply <SETTINGS>
7359 \begin_layout Description
7360 Params <SETTINGS>: settings which are to be set. Take a look into ~/.lyx/preferences to get an idea which commands to use and their syntax. lyx::LyXRC::LyXRCTags has the list of possible commands.
7363 \begin_layout Subsection*
7367 \begin_layout Description
7368 Action Shows message in statusbar (for script purposes).
7371 \begin_layout Description
7372 Syntax message <STRING>
7375 \begin_layout Description
7376 Origin Lgb, 8 Apr 2001
7379 \begin_layout Subsection*
7383 \begin_layout Description
7384 Action Simulate halting Meta key (Alt key on PCs).
7387 \begin_layout Description
7388 Notion Used for buffer edition not for GUI control.
7391 \begin_layout Description
7395 \begin_layout Subsection*
7399 \begin_layout Description
7400 Action Save user preferences.
7403 \begin_layout Description
7404 Syntax preferences-save
7407 \begin_layout Description
7408 Origin Lgb, 27 Nov 1999
7411 \begin_layout Subsection*
7415 \begin_layout Description
7416 Action Reconfigure the automatic settings.
7419 \begin_layout Description
7423 \begin_layout Description
7424 Origin Asger, 14 Feb 1997
7427 \begin_layout Subsection*
7431 \begin_layout Description
7432 Action Enables/disables searching for features in findadv
7435 \begin_layout Description
7436 Syntax search-ignore <type> <value>
7439 \begin_layout Description
7440 Params <type>: language|color|sectioning|font|series|shape|family|markup|underline|strike|deleted|non-output-content
7441 \begin_inset Newline newline
7447 \begin_layout Subsection*
7451 \begin_layout Description
7452 Action Returns path and file name of the currently edited document.
7455 \begin_layout Description
7456 Syntax server-get-filename
7459 \begin_layout Subsection*
7463 \begin_layout Description
7464 Action Returns the current layout (that is environment) name on the cursor position.
7467 \begin_layout Description
7468 Syntax server-get-layout
7471 \begin_layout Subsection*
7472 server-get-statistics
7475 \begin_layout Description
7476 Action Returns the statistics (number of words and characters) in the document or in the given selection.
7479 \begin_layout Description
7480 Notion Note that this function gives the number of words/chars written, not the number of characters which will be typeset.
7483 \begin_layout Description
7484 Syntax server-get-statistics [<TYPE>]
7487 \begin_layout Description
7488 Params <TYPE>: <words|chars|chars-space> The requested count; if not specified, the three values are returned, separated by a space.
7489 \begin_inset Newline newline
7493 \begin_inset Newline newline
7496 chars: count characters.
7497 \begin_inset Newline newline
7500 chars-space: count characters and spaces.
7503 \begin_layout Description
7504 Origin brokenclock, Oct 10 2014
7507 \begin_layout Subsection*
7511 \begin_layout Description
7512 Action Returns the coordinates of cursor position in the editing area.
7515 \begin_layout Description
7516 Syntax server-get-xy
7519 \begin_layout Subsection*
7520 server-goto-file-row
7523 \begin_layout Description
7524 Action Sets the cursor position in LyX based on the row number of generated TeX file.
7527 \begin_layout Description
7528 Notion This can be useful for DVI inverse-search or detection of the problematic line from LaTeX compilation. Note that before this function can be used export to LaTeX output must occur (in order to map the row numbers).
7531 \begin_layout Description
7532 Syntax server-goto-file-row <FILE[.ext]> <ROW_NUMBER>
7535 \begin_layout Description
7536 Params <FILE>: the path and filename. Environment variables are expanded in the path. In case this LFUN does not work make sure you are giving correct path to the file.
7537 \begin_inset Newline newline
7540 If the file is located inside LyX temporary directory it will be mapped back into the appropriate opened buffer (e.g. for the case of generated .tex file).
7541 \begin_inset Newline newline
7544 .ext: extensions will be automatically replaced by .lyx.
7545 \begin_inset Newline newline
7548 <ROW_NUMBER> The row number of the LaTeX file to which to go.
7551 \begin_layout Description
7552 Sample server-goto-file-row /home/user/example.lyx 41
7553 \begin_inset Newline newline
7556 server-goto-file-row /tmp/lyx_tmpdir.XM3088/lyx_tmpbuf0/example.tex 41
7559 \begin_layout Description
7560 Origin Edmar, 23 Dec 1998
7563 \begin_layout Subsection*
7567 \begin_layout Description
7568 Action Sends notify message about the last key-sequence to client.
7571 \begin_layout Description
7572 Notion This can be used to grab last key-sequence used inside the LyX window. See also Debug extensions section in Additional features manual.
7575 \begin_layout Description
7576 Syntax server-notify
7579 \begin_layout Subsection*
7583 \begin_layout Description
7584 Action Sets the cursor position based on the editing area coordinates (similar to clicking on that point with left mouse button).
7587 \begin_layout Description
7588 Syntax server-set-xy <X> <Y>
7591 \begin_layout Subsection*
7595 \begin_layout Description
7596 Action Set the given LyX color to the color defined by the X11 name given, and optionally a specific color for dark mode.
7599 \begin_layout Description
7600 Notion A new color entry is created if the color is unknown. Color names can be stored as a part of user settings.
7603 \begin_layout Description
7604 Syntax set-color <LYX_NAME> <X11_NAME> [<X11_DARKNAME>]
7607 \begin_layout Description
7608 Origin SLior, 11 Jun 2000
7611 \begin_layout Subsection*
7615 \begin_layout Description
7616 Action Count the statistics (number of words and characters) in the document or in the given selection and display it in a dialog box.
7619 \begin_layout Description
7620 Notion Note that this function gives the number of words/chars written, not the number of characters which will be typeset.
7623 \begin_layout Description
7627 \begin_layout Description
7628 Origin lasgouttes, Jan 27 2004; sanda, Jan 8 2008
7631 \begin_layout Subsection*
7635 \begin_layout Description
7636 Action Checks-in/commits the changes of the registered file to the repository.
7639 \begin_layout Description
7640 Notion In RCS case this also unlocks the file.
7643 \begin_layout Description
7647 \begin_layout Description
7648 Origin Lgb, 1 Jul 1997
7651 \begin_layout Subsection*
7655 \begin_layout Description
7656 Action Checks-out the document for edit (and locks it in some cases).
7659 \begin_layout Description
7663 \begin_layout Description
7664 Origin Lgb, 1 Jul 1997
7667 \begin_layout Subsection*
7671 \begin_layout Description
7672 Action Executes external command. This command is intended to support additional VCS commands.
7675 \begin_layout Description
7676 Syntax vc-command <FLAG> <PATH> <COMMAND>
7679 \begin_layout Description
7680 Params <FLAG>: Flags for the command can be combined together.
7681 \begin_inset Newline newline
7684 U - dUmmy - no flags
7685 \begin_inset Newline newline
7688 D - Doc - need document loaded to proceed
7689 \begin_inset Newline newline
7692 I - dIrty - mark document dirty
7693 \begin_inset Newline newline
7696 R - Reload - ensure that the document is saved and reload it after command execution
7697 \begin_inset Newline newline
7700 M - Message - ask for input string (commit message)
7701 \begin_inset Newline newline
7704 <PATH>: path where to start. $$p will be replaced by the current document path.
7705 \begin_inset Newline newline
7708 <COMMAND>: command to execute. $$i/$$p/$$m will be replaced by the current document(with absolute path)/path/message.
7711 \begin_layout Description
7712 Sample vc-command DR $$p "svn up"
7715 \begin_layout Description
7716 Origin sanda, 13 Jan 2009
7719 \begin_layout Subsection*
7723 \begin_layout Description
7724 Action Compares two revisions of the same file under version control.
7727 \begin_layout Description
7728 Syntax vc-compare [<REV1>] [<REV2>]
7731 \begin_layout Description
7732 Params Revision number either points directly to commit in history or if negative number -x it points to (last commit - x).
7733 \begin_inset Newline newline
7736 In RCS we subtract only in the last number of revision specification. Special case "0" is reserved for the last committed revision.
7737 \begin_inset Newline newline
7741 \begin_inset Newline newline
7744 <REV2>: Newer file. Used only if REV1 > 0.
7745 \begin_inset Newline newline
7748 If no parameter is given, interactive dialog will be shown.
7751 \begin_layout Description
7752 Sample Compare current document against last commit
7753 \begin_inset Newline newline
7757 \begin_inset Newline newline
7760 Compare current document against current revision - 5 commits
7761 \begin_inset Newline newline
7765 \begin_inset Newline newline
7768 Compare revisions 120 and 155
7769 \begin_inset Newline newline
7775 \begin_layout Description
7776 Origin sanda, 12 Feb 2010
7779 \begin_layout Subsection*
7783 \begin_layout Description
7784 Action Copies the document to another name.
7787 \begin_layout Description
7788 Notion Copying with revision history is only supported by SVN. For RCS and CVS it is simulated by adding the document under a new name. Disabled if uncommitted changes exist.
7791 \begin_layout Description
7792 Syntax vc-copy <FILENAME>
7795 \begin_layout Description
7796 Params <FILENAME>: New name of the document.
7797 \begin_inset Newline newline
7800 A file dialog is opened if no filename is given.
7803 \begin_layout Description
7804 Origin gb, 05 Feb 2013
7807 \begin_layout Subsection*
7811 \begin_layout Description
7812 Action Toggles the locking property of the edited file.
7815 \begin_layout Description
7816 Notion This is currently implemented only for SVN.
7819 \begin_layout Description
7820 Syntax vc-locking-toggle
7823 \begin_layout Description
7824 Origin sanda, 25 Jun 2009
7827 \begin_layout Subsection*
7831 \begin_layout Description
7832 Action Register the document as an file inside version control system.
7835 \begin_layout Description
7836 Notion File is registered inside cvs, svn or rcs repository acording to the existence of cvs/svn/rcs entries in the document's directory.
7837 \begin_inset Newline newline
7840 See LyX Additional Features Manual (Version Control Chapter) for additional information.
7843 \begin_layout Description
7847 \begin_layout Description
7848 Origin Lgb, 1 Jul 1997
7851 \begin_layout Subsection*
7855 \begin_layout Description
7856 Action Renames the document to another name.
7859 \begin_layout Description
7860 Notion Renaming with revision history is only supported by SVN. For CVS it is simulated by adding the document under a new name and deleting the old one. For RCS it is not supported. Disabled if uncommitted changes exist.
7863 \begin_layout Description
7864 Syntax vc-rename <FILENAME>
7867 \begin_layout Description
7868 Params <FILENAME>: New name of the document.
7869 \begin_inset Newline newline
7872 A file dialog is opened if no filename is given.
7875 \begin_layout Description
7876 Origin gb, 05 Feb 2013
7879 \begin_layout Subsection*
7883 \begin_layout Description
7884 Action Update the local archive directory in which resides the current document with the remote repository.
7887 \begin_layout Description
7888 Syntax vc-repo-update
7891 \begin_layout Description
7892 Origin sanda, 16 Oct 2009
7895 \begin_layout Subsection*
7899 \begin_layout Description
7900 Action Reverts the document to the last check-in/commit in VCS.
7903 \begin_layout Description
7907 \begin_layout Description
7908 Origin Lgb, 1 Jul 1997
7911 \begin_layout Subsection*
7915 \begin_layout Description
7916 Action Undo last check-in.
7919 \begin_layout Description
7920 Notion This is currently implemented only for RCS.
7923 \begin_layout Description
7927 \begin_layout Description
7928 Origin Lgb, 1 Jul 1997
7931 \begin_layout Section
7932 Hidden Functions (not listed for configuration)
7935 \begin_layout Subsection*
7939 \begin_layout Description
7940 Action Return the current key sequence and available options as a string.
7943 \begin_layout Description
7944 Notion No options are added if no current map exists.
7945 \begin_inset Newline newline
7948 This is probably usable only with connection to lyxserver.
7951 \begin_layout Description
7952 Syntax command-prefix
7955 \begin_layout Subsection*
7959 \begin_layout Description
7960 Action Activates the LyX window.
7963 \begin_layout Description
7964 Notion On Linux and Mac OS, this action brings the LyX window into focus. Such behavior is not allowed by Windows OS so instead the color of the taskbar entry is changed to indicate that the window has changed in some way. This action is useful in combination with reverse search.
7967 \begin_layout Description
7971 \begin_layout Description
7972 Origin skostysh, 4 Aug 2016
7975 \begin_layout Subsection*
7979 \begin_layout Description
7980 Action Inserts the given string (accordingly to the correct keymap).
7983 \begin_layout Description
7984 Notion Automatically replace the currently selected text. Depends on lyxrc settings "auto_region_delete".
7987 \begin_layout Description
7988 Syntax self-insert <STRING>
7991 \begin_layout Subsection*
7995 \begin_layout Description
7996 Action Raises the LyX window.
7999 \begin_layout Description
8000 Notion Brings the LyX window to the front. Such behavior is allowed on Windows only when no other application has focus. This action is used when LyX is in single instance mode.
8003 \begin_layout Description
8007 \begin_layout Description
8008 Origin forenr, 21 Apr 2020