1 # gen_lfuns.py generated this file. For more info see http://www.lyx.org/
7 \renewcommand{\descriptionlabel}[1]{\hspace\labelsep\upshape\bfseries #1:}
8 \renewenvironment{description}{\list{}{%
9 \setlength{\itemsep}{-2pt}
10 \advance\leftmargini6\p@ \itemindent-12\p@
11 \labelwidth\z@ \let\makelabel\descriptionlabel}%
16 \use_default_options false
17 \maintain_unincluded_children false
25 \language_package default
30 \font_typewriter default
32 \font_default_family default
33 \use_non_tex_fonts false
39 \default_output_format default
41 \bibtex_command default
42 \index_command default
43 \paperfontsize default
48 \use_package amsmath 1
49 \use_package amssymb 1
52 \use_package mathdots 0
53 \use_package mathtools 0
55 \use_package stackrel 0
56 \use_package stmaryrd 0
57 \use_package undertilde 0
59 \cite_engine_type default
63 \paperorientation portrait
77 \paragraph_separation indent
78 \paragraph_indentation default
79 \quotes_language english
82 \paperpagestyle default
83 \tracking_changes false
104 \begin_layout Section*
108 \begin_layout Standard
109 This manual documents the
110 \begin_inset Quotes eld
114 \begin_inset Quotes erd
118 These are commands that are used to make LyX perform specific actions.
119 LyX itself uses these functions internally, and every internal action is
123 \begin_layout Standard
124 LFUNs are also used in the files that define keyboard shortcuts, menu or
126 So if you want to change\SpecialChar \slash{}
127 customize the user interface, you need to deal
129 Furthermore, external programs can use LFUNs to communicate with and
130 \begin_inset Quotes eld
134 \begin_inset Quotes erd
138 Finally, you can also issue LFUNs directly via the so called mini-buffer
139 which can be opened via
142 arg "command-execute"
148 \begin_layout Standard
149 In the following, all LFUNs are listed, categorized by function.
152 \begin_layout Section
153 Layout Functions (Font, Layout and Textclass related)
155 \begin_layout Subsection*
158 \begin_layout Description
159 Action Displays list of layout choices.
161 \begin_layout Description
162 Notion In the current (as of 2007) Qt4 frontend, this LFUN opens the dropbox allowing for choice of layout.
164 \begin_layout Description
165 Syntax drop-layouts-choice
168 \begin_layout Subsection*
171 \begin_layout Description
172 Action Splits the current environment with a Separator.
174 \begin_layout Description
175 Syntax environment-split [outer]
177 \begin_layout Description
178 Params outer: If this is given, LyX will split the outermost environment in the current nesting hierarchy.
180 \begin_layout Description
181 Origin spitz, 23 Dec 2012
184 \begin_layout Subsection*
187 \begin_layout Description
188 Action Toggles the bold font (selection-wise) using mathbf in math.
190 \begin_layout Description
194 \begin_layout Subsection*
197 \begin_layout Description
198 Action Toggles the bold font (selection-wise) using boldsymbol in math.
200 \begin_layout Description
201 Syntax font-boldsymbol
204 \begin_layout Subsection*
207 \begin_layout Description
208 Action Reverts the settings of the font to the default values (selection-wise).
210 \begin_layout Description
214 \begin_layout Subsection*
217 \begin_layout Description
218 Action Toggles the emphasis font style (selection-wise).
220 \begin_layout Description
224 \begin_layout Subsection*
227 \begin_layout Description
228 Action Toggles Fraktur family font (math-mode, selection-wise).
230 \begin_layout Description
233 \begin_layout Description
234 Origin vermeer, 10 Jan 2002
237 \begin_layout Subsection*
240 \begin_layout Description
241 Action Toggles Italics font shape (math-mode, selection-wise).
243 \begin_layout Description
246 \begin_layout Description
247 Origin vermeer, 10 Jan 2002
250 \begin_layout Subsection*
253 \begin_layout Description
254 Action Toggles Noun text style font (selection-wise).
256 \begin_layout Description
260 \begin_layout Subsection*
263 \begin_layout Description
264 Action Toggles Roman family font (selection-wise).
266 \begin_layout Description
270 \begin_layout Subsection*
273 \begin_layout Description
274 Action Toggles Sans Serif family font (selection-wise).
276 \begin_layout Description
280 \begin_layout Subsection*
283 \begin_layout Description
284 Action Sets font size according to lyx format string.
286 \begin_layout Description
287 Syntax font-size <SIZE>
289 \begin_layout Description
290 Params <SIZE>: tiny|scriptsize|footnotesize|small|normal|large|larger|
291 \begin_inset Newline newline
294 largest|huge|giant|increase|decrease|default
297 \begin_layout Subsection*
300 \begin_layout Description
301 Action Returns the info about the current font.
303 \begin_layout Description
307 \begin_layout Subsection*
310 \begin_layout Description
311 Action Toggles strikeout (strike-through) in the font (selection-wise).
313 \begin_layout Description
314 Syntax font-strikeout
316 \begin_layout Description
317 Origin sanda, 3 May 2009
320 \begin_layout Subsection*
323 \begin_layout Description
324 Action Toggles the typewriter family font (selection-wise).
326 \begin_layout Description
327 Syntax font-typewriter
330 \begin_layout Subsection*
333 \begin_layout Description
334 Action Toggles underline in the font (selection-wise).
336 \begin_layout Description
337 Syntax font-underline
340 \begin_layout Subsection*
343 \begin_layout Description
344 Action Toggles double underline in the font (selection-wise).
346 \begin_layout Description
347 Syntax font-underunderline
349 \begin_layout Description
350 Origin sanda, 5 May 2009
353 \begin_layout Subsection*
356 \begin_layout Description
357 Action Toggles wavy underline in the font (selection-wise).
359 \begin_layout Description
360 Syntax font-underwave
362 \begin_layout Description
363 Origin sanda, 5 May 2009
366 \begin_layout Subsection*
369 \begin_layout Description
370 Action Sets the layout (that is, environment) for the current paragraph.
372 \begin_layout Description
373 Syntax layout <LAYOUT>
375 \begin_layout Description
376 Params <LAYOUT>: the layout to use
379 \begin_layout Subsection*
382 \begin_layout Description
383 Action Adds a module.
385 \begin_layout Description
386 Notion Adds a module to the list of included modules for the current buffer.
388 \begin_layout Description
389 Syntax layout-module-add <MODULE>
391 \begin_layout Description
392 Params <MODULE>: the module to be added
394 \begin_layout Description
395 Origin rgh, 25 August 2007
398 \begin_layout Subsection*
401 \begin_layout Description
402 Action Clears the module list.
404 \begin_layout Description
405 Notion Clears the list of included modules for the current buffer.
407 \begin_layout Description
408 Syntax layout-modules-clear
410 \begin_layout Description
411 Origin rgh, 25 August 2007
414 \begin_layout Subsection*
417 \begin_layout Description
418 Action Launches the paragraph settings dialog.
420 \begin_layout Description
421 Syntax layout-paragraph
424 \begin_layout Subsection*
427 \begin_layout Description
428 Action Reloads layout information.
430 \begin_layout Description
431 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.
433 \begin_layout Description
436 \begin_layout Description
437 Origin rgh, 3 September 2007
440 \begin_layout Subsection*
443 \begin_layout Description
444 Action Launches the tabular settings dialog.
446 \begin_layout Description
447 Syntax layout-tabular
449 \begin_layout Description
450 Origin Jug, 31 Jul 2000
453 \begin_layout Subsection*
456 \begin_layout Description
457 Action Update fonts and its metrics.
459 \begin_layout Description
460 Notion Automatically called after zoom, dpi, font names, or norm change.
462 \begin_layout Description
463 Syntax screen-font-update
465 \begin_layout Description
466 Origin ARRae, 13 Aug 2000
469 \begin_layout Subsection*
472 \begin_layout Description
473 Action Sets the text class for the current buffer.
475 \begin_layout Description
476 Syntax textclass-apply <TEXTCLASS>
478 \begin_layout Description
479 Params <TEXTCLASS>: the textclass to set. Note that this must be the filename, minus the ".layout" extension.
482 \begin_layout Subsection*
485 \begin_layout Description
486 Action Loads information for a textclass from disk.
488 \begin_layout Description
489 Syntax textclass-load <TEXTCLASS>
491 \begin_layout Description
492 Params <TEXTCLASS>: the textclass to load. Note that this must be the filename, minus the ".layout" extension.
495 \begin_layout Subsection*
498 \begin_layout Description
499 Action Toggle user-defined (=last-time used) text style.
501 \begin_layout Description
502 Notion This style is set via LFUN_TEXTSTYLE_UPDATE, which is automatically triggered when using Text Style dialog.
504 \begin_layout Description
505 Syntax textstyle-apply
507 \begin_layout Description
508 Origin leeming, 12 Mar 2003
511 \begin_layout Subsection*
514 \begin_layout Description
515 Action Apply text style and update the settings to be used by LFUN_TEXTSTYLE_APPLY.
517 \begin_layout Description
518 Syntax textstyle-update <FONT_INFO>
520 \begin_layout Description
521 Params <FONT_INFO>: specifies font atributes, e.g. family, series, shape, size, emph, noun, underbar, number, color, language, toggleall.
522 \begin_inset Newline newline
525 Use lyx -dbg action for exact syntax of text-style dialog parameters.
527 \begin_layout Description
528 Origin leeming, 12 Mar 2003
531 \begin_layout Section
532 Editing Functions (Cursor and Mouse Movement, Copy/Paste etc.)
534 \begin_layout Subsection*
537 \begin_layout Description
538 Action Adds an acute accent to the next character typed.
540 \begin_layout Description
544 \begin_layout Subsection*
547 \begin_layout Description
548 Action Adds a breve accent to the next character typed.
550 \begin_layout Description
554 \begin_layout Subsection*
557 \begin_layout Description
558 Action Adds a caron to the next character typed.
560 \begin_layout Description
564 \begin_layout Subsection*
567 \begin_layout Description
568 Action Adds a cedilla to the next character typed.
570 \begin_layout Description
571 Syntax accent-cedilla
574 \begin_layout Subsection*
577 \begin_layout Description
578 Action Adds a circle accent to the next character typed.
580 \begin_layout Description
584 \begin_layout Subsection*
587 \begin_layout Description
588 Action Adds a circumflex to the next character typed.
590 \begin_layout Description
591 Syntax accent-circumflex
594 \begin_layout Subsection*
597 \begin_layout Description
598 Action Adds a dot accent to the next character typed.
600 \begin_layout Description
604 \begin_layout Subsection*
607 \begin_layout Description
608 Action Adds a grave accent to the next character typed.
610 \begin_layout Description
614 \begin_layout Subsection*
615 accent-hungarian-umlaut
617 \begin_layout Description
618 Action Adds a Hungarian umlaut to the next character typed.
620 \begin_layout Description
624 \begin_layout Subsection*
627 \begin_layout Description
628 Action Adds a macron to the next character typed.
630 \begin_layout Description
634 \begin_layout Subsection*
637 \begin_layout Description
638 Action Adds an ogonek accent to the next character typed.
640 \begin_layout Description
644 \begin_layout Subsection*
647 \begin_layout Description
648 Action Adds a tie over the next two character typed.
650 \begin_layout Description
651 Notion The following char will finish the tie.
653 \begin_layout Description
657 \begin_layout Subsection*
660 \begin_layout Description
661 Action Adds a tilde over the next character typed.
663 \begin_layout Description
667 \begin_layout Subsection*
670 \begin_layout Description
671 Action Adds an umlaut over the next character typed.
673 \begin_layout Description
677 \begin_layout Subsection*
680 \begin_layout Description
681 Action Adds a bar under the next character typed.
683 \begin_layout Description
684 Syntax accent-underbar
687 \begin_layout Subsection*
690 \begin_layout Description
691 Action Adds a dot under the next character typed.
693 \begin_layout Description
694 Syntax accent-underdot
697 \begin_layout Subsection*
700 \begin_layout Description
701 Action Accepts all tracked changes in the document.
703 \begin_layout Description
704 Syntax all-changes-accept
706 \begin_layout Description
707 Origin Levon, 16 Oct 2002
710 \begin_layout Subsection*
713 \begin_layout Description
714 Action Rejects all tracked changes in the document.
716 \begin_layout Description
717 Notion Reject does not work recursively; the user may have to repeat the operation.
719 \begin_layout Description
720 Syntax all-changes-reject
722 \begin_layout Description
723 Origin Levon, 16 Oct 2002
726 \begin_layout Subsection*
729 \begin_layout Description
730 Action Start (or remove) Appendix on the given cursor position.
732 \begin_layout Description
735 \begin_layout Description
736 Origin ettrich, 5 May 1998
739 \begin_layout Subsection*
742 \begin_layout Description
743 Action Inserts an argument (short title) inset.
745 \begin_layout Description
746 Syntax argument-insert <argument nr>
748 \begin_layout Description
749 Params <argument nr>: see layout declarations
751 \begin_layout Description
752 Origin vermeer, 12 Aug 2002
755 \begin_layout Subsection*
758 \begin_layout Description
759 Action Adds database, which will be used for bibtex citations.
761 \begin_layout Description
762 Notion Databases are added to the first BibTeX inset (Inset->List/TOC->BibTeX bibliography) found from the cursor position.
764 \begin_layout Description
765 Syntax bibtex-database-add <DATABASE-NAME>
767 \begin_layout Description
768 Origin Ale, 30 May 1997
771 \begin_layout Subsection*
774 \begin_layout Description
775 Action Adds database, which will be used for bibtex citations.
777 \begin_layout Description
778 Notion Databases are deleted from the first BibTeX inset (Inset->List/TOC->BibTeX bibliography) found from the cursor position.
780 \begin_layout Description
781 Syntax bibtex-database-del <DATABASE-NAME>
783 \begin_layout Description
784 Origin Ale, 30 May 1997
787 \begin_layout Subsection*
790 \begin_layout Description
791 Action Clears the list of saved bookmarks.
793 \begin_layout Description
794 Syntax bookmark-clear
796 \begin_layout Description
797 Origin bpeng, 31 October 2006
800 \begin_layout Subsection*
803 \begin_layout Description
804 Action Moves the cursor to the numbered bookmark, opening the file if necessary. Note that bookmarks are saved per-session, not per file.
806 \begin_layout Description
807 Notion Bookmark 0 has a special purpose. It is automatically set
808 \begin_inset Newline newline
811 1. to the paragraph you are currently editing
812 \begin_inset Newline newline
815 2. to the paragraph from where you are jumping to the last-edited position (jump-back feature)
816 \begin_inset Newline newline
819 3. when jumping from crossreference to the requested label by LFUN_LABEL_GOTO.
821 \begin_layout Description
822 Syntax bookmark-goto <NUMBER>
824 \begin_layout Description
825 Params <NUMBER>: the number of the bookmark to restore.
827 \begin_layout Description
828 Origin Dekel, 27 January 2001
831 \begin_layout Subsection*
834 \begin_layout Description
835 Action Save a bookmark.
837 \begin_layout Description
838 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.
840 \begin_layout Description
841 Syntax bookmark-save <NUMBER>
843 \begin_layout Description
844 Params <NUMBER>: the number of the bookmark to save.
846 \begin_layout Description
847 Origin Dekel, 27 January 2001
850 \begin_layout Subsection*
853 \begin_layout Description
854 Action Inserts Box inset.
856 \begin_layout Description
857 Syntax box-insert [<TYPE>]
859 \begin_layout Description
860 Params <TYPE>: Boxed|Frameless|Framed|ovalbox|Ovalbox|Shadowbox|Shaded|Doublebox
861 \begin_inset Newline newline
864 Framed is the default one.
866 \begin_layout Description
867 Origin vermeer, 7 Oct 2003
870 \begin_layout Subsection*
873 \begin_layout Description
874 Action Inserts branch inset.
876 \begin_layout Description
877 Syntax branch-insert <BRANCH-NAME>
879 \begin_layout Description
880 Origin vermeer, 17 Aug 2003
883 \begin_layout Subsection*
886 \begin_layout Description
887 Action Move the cursor to the beginning of the document.
889 \begin_layout Description
893 \begin_layout Subsection*
896 \begin_layout Description
897 Action Move the cursor to the beginning of the document adding the traversed text to the selection.
899 \begin_layout Description
900 Syntax buffer-begin-select
903 \begin_layout Subsection*
906 \begin_layout Description
907 Action Move the cursor to the end of the document.
909 \begin_layout Description
913 \begin_layout Subsection*
916 \begin_layout Description
917 Action Move the cursor to the end of the document adding the traversed text to the selection.
919 \begin_layout Description
920 Syntax buffer-end-select
923 \begin_layout Subsection*
926 \begin_layout Description
927 Action Inserts a caption inset.
929 \begin_layout Description
930 Syntax caption-insert
932 \begin_layout Description
933 Origin Lgb, 18 Jul 2000
936 \begin_layout Subsection*
939 \begin_layout Description
940 Action Moves the cursor to the previous cell inside the table.
942 \begin_layout Description
945 \begin_layout Description
946 Origin Jug, 22 May 2000
949 \begin_layout Subsection*
952 \begin_layout Description
953 Action Moves the cursor to the next cell inside the table.
955 \begin_layout Description
959 \begin_layout Subsection*
962 \begin_layout Description
963 Action Splits cell and shifts right part to the next cell (inside the math grid).
965 \begin_layout Description
968 \begin_layout Description
969 Origin Ale, 15 May 1997
972 \begin_layout Subsection*
975 \begin_layout Description
976 Action Accepts tracked change inside the selection.
978 \begin_layout Description
981 \begin_layout Description
982 Origin Levon, 16 Oct 2002
985 \begin_layout Subsection*
988 \begin_layout Description
989 Action Moves the cursor to the position of the next change of the change tracking records.
991 \begin_layout Description
994 \begin_layout Description
995 Origin schmitt, 4 Oct 2006
998 \begin_layout Subsection*
1001 \begin_layout Description
1002 Action Moves the cursor to the position of the previous change of the change tracking records.
1004 \begin_layout Description
1005 Syntax change-previous
1007 \begin_layout Description
1008 Origin vfr, 4 Apr 2009
1011 \begin_layout Subsection*
1014 \begin_layout Description
1015 Action Rejects tracked change inside the selection.
1017 \begin_layout Description
1018 Syntax change-reject
1020 \begin_layout Description
1021 Origin Levon, 16 Oct 2002
1024 \begin_layout Subsection*
1027 \begin_layout Description
1028 Action Open change tracking dialog for merging and moves the cursor to the position of the next change.
1030 \begin_layout Description
1031 Syntax changes-merge
1033 \begin_layout Description
1034 Origin Levon, 16 Oct 2002
1037 \begin_layout Subsection*
1040 \begin_layout Description
1041 Action Toggles showing of change tracking in typeset output.
1043 \begin_layout Description
1044 Syntax changes-output
1046 \begin_layout Description
1047 Origin jspitzm, 21 Jan 2005
1050 \begin_layout Subsection*
1053 \begin_layout Description
1054 Action Toggles change tracking to on/off.
1056 \begin_layout Description
1057 Syntax changes-track
1059 \begin_layout Description
1060 Origin levon, 1 Oct 2002
1063 \begin_layout Subsection*
1066 \begin_layout Description
1067 Action Moves the cursor one position logically backwards.
1069 \begin_layout Description
1070 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.
1072 \begin_layout Description
1073 Syntax char-backward
1076 \begin_layout Subsection*
1077 char-backward-select
1079 \begin_layout Description
1080 Action Moves the cursor one position logically backwards, adding traversed position to the selection.
1082 \begin_layout Description
1083 Notion See also LFUN_CHAR_BACKWARD.
1085 \begin_layout Description
1086 Syntax char-backward-select
1089 \begin_layout Subsection*
1090 char-delete-backward
1092 \begin_layout Description
1093 Action Deletes one character in the backward direction (usually the "BackSpace" key).
1095 \begin_layout Description
1096 Syntax char-delete-backward
1099 \begin_layout Subsection*
1102 \begin_layout Description
1103 Action Deletes one character in the backward direction (usually the "Delete" key).
1105 \begin_layout Description
1106 Syntax char-delete-forward
1109 \begin_layout Subsection*
1112 \begin_layout Description
1113 Action Moves the cursor one position logically forward.
1115 \begin_layout Description
1116 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.
1118 \begin_layout Description
1122 \begin_layout Subsection*
1125 \begin_layout Description
1126 Action Moves the cursor one position logically forward, adding traversed position to the selection.
1128 \begin_layout Description
1129 Notion See also LFUN_CHAR_FORWARD.
1131 \begin_layout Description
1132 Syntax char-forward-select
1135 \begin_layout Subsection*
1138 \begin_layout Description
1139 Action Moves the cursor one position "to the left".
1141 \begin_layout Description
1142 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.
1144 \begin_layout Description
1148 \begin_layout Subsection*
1151 \begin_layout Description
1152 Action Moves the cursor one position "to the left", adding traversed position to the selection.
1154 \begin_layout Description
1155 Notion See also LFUN_CHAR_LEFT for exact details of the movement.
1157 \begin_layout Description
1158 Syntax char-left-select
1161 \begin_layout Subsection*
1164 \begin_layout Description
1165 Action Moves the cursor one position "to the right".
1167 \begin_layout Description
1168 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.
1170 \begin_layout Description
1174 \begin_layout Subsection*
1177 \begin_layout Description
1178 Action Moves the cursor one position "to the right", adding traversed position to the selection.
1180 \begin_layout Description
1181 Notion See also LFUN_CHAR_RIGHT for exact details of the movement.
1183 \begin_layout Description
1184 Syntax char-right-select
1187 \begin_layout Subsection*
1190 \begin_layout Description
1191 Action Transposes the character at the cursor with the one before it.
1193 \begin_layout Description
1194 Syntax chars-transpose
1196 \begin_layout Description
1197 Origin Lgb, 25 Apr 2001
1200 \begin_layout Subsection*
1203 \begin_layout Description
1204 Action Inserts citation from loaded citation database.
1206 \begin_layout Description
1207 Syntax citation-insert [<KEY>[|<TEXT_BEFORE>]]
1209 \begin_layout Description
1210 Params <KEY>: Citation (shortcut listed in available citations).
1211 \begin_inset Newline newline
1214 <TEXT_BEFORE>: text which should appear before citation.
1216 \begin_layout Description
1217 Origin AAS, 97-02-23
1220 \begin_layout Subsection*
1223 \begin_layout Description
1224 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.
1226 \begin_layout Description
1227 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.
1229 \begin_layout Description
1230 Syntax clipboard-paste [<ARG>]
1232 \begin_layout Description
1233 Params <ARG>: "paragraph" will cause pasting as one paragraph, i.e. "Join lines".
1235 \begin_layout Description
1236 Origin Georg, 10 Jul 2006
1239 \begin_layout Subsection*
1240 clipboard-paste-simple
1242 \begin_layout Description
1243 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.
1245 \begin_layout Description
1246 Syntax clipboard-paste-simple [<ARG>]
1248 \begin_layout Description
1249 Params <ARG>: "paragraph" will cause pasting as one paragraph, i.e. "Join lines".
1252 \begin_layout Subsection*
1255 \begin_layout Description
1256 Action Switches the focus to the minibuffer so that the user can type in there. If necessary, it opens the minibuffer toolbar.
1258 \begin_layout Description
1259 Notion Usually bound to M-x shortcut.
1261 \begin_layout Description
1262 Syntax command-execute
1265 \begin_layout Subsection*
1268 \begin_layout Description
1269 Action Try to complete the word or command at the cursor position.
1271 \begin_layout Description
1274 \begin_layout Description
1275 Origin sts, Feb 19 2008
1278 \begin_layout Subsection*
1281 \begin_layout Description
1282 Action Accept suggested completion.
1284 \begin_layout Description
1285 Syntax completion-accept
1287 \begin_layout Description
1288 Origin sanda, Sep 08 2008
1291 \begin_layout Subsection*
1294 \begin_layout Description
1295 Action Try to cancel completion, either the popup or the inline completion.
1297 \begin_layout Description
1298 Syntax completion-cancel
1300 \begin_layout Description
1301 Origin sts, Sep 07 2008
1304 \begin_layout Subsection*
1307 \begin_layout Description
1308 Action Show the inline completion at the cursor position.
1310 \begin_layout Description
1311 Syntax completion-inline
1313 \begin_layout Description
1314 Origin sts, Feb 19 2008
1317 \begin_layout Subsection*
1320 \begin_layout Description
1321 Action Show the completion popup at the cursor position.
1323 \begin_layout Description
1324 Syntax completion-popup
1326 \begin_layout Description
1327 Origin sts, Feb 19 2008
1330 \begin_layout Subsection*
1333 \begin_layout Description
1334 Action Copies the current selection to the clipboard.
1336 \begin_layout Description
1340 \begin_layout Subsection*
1343 \begin_layout Description
1344 Action Cuts to the clipboard.
1346 \begin_layout Description
1350 \begin_layout Subsection*
1353 \begin_layout Description
1354 Action Inserts the current date.
1356 \begin_layout Description
1357 Syntax date-insert [<ARG>]
1359 \begin_layout Description
1360 Params <ARG>: Format of date. The default value (%x) can be set in Preferences->Date format. For possible formats see manual page of strftime function.
1362 \begin_layout Description
1363 Origin jdblair, 31 Jan 2000
1366 \begin_layout Subsection*
1369 \begin_layout Description
1370 Action Decrease the nesting depth of the (selected) paragraph(s) inside lists.
1372 \begin_layout Description
1373 Syntax depth-decrement
1376 \begin_layout Subsection*
1379 \begin_layout Description
1380 Action Increase the nesting depth of the (selected) paragraph(s) inside lists.
1382 \begin_layout Description
1383 Syntax depth-increment
1386 \begin_layout Subsection*
1387 dialog-disconnect-inset
1389 \begin_layout Description
1390 Action Closes opened connection to opened inset.
1392 \begin_layout Description
1393 Notion Connection is used for apply functions.
1395 \begin_layout Description
1396 Syntax dialog-disconnect-inset <INSET-NAME>
1398 \begin_layout Description
1399 Origin leeming, 25 Feb 2003
1402 \begin_layout Subsection*
1405 \begin_layout Description
1406 Action Hides showed dialog. Counterpart to LFUN_DIALOG_SHOW .
1408 \begin_layout Description
1409 Syntax dialog-hide <NAME>
1411 \begin_layout Description
1412 Params See LFUN_DIALOG_SHOW .
1414 \begin_layout Description
1415 Origin leeming, 25 Feb 2003
1418 \begin_layout Subsection*
1421 \begin_layout Description
1422 Action Shows hidden dialog or creates new one for a given function/inset settings etc.
1424 \begin_layout Description
1425 Syntax dialog-show <NAME> [<DATA>]
1427 \begin_layout Description
1428 Params <NAME>: aboutlyx|bibitem|bibtex|box|branch|changes|character|citation|
1429 \begin_inset Newline newline
1432 compare|document|errorlist|ert|external|file|findreplace|findreplaceadv|float|
1433 \begin_inset Newline newline
1436 graphics|href|include|index|index_print|info|label|line|listings|log|mathdelimiter|
1437 \begin_inset Newline newline
1440 mathmatrix|mathspace|nomenclature|nomencl_print|note|paragraph|phantom|prefs|
1441 \begin_inset Newline newline
1444 print|ref|sendto|space|spellchecker|symbols|tabular|tabularcreate|
1445 \begin_inset Newline newline
1448 thesaurus|texinfo|toc|view-source|vspace|wrap|<SPECIAL>
1449 \begin_inset Newline newline
1452 <SPECIAL>: latexlog|vclog
1453 \begin_inset Newline newline
1456 <DATA>: data, usually settings for the given dialog. Use debug mode for the details.
1458 \begin_layout Description
1459 Origin leeming, 17 Jun 2003
1462 \begin_layout Subsection*
1463 dialog-show-new-inset
1465 \begin_layout Description
1466 Action Shows hidden dialog or create new one for a given inset settings etc.
1468 \begin_layout Description
1469 Notion Internally uses LFUN_DIALOG_SHOW with processed data for a given inset.
1471 \begin_layout Description
1472 Syntax dialog-show-new-inset <NAME> [<DATA>]
1474 \begin_layout Description
1475 Params See LFUN_DIALOG_SHOW .
1477 \begin_layout Description
1478 Origin leeming, 25 Feb 2003
1481 \begin_layout Subsection*
1484 \begin_layout Description
1485 Action Toggles dialog between showed/hidden state.
1487 \begin_layout Description
1488 Notion Internally uses LFUN_DIALOG_SHOW , LFUN_DIALOG_HIDE .
1490 \begin_layout Description
1491 Syntax dialog-toggle <NAME> [<DATA>]
1493 \begin_layout Description
1494 Params See LFUN_DIALOG_SHOW .
1496 \begin_layout Description
1497 Origin JSpitzm, 30 Apr 2007
1500 \begin_layout Subsection*
1503 \begin_layout Description
1504 Action Updates the dialog values from the inset/paragraph/document.
1506 \begin_layout Description
1507 Syntax dialog-update <NAME>
1509 \begin_layout Description
1510 Params <NAME>: paragraph|prefs|<INSET>
1511 \begin_inset Newline newline
1516 \begin_layout Description
1517 Origin leeming, 25 Feb 2003
1520 \begin_layout Subsection*
1523 \begin_layout Description
1524 Action Moves the cursor one line in downward direction.
1526 \begin_layout Description
1530 \begin_layout Subsection*
1533 \begin_layout Description
1534 Action Moves the cursor one line in downward direction adding the current position to the selection.
1536 \begin_layout Description
1540 \begin_layout Subsection*
1543 \begin_layout Description
1544 Action Inserts an ERT inset.
1546 \begin_layout Description
1549 \begin_layout Description
1550 Origin Jug, 18 Feb 2000
1553 \begin_layout Subsection*
1556 \begin_layout Description
1557 Action Clears the selection. If no text is selected call LFUN_FINISHED_FORWARD. Inside math mode jumps out of the math inset.
1559 \begin_layout Description
1562 \begin_layout Description
1563 Origin Lgb, 17 May 2001
1566 \begin_layout Subsection*
1569 \begin_layout Description
1570 Action Inserts another LyX file.
1572 \begin_layout Description
1573 Syntax file-insert [<FILE>]
1575 \begin_layout Description
1576 Params <FILE>: Filename to be inserted.
1579 \begin_layout Subsection*
1580 file-insert-plaintext
1582 \begin_layout Description
1583 Action Inserts plain text file.
1585 \begin_layout Description
1586 Syntax file-insert-plaintext [<FILE>]
1588 \begin_layout Description
1589 Params <FILE>: Filename to be inserted.
1591 \begin_layout Description
1592 Origin CFO-G, 19 Nov 1997
1595 \begin_layout Subsection*
1596 file-insert-plaintext-para
1598 \begin_layout Description
1599 Action Inserts plain text file as paragraph (i.e. join lines).
1601 \begin_layout Description
1602 Syntax file-insert-plaintext-para [<FILE>]
1604 \begin_layout Description
1605 Params <FILE>: Filename to be inserted.
1607 \begin_layout Description
1608 Origin Levon, 14 Feb 2001
1611 \begin_layout Subsection*
1614 \begin_layout Description
1615 Action Inserts CharStyle, Custom inset or XML short element.
1617 \begin_layout Description
1618 Notion Look into the Customization manual for more information about these elements.
1619 \begin_inset Newline newline
1622 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.
1623 \begin_inset Newline newline
1626 For dissolving the element see LFUN_INSET_DISSOLVE.
1628 \begin_layout Description
1629 Syntax flex-insert Name
1631 \begin_layout Description
1632 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.
1634 \begin_layout Description
1635 Sample flex-insert Code
1638 \begin_layout Subsection*
1641 \begin_layout Description
1642 Action Inserts a float inset.
1644 \begin_layout Description
1645 Syntax float-insert <TYPE>
1647 \begin_layout Description
1648 Params <TYPE>: type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given.
1650 \begin_layout Description
1651 Origin Lgb, 27 Jun 2000
1654 \begin_layout Subsection*
1657 \begin_layout Description
1658 Action Inserts the list of floats in the document.
1660 \begin_layout Description
1661 Syntax float-list-insert <TYPE>
1663 \begin_layout Description
1664 Params <TYPE>: type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given.
1666 \begin_layout Description
1667 Origin Lgb, 3 May 2001
1670 \begin_layout Subsection*
1673 \begin_layout Description
1674 Action Inserts float insets as in LFUN_FLOAT_INSERT but span multiple columns.
1676 \begin_layout Description
1677 Notion Corresponds to the starred floats (figure*, table*, etc.) in LaTeX.
1679 \begin_layout Description
1680 Syntax float-wide-insert <TYPE>
1682 \begin_layout Description
1683 Params <TYPE>: type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given.
1685 \begin_layout Description
1686 Origin Lgb, 31 Oct 2001
1689 \begin_layout Subsection*
1692 \begin_layout Description
1693 Action Inserts a footnote inset.
1695 \begin_layout Description
1696 Syntax footnote-insert
1698 \begin_layout Description
1699 Origin Jug, 7 Mar 2000
1702 \begin_layout Subsection*
1705 \begin_layout Description
1706 Action Reloads the image if necessary.
1708 \begin_layout Description
1709 Syntax graphics-reload
1711 \begin_layout Description
1712 Origin vfr, 10 Aug 2009
1715 \begin_layout Subsection*
1718 \begin_layout Description
1719 Action Inserts hyperlinks into the document (clickable in pdf output).
1721 \begin_layout Description
1722 Notion Hyperlink target can be set via selection + hyperlink-insert function.
1724 \begin_layout Description
1725 Syntax href-insert [<TARGET>]
1727 \begin_layout Description
1728 Origin CFO-G, 21 Nov 1997
1731 \begin_layout Subsection*
1734 \begin_layout Description
1735 Action Only active in IPA inset.
1737 \begin_layout Description
1738 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.
1740 \begin_layout Description
1743 \begin_layout Description
1744 Origin spitz, 20 May 2012
1747 \begin_layout Subsection*
1750 \begin_layout Description
1751 Action Inserts Index entry.
1753 \begin_layout Description
1754 Notion It automatically takes the word on the cursor position.
1756 \begin_layout Description
1757 Syntax index-insert [<TYPE:Name>]
1759 \begin_layout Description
1760 Params <TYPE:Name>: name of the index, if multiple indices are defined. With an empty argument, the default index is selected.
1762 \begin_layout Description
1763 Origin leeming, 3 Aug 2000
1766 \begin_layout Subsection*
1769 \begin_layout Description
1770 Action Inserts list of Index entries on a new page.
1772 \begin_layout Description
1773 Syntax index-print [<TYPE:Name>]
1775 \begin_layout Description
1776 Params <TYPE:Name>: name of the index, if multiple indices are defined. With an empty argument, the default index is selected.
1778 \begin_layout Description
1779 Origin Lgb, 27 Feb 1997
1782 \begin_layout Subsection*
1785 \begin_layout Description
1786 Action Displays shortcuts, lyxrc, package and textclass availability and menu information in a non-editable boxed InsetText.
1788 \begin_layout Description
1789 Notion Apart from lfun arguments you can use the following method:
1790 \begin_inset Newline newline
1793 1. input the type and argument of this inset, e.g. "menu paste", in the work area.
1794 \begin_inset Newline newline
1797 2. select the text and run info-insert lfun.
1799 \begin_layout Description
1800 Syntax info-insert <TYPE> <ARG>
1802 \begin_layout Description
1803 Params <TYPE>: shortcut[s]|lyxrc|lyxinfo|package|textclass|menu|buffer
1804 \begin_inset Newline newline
1807 <ARG>: argument for a given type. Look into InsetInfo.h for detailed description.
1808 \begin_inset Newline newline
1811 shortcut[s]: name of lfun (e.g math-insert
1814 \begin_inset Newline newline
1817 lyxrc: name of rc_entry (e.g. bind_file)
1818 \begin_inset Newline newline
1821 lyxinfo: "version" - used version of LyX
1822 \begin_inset Newline newline
1825 package: name of latex package (e.g. listings)
1826 \begin_inset Newline newline
1829 textclass: name of textclass (e.g. article)
1830 \begin_inset Newline newline
1833 menu: name of lfun used in menu
1834 \begin_inset Newline newline
1837 icon: icon of lfun used in toolbar
1838 \begin_inset Newline newline
1841 buffer: "name"|"path"|"class"|"vcs-tree-revision"| "vcs-revision"|"vcs-author"|"vcs-date"|"vcs-time"
1843 \begin_layout Description
1844 Sample command-sequence info-insert buffer path; info-insert buffer name
1846 \begin_layout Description
1847 Origin bpeng, 7 Oct 2007
1850 \begin_layout Subsection*
1853 \begin_layout Description
1854 Action Apply data for an inset.
1856 \begin_layout Description
1857 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.
1859 \begin_layout Description
1860 Syntax inset-apply <ARGS>
1862 \begin_layout Description
1863 Params See LFUN_INSET_INSERT .
1866 \begin_layout Subsection*
1869 \begin_layout Description
1870 Action Move the cursor to the beginning of the current inset if it is not already there, or at the beginning of the enclosing inset otherwise
1872 \begin_layout Description
1875 \begin_layout Description
1876 Origin lasgouttes, 16 Mar 2009
1879 \begin_layout Subsection*
1882 \begin_layout Description
1883 Action Move the cursor to the beginning of the current inset if it is not already there, or at the beginning of the enclosing inset otherwise (adding the traversed text to the selection).
1885 \begin_layout Description
1886 Syntax inset-begin-select
1888 \begin_layout Description
1889 Origin lasgouttes, 16 Mar 2009
1892 \begin_layout Subsection*
1895 \begin_layout Description
1896 Action Copies the inset to the clipboard as a certain type.
1898 \begin_layout Description
1899 Notion Currently used only for InsetInfo where its content is copied as a text.
1901 \begin_layout Description
1902 Syntax inset-copy-as
1904 \begin_layout Description
1905 Origin vfr, 18 Apr 2010
1908 \begin_layout Subsection*
1911 \begin_layout Description
1912 Action Dissolve the current inset into text.
1914 \begin_layout Description
1915 Syntax inset-dissolve [<INSET>]
1917 \begin_layout Description
1918 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.
1919 \begin_inset Newline newline
1922 For values see lyx::InsetLayout::lyxtype_ .
1924 \begin_layout Description
1925 Origin JSpitz, 7 Aug 2006
1928 \begin_layout Subsection*
1931 \begin_layout Description
1932 Action Edit the inset at cursor with an external application, if one is attributed.
1934 \begin_layout Description
1935 Syntax inset-edit [<INSET_PARAMS>]
1937 \begin_layout Description
1938 Params <INSET_PARAMS>: Parameters for the inset.
1939 \begin_inset Newline newline
1942 Currently only the filename will be considered.
1944 \begin_layout Description
1945 Origin JSpitzm, 27 Apr 2006
1948 \begin_layout Subsection*
1951 \begin_layout Description
1952 Action Move the cursor to the end of the current inset if it is not already there, or at the end of the enclosing inset otherwise
1954 \begin_layout Description
1957 \begin_layout Description
1958 Origin lasgouttes, 16 Mar 2009
1961 \begin_layout Subsection*
1964 \begin_layout Description
1965 Action Move the cursor to the end of the current inset if it is not already there, or at the end of the enclosing inset otherwise (adding the traversed text to the selection).
1967 \begin_layout Description
1968 Syntax inset-end-select
1970 \begin_layout Description
1971 Origin lasgouttes, 16 Mar 2009
1974 \begin_layout Subsection*
1977 \begin_layout Description
1978 Action Apply the given commands on insets of a given name.
1980 \begin_layout Description
1981 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.
1983 \begin_layout Description
1984 Syntax inset-forall <NAME> <LFUN-COMMAND>
1985 \begin_inset Newline newline
1988 <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.
1990 \begin_layout Description
1991 Sample Remove all index insets:
1992 \begin_inset Newline newline
1995 inset-forall Index char-delete-forward
1996 \begin_inset Newline newline
1999 Close all Notes (also works for a particular branch, for example):
2000 \begin_inset Newline newline
2003 inset-forall Note inset-toggle close
2004 \begin_inset Newline newline
2007 Transform all yellow notes to comments
2008 \begin_inset Newline newline
2011 inset-forall Note:Note inset-modify note Note Comment
2012 \begin_inset Newline newline
2015 Try to put LyX in an infinite loop if there is at least a Note:
2016 \begin_inset Newline newline
2019 inset-forall Note char-backward
2021 \begin_layout Description
2022 Origin lasgouttes, 27 Nov 2009
2025 \begin_layout Subsection*
2028 \begin_layout Description
2029 Action Insert new inset (type given by the parameters).
2031 \begin_layout Description
2032 Syntax inset-insert <INSET> <ARGS>
2034 \begin_layout Description
2035 Params <INSET>: <bibitem|bibtex|citation|ert|listings|external|graphics|tabular|
2036 \begin_inset Newline newline
2039 hyperlink|include|index|label|line|nomencl|vspace|ref|toc|script>
2040 \begin_inset Newline newline
2043 <ARGS>: depends on the given inset. Use "lyx -dbg action" to explore.
2045 \begin_layout Description
2046 Sample inset-insert ref LatexCommand <Format> reference "<label name>"
2049 \begin_inset Newline newline
2052 where <label name> is the name of the referenced label and <Format> is one of the following:
2053 \begin_inset Newline newline
2057 \begin_inset Newline newline
2060 eqref -- (<reference>)
2061 \begin_inset Newline newline
2065 \begin_inset Newline newline
2068 vpageref -- on <page>
2069 \begin_inset Newline newline
2072 vref -- <reference> on <page>
2073 \begin_inset Newline newline
2076 formatted -- Formatted reference
2079 \begin_layout Subsection*
2082 \begin_layout Description
2083 Action Modify some properties of an inset.
2085 \begin_layout Description
2086 Notion Used for bibitem, bibtex, box, branch, command, ert, external, floats, graphics, include, index, info, label, listings, newline, newpage, nomencl, note, phantom, ref, space, tabular, vspace, wrap insets.
2088 \begin_layout Description
2089 Syntax inset-modify <INSET> <ARGS>inset-modify changetype <TYPE>inset-modify tabular <FEATURE> [<ARG>]
2091 \begin_layout Description
2092 Params Generally see LFUN_INSET_INSERT for further details.
2093 \begin_inset Newline newline
2096 In case that <INSET> is "tabular" various math-environment features are handled as well, e.g. add-vline-left/right for the Grid/Array environment.
2097 \begin_inset Newline newline
2100 <FEATURE>: append-row|append-column|delete-row|delete-column|copy-row|
2101 \begin_inset Newline newline
2104 copy-column|move-column-right|move-column-left|move-row-down|move-row-up|
2105 \begin_inset Newline newline
2108 toggle-line-top|toggle-line-bottom|toggle-line-left|toggle-line-right|
2109 \begin_inset Newline newline
2112 align-left|align-right|align-center|align-block|align-decimal|set-decimal-point|
2113 \begin_inset Newline newline
2116 valign-top|valign-bottom|valign-middle|longtabular-align-left|
2117 \begin_inset Newline newline
2120 longtabular-align-center|longtabular-align-right|m-align-left|m-align-right|
2121 \begin_inset Newline newline
2124 m-align-center|m-valign-top|m-valign-bottom|m-valign-middle|multicolumn|
2125 \begin_inset Newline newline
2128 set-all-lines|unset-all-lines|set-longtabular|unset-longtabular|set-pwidth|
2129 \begin_inset Newline newline
2132 set-mpwidth|set-rotate-tabular|unset-rotate-tabular|toggle-rotate-tabular|
2133 \begin_inset Newline newline
2136 set-rotate-cell|unset-rotate-cell|toggle-rotate-cell|set-usebox|set-lthead|
2137 \begin_inset Newline newline
2140 unset-lthead|set-ltfirsthead|unset-ltfirsthead|set-ltfoot|unset-ltfoot|
2141 \begin_inset Newline newline
2144 set-ltlastfoot|unset-ltlastfoot|set-ltnewpage|toggle-ltcaption|
2145 \begin_inset Newline newline
2148 set-special-column|set-special-multicolumn|set-special-multirow|
2149 \begin_inset Newline newline
2152 set-booktabs|unset-booktabs|set-top-space|set-bottom-space|
2153 \begin_inset Newline newline
2156 set-interline-space|set-border-lines|tabular-valign-top|
2157 \begin_inset Newline newline
2160 tabular-valign-middle|tabular-valign-bottom|set-tabular-width <ARG>: additional argument for some commands, use debug mode to explore its values.
2162 \begin_layout Description
2163 Sample inset-modify note Note Comment
2164 \begin_inset Newline newline
2167 inset-modify changetype Ovalbox
2170 \begin_layout Subsection*
2173 \begin_layout Description
2174 Action Selects all contents of an inset.
2176 \begin_layout Description
2177 Syntax inset-select-all
2179 \begin_layout Description
2180 Origin vfr, 22 Aug 2009
2183 \begin_layout Subsection*
2186 \begin_layout Description
2187 Action Open the inset's properties dialog.
2189 \begin_layout Description
2190 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.
2192 \begin_layout Description
2193 Syntax inset-settings <INSET>
2195 \begin_layout Description
2196 Params <INSET>: <bibitem|bibtex|box|branch|citation|ert|external|float|
2197 \begin_inset Newline newline
2200 graphics|href|include|index|index_print|label|line|
2201 \begin_inset Newline newline
2204 listings|note|phantom|ref|space|tabular|vspace|wrap>.
2207 \begin_layout Subsection*
2210 \begin_layout Description
2211 Action Toggles the collapsible inset at cursor position, or the inset we are currently in.
2213 \begin_layout Description
2214 Syntax inset-toggle [<ARG>]
2216 \begin_layout Description
2217 Params <ARG>: <open|close|toggle|assign>.
2218 \begin_inset Newline newline
2221 open/close/toggle are for collapsible insets. toggle is used when no argument is given.
2222 \begin_inset Newline newline
2225 assign synchronize the branch-inset with activation status of the branch. Used for global toggling when changed activation.
2227 \begin_layout Description
2228 Origin lasgouttes, 19 Jul 2001
2231 \begin_layout Subsection*
2234 \begin_layout Description
2235 Action Inserts an IPA inset.
2237 \begin_layout Description
2240 \begin_layout Description
2241 Origin spitz, 05 Mar 2012
2244 \begin_layout Subsection*
2247 \begin_layout Description
2248 Action Inserts special IPA macros into the document.
2250 \begin_layout Description
2251 Syntax ipamacro-insert <CHAR>
2253 \begin_layout Description
2254 Params <CHAR>: tone-falling, tone-rising, tone-high-rising, tone-low-rising, tone-high-rising-falling, deco bottomtiebar, deco toptiebar.
2256 \begin_layout Description
2257 Origin JSpitzm, 22 Aug 2012
2260 \begin_layout Subsection*
2263 \begin_layout Description
2264 Action Turn off the loaded keyboard map.
2266 \begin_layout Description
2270 \begin_layout Subsection*
2273 \begin_layout Description
2274 Action Turn on the primary keyboard map.
2276 \begin_layout Description
2277 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.
2278 \begin_inset Newline newline
2281 The language is to be set in the Preferences dialog.
2283 \begin_layout Description
2284 Syntax keymap-primary
2287 \begin_layout Subsection*
2290 \begin_layout Description
2291 Action Turn on the secondary keyboard map.
2293 \begin_layout Description
2294 Syntax keymap-secondary
2297 \begin_layout Subsection*
2300 \begin_layout Description
2301 Action Toggles keyboard maps (first/second/off).
2303 \begin_layout Description
2304 Syntax keymap-toggle
2306 \begin_layout Description
2307 Origin leeming, 30 Mar 2004
2310 \begin_layout Subsection*
2311 label-copy-as-reference
2313 \begin_layout Description
2314 Action Copies the label at the cursor as a cross-reference to be pasted elsewhere.
2316 \begin_layout Description
2317 Syntax copy-label-as-reference <LABEL>
2319 \begin_layout Description
2320 Params <LABEL>: The label to copy (for multi-line math)
2322 \begin_layout Description
2323 Origin sts, 16 Nov 2008
2326 \begin_layout Subsection*
2329 \begin_layout Description
2330 Action Goto a label.
2332 \begin_layout Description
2333 Syntax label-goto [<LABEL>]
2335 \begin_layout Description
2336 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.
2338 \begin_layout Description
2339 Origin Ale, 6 Aug 1997
2342 \begin_layout Subsection*
2345 \begin_layout Description
2346 Action Inserts label to text or displayed formula.
2348 \begin_layout Description
2349 Syntax label-insert [<LABEL>]
2351 \begin_layout Description
2352 Params <LABEL>: Requested label. If no label is given dialog requesting name will be opened.
2355 \begin_layout Subsection*
2356 label-insert-as-reference
2358 \begin_layout Description
2359 Action Inserts the label (in ToC pane) as a cross-reference at the position of the cursor.
2361 \begin_layout Description
2362 Syntax label-insert-as-reference
2364 \begin_layout Description
2365 Origin vfr, 7 Apr 2009
2368 \begin_layout Subsection*
2371 \begin_layout Description
2372 Action Set language from the current cursor position.
2374 \begin_layout Description
2375 Syntax language <LANG> [set]
2377 \begin_layout Description
2378 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).
2380 \begin_layout Description
2381 Origin Dekel, 2 Mar 2000
2384 \begin_layout Subsection*
2387 \begin_layout Description
2388 Action Move the cursor to the beginning of the (screen) line.
2390 \begin_layout Description
2394 \begin_layout Subsection*
2397 \begin_layout Description
2398 Action Move the cursor to the beginning of the (screen) line adding the traversed text to the selection.
2400 \begin_layout Description
2401 Syntax line-begin-select
2404 \begin_layout Subsection*
2407 \begin_layout Description
2408 Action Deletes the letters to the end of the (screen) line or deletes the selection.
2410 \begin_layout Description
2411 Syntax line-delete-forward
2414 \begin_layout Subsection*
2417 \begin_layout Description
2418 Action Move the cursor to the end of the (screen) line.
2420 \begin_layout Description
2424 \begin_layout Subsection*
2427 \begin_layout Description
2428 Action Move the cursor to the end of the (screen) line adding the traversed text to the selection.
2430 \begin_layout Description
2431 Syntax line-end-select
2434 \begin_layout Subsection*
2437 \begin_layout Description
2438 Action Inserts a new listings inset.
2440 \begin_layout Description
2441 Syntax listing-insert
2443 \begin_layout Description
2444 Origin Herbert, 10 Nov 2001; bpeng, 2 May 2007
2447 \begin_layout Subsection*
2450 \begin_layout Description
2451 Action Inserts a marginal note.
2453 \begin_layout Description
2454 Syntax marginalnote-insert
2456 \begin_layout Description
2457 Origin Lgb, 26 Jun 2000
2460 \begin_layout Subsection*
2463 \begin_layout Description
2464 Action Disable selecting of text-region.
2466 \begin_layout Description
2470 \begin_layout Subsection*
2473 \begin_layout Description
2474 Action Enable selecting of text-region.
2476 \begin_layout Description
2477 Notion After enabling you can simply move arrow keys to get selected region.
2479 \begin_layout Description
2483 \begin_layout Subsection*
2486 \begin_layout Description
2487 Action Toggle between LFUN_MARK_ON and LFUN_MARK_OFF .
2489 \begin_layout Description
2492 \begin_layout Description
2493 Origin Andre, May 5 2006
2496 \begin_layout Subsection*
2499 \begin_layout Description
2500 Action Inserts a line break or new line.
2502 \begin_layout Description
2503 Syntax newline-insert [<ARG>]
2505 \begin_layout Description
2506 Params <ARG>: <newline|linebreak> default: newline
2508 \begin_layout Description
2509 Origin JSpitzm, 25 Mar 2008
2512 \begin_layout Subsection*
2515 \begin_layout Description
2516 Action Inserts a new page.
2518 \begin_layout Description
2519 Syntax newpage-insert <ARG>
2521 \begin_layout Description
2522 Params <ARG>: <newpage|pagebreak|clearpage|cleardoublepage> default: newpage
2524 \begin_layout Description
2525 Origin uwestoehr, 24 Nov 2007
2528 \begin_layout Subsection*
2531 \begin_layout Description
2532 Action Inserts Nomenclature entry.
2534 \begin_layout Description
2535 Notion It automatically takes the word on the cursor position if no symbol is given.
2537 \begin_layout Description
2538 Syntax nomencl-insert [<SYMBOL>]
2540 \begin_layout Description
2541 Origin Ugras, 4 Nov 2006
2544 \begin_layout Subsection*
2547 \begin_layout Description
2548 Action Inserts list of Nomenclature entries.
2550 \begin_layout Description
2551 Syntax nomenclature-print
2553 \begin_layout Description
2554 Origin Ugras, 4 Nov 2006
2557 \begin_layout Subsection*
2560 \begin_layout Description
2561 Action Inserts Note on the current cursor position, move selection inside the inset.
2563 \begin_layout Description
2564 Syntax note-insert [<TYPE>]
2566 \begin_layout Description
2567 Params <TYPE>: <Note|Greyedout|Comment> default: Note
2570 \begin_layout Subsection*
2573 \begin_layout Description
2574 Action Moves the cursor to the beginning of next Note inset.
2576 \begin_layout Description
2580 \begin_layout Subsection*
2583 \begin_layout Description
2584 Action Move the current group in the downward direction in the structure of the document.
2586 \begin_layout Description
2587 Notion The "group" can be Part/Chapter/Section/etc. It moves the whole substructure of the group.
2589 \begin_layout Description
2592 \begin_layout Description
2593 Origin Vermeer, 23 Mar 2006
2596 \begin_layout Subsection*
2599 \begin_layout Description
2600 Action Moves the current group in the downward direction in the hierarchy of the document structure.
2602 \begin_layout Description
2603 Notion Part -> Chapter -> Section -> etc.
2605 \begin_layout Description
2608 \begin_layout Description
2609 Origin Vermeer, 23 Mar 2006
2612 \begin_layout Subsection*
2615 \begin_layout Description
2616 Action Moves the current group in the upward direction in the hierarchy of the document structure.
2618 \begin_layout Description
2619 Notion Part <- Chapter <- Section <- etc.
2621 \begin_layout Description
2624 \begin_layout Description
2625 Origin Vermeer, 23 Mar 2006
2628 \begin_layout Subsection*
2631 \begin_layout Description
2632 Action Move the current group in the upward direction in the structure of the document.
2634 \begin_layout Description
2635 Notion The "group" can be Part/Chapter/Section/etc. It moves the whole substructure of the group.
2637 \begin_layout Description
2640 \begin_layout Description
2641 Origin Vermeer, 23 Mar 2006
2644 \begin_layout Subsection*
2647 \begin_layout Description
2648 Action Breaks the current paragraph at the current location.
2650 \begin_layout Description
2651 Notion Removes the selection.
2653 \begin_layout Description
2654 Syntax paragraph-break [<LAYOUT>]
2656 \begin_layout Description
2657 Params <LAYOUT>: "inverse" - decreases depth by one (or change layout to default layout) when the cursor is at the end of the line.
2660 \begin_layout Subsection*
2663 \begin_layout Description
2664 Action Move the cursor to the next paragraph (or beginning of the current one) in downward direction.
2666 \begin_layout Description
2667 Syntax paragraph-down
2669 \begin_layout Description
2670 Origin Asger, 1 Oct 1996
2673 \begin_layout Subsection*
2674 paragraph-down-select
2676 \begin_layout Description
2677 Action Move the cursor and select the text to the next paragraph (or beginning of the current one) in downward direction.
2679 \begin_layout Description
2680 Syntax paragraph-down-select
2682 \begin_layout Description
2683 Origin Asger, 1 Oct 1996
2686 \begin_layout Subsection*
2689 \begin_layout Description
2690 Action Jump to a paragraph given by its id number and optionally the desired position within the paragraph.
2692 \begin_layout Description
2693 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).
2695 \begin_layout Description
2696 Syntax paragraph-goto <PAR_ID_NUMBER> <POSITION_IN_PAR>
2698 \begin_layout Description
2699 Params <PAR_ID_NUMBER>: paragraph id
2700 \begin_inset Newline newline
2703 <POSITION_IN_PAR>: desired position within the paragraph
2705 \begin_layout Description
2706 Origin Dekel, 26 Aug 2000
2709 \begin_layout Subsection*
2712 \begin_layout Description
2713 Action Moves the current paragraph downwards in the document.
2715 \begin_layout Description
2716 Syntax paragraph-move-down
2718 \begin_layout Description
2719 Origin Edwin, 8 Apr 2006
2722 \begin_layout Subsection*
2725 \begin_layout Description
2726 Action Moves the current paragraph upwards in the document.
2728 \begin_layout Description
2729 Notion Movement through the document will possibly break the paragraph-depth (e.g. itemize structure).
2731 \begin_layout Description
2732 Syntax paragraph-move-up
2734 \begin_layout Description
2735 Origin Edwin, 8 Apr 2006
2738 \begin_layout Subsection*
2741 \begin_layout Description
2742 Action Change paragraph settings.
2744 \begin_layout Description
2745 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.
2747 \begin_layout Description
2748 Syntax paragraph-params [<INDENT>] [<SPACING>] [<ALIGN>] [<OTHERS>]
2750 \begin_layout Description
2760 \begin_inset Newline newline
2765 paragraph_spacing default|single|onehalf|double|other SIZE
2766 \begin_inset Newline newline
2771 align block|left|right|center|default
2772 \begin_inset Newline newline
2777 labelwidthstring WIDTH|
2781 \begin_layout Description
2782 Origin rgh, Aug 15 2007
2785 \begin_layout Subsection*
2786 paragraph-params-apply
2788 \begin_layout Description
2789 Action Change paragraph settings.
2791 \begin_layout Description
2792 Notion Overwrite all nonspecified settings to the default ones. Use paragraph-params lfun if you don't want to overwrite others settings.
2794 \begin_layout Description
2795 Syntax paragraph-params-apply <INDENT> <SPACING> <ALIGN> <OTHERS>
2797 \begin_layout Description
2798 Params For parameters see LFUN_PARAGRAPH_PARAMS
2800 \begin_layout Description
2801 Origin leeming, 30 Mar 2004
2804 \begin_layout Subsection*
2807 \begin_layout Description
2808 Action Move the cursor to the next paragraph (or beginning of the current one) in upward direction.
2810 \begin_layout Description
2813 \begin_layout Description
2814 Origin Asger, 1 Oct 1996
2817 \begin_layout Subsection*
2820 \begin_layout Description
2821 Action Move the cursor and select the text to the next paragraph (or beginning of the current one) in upward direction.
2823 \begin_layout Description
2824 Syntax paragraph-up-select
2826 \begin_layout Description
2827 Origin Asger, 1 Oct 1996
2830 \begin_layout Subsection*
2833 \begin_layout Description
2834 Action Pastes material (text or picture) from the active clipboard.
2836 \begin_layout Description
2837 Syntax paste [<TYPE>|<NUM>]
2839 \begin_layout Description
2840 Params <TYPE>: emf|pdf|png|jpeg|linkback|wmf|latex|html
2841 \begin_inset Newline newline
2844 <NUM>: number of the selection in the internal clipboard stack to be pasted.
2847 \begin_layout Subsection*
2850 \begin_layout Description
2851 Action Inserts phantom on the current cursor position, move selection inside the inset.
2853 \begin_layout Description
2854 Syntax phantom-insert [<TYPE>]
2856 \begin_layout Description
2857 Params <TYPE>: <Phantom|HPhantom|VPhantom> default: Phantom
2859 \begin_layout Description
2860 Origin uwestoehr, 30 Jan 2009
2863 \begin_layout Subsection*
2866 \begin_layout Description
2867 Action Inserts a new preview inset.
2869 \begin_layout Description
2870 Syntax preview-insert
2872 \begin_layout Description
2873 Origin vfr, 28 Mar 2010
2876 \begin_layout Subsection*
2877 primary-selection-paste
2879 \begin_layout Description
2880 Action Pastes the currently selected text.
2882 \begin_layout Description
2883 Notion Primary selection mechanism is linux-only thing.
2885 \begin_layout Description
2886 Syntax primary-selection-paste [<ARG>]
2888 \begin_layout Description
2889 Params <ARG>: "paragraph" will cause pasting as one paragraph, i.e. "Join lines".
2892 \begin_layout Subsection*
2895 \begin_layout Description
2896 Action Inserts quotes according to the type and quote-language preference.
2898 \begin_layout Description
2899 Notion Currently English, Swedish, German, Polish, French, Danish quotes are distinguished.
2901 \begin_layout Description
2902 Syntax quote-insert [<TYPE>]
2904 \begin_layout Description
2905 Params <TYPE>: 'single' for single quotes, otherwise double quotes will be used.
2908 \begin_layout Subsection*
2911 \begin_layout Description
2912 Action Redoes the last thing undone.
2914 \begin_layout Description
2918 \begin_layout Subsection*
2921 \begin_layout Description
2922 Action Go to the next label or cross-reference.
2924 \begin_layout Description
2925 Syntax reference-next
2927 \begin_layout Description
2928 Origin Dekel, 14 Jan 2001
2931 \begin_layout Subsection*
2934 \begin_layout Description
2935 Action Repeat the given command.
2937 \begin_layout Description
2938 Syntax repeat <COUNT> <LFUN-COMMAND>
2940 \begin_layout Description
2941 Origin Andre, 27 Oct 2003
2944 \begin_layout Subsection*
2947 \begin_layout Description
2948 Action Moves the cursor one page in downward direction.
2950 \begin_layout Description
2954 \begin_layout Subsection*
2957 \begin_layout Description
2958 Action Moves the cursor one screen in downward direction adding the current position to the selection.
2960 \begin_layout Description
2961 Syntax screen-down-select
2964 \begin_layout Subsection*
2967 \begin_layout Description
2968 Action Recenters the screen on the current cursor position.
2970 \begin_layout Description
2971 Syntax screen-recenter
2974 \begin_layout Subsection*
2977 \begin_layout Description
2978 Action Repositions the screen such that the cursor is visible.
2980 \begin_layout Description
2981 Syntax screen-show-cursor
2983 \begin_layout Description
2984 Origin vfr, 25 Mar 2009
2987 \begin_layout Subsection*
2990 \begin_layout Description
2991 Action Moves the cursor one page in upward direction.
2993 \begin_layout Description
2997 \begin_layout Subsection*
3000 \begin_layout Description
3001 Action Moves the cursor one page in upward direction adding the current position to the selection.
3003 \begin_layout Description
3004 Syntax screen-up-select
3007 \begin_layout Subsection*
3010 \begin_layout Description
3011 Action Inserts a subscript or superscript inset.
3013 \begin_layout Description
3014 Syntax script-insert <TYPE>
3016 \begin_layout Description
3017 Params <TYPE>: subscript|superscript
3019 \begin_layout Description
3020 Origin Georg, 23 Nov 2010
3023 \begin_layout Subsection*
3026 \begin_layout Description
3027 Action Scroll the buffer view.
3029 \begin_layout Description
3030 Notion Only scrolls the screen up or down; does not move the cursor.
3032 \begin_layout Description
3033 Syntax scroll <TYPE> <QUANTITY>
3035 \begin_layout Description
3036 Params <TYPE>: line|page
3037 \begin_inset Newline newline
3040 <QUANTITY>: up|down|<number>
3042 \begin_layout Description
3043 Origin Abdel, Dec 27 2007
3046 \begin_layout Subsection*
3049 \begin_layout Description
3050 Action Selects the whole section.
3052 \begin_layout Description
3053 Notion The cursor should be in a section heading before calling this lfun.
3055 \begin_layout Description
3056 Syntax section-select
3058 \begin_layout Description
3059 Origin vfr, 05 May 2009
3062 \begin_layout Subsection*
3065 \begin_layout Description
3066 Action Pastes the internal selection text in permanent selection.
3068 \begin_layout Description
3069 Notion Created in order to have middle mouse button pasting correct (bound to command-alternatives selection-paste ; primary-selection-paste paragraph).
3071 \begin_layout Description
3072 Syntax selection-paste
3074 \begin_layout Description
3075 Origin lasgouttes, 14 Jan 2009
3078 \begin_layout Subsection*
3081 \begin_layout Description
3082 Action Inserts an environment separator or paragraph break.
3084 \begin_layout Description
3085 Syntax separator-insert [<ARG>]
3087 \begin_layout Description
3088 Params <ARG>: <plain|parbreak> default: plain
3090 \begin_layout Description
3091 Origin ef, 2 May 2014
3094 \begin_layout Subsection*
3097 \begin_layout Description
3098 Action Set the group for the graphics inset on the cursor position.
3100 \begin_layout Description
3101 Syntax set-graphics-group [<GROUP>]
3103 \begin_layout Description
3104 Params <GROUP>: Id for an existing group. In case the Id is an empty string, the graphics inset is removed from the current group.
3106 \begin_layout Description
3107 Origin sanda, 6 May 2008
3110 \begin_layout Subsection*
3113 \begin_layout Description
3114 Action Inserts one of horizontal space insets.
3116 \begin_layout Description
3117 Syntax space-insert <NAME> [<LEN>]
3119 \begin_layout Description
3120 Params <NAME>: normal, protected, visible, thin, quad, qquad, enspace, enskip, negthinspace, negmedspace, negthickspace, hfill, hfill*, dotfill, hrulefill, hspace, hspace*
3121 \begin_inset Newline newline
3124 Only in math mode: med and thick.
3125 \begin_inset Newline newline
3128 <LEN>: length for custom spaces (hspace, hspace* for protected)
3130 \begin_layout Description
3131 Origin JSpitzm, 20 May 2003, Mar 17 2008
3134 \begin_layout Subsection*
3137 \begin_layout Description
3138 Action Inserts various characters into the document.
3140 \begin_layout Description
3141 Syntax specialchar-insert <CHAR>
3143 \begin_layout Description
3144 Params <CHAR>: hyphenation, ligature-break, slash, nobreakdash, dots, end-of-sentence, menu-separator.
3146 \begin_layout Description
3147 Origin JSpitzm, 6 Dec 2007
3150 \begin_layout Subsection*
3153 \begin_layout Description
3154 Action Add the word under the cursor to the respective spell checker dictionary.
3156 \begin_layout Description
3157 Syntax spelling-add [<STRING>] [<LANG>]
3159 \begin_layout Description
3160 Params <WORD>: word to add <LANG>: language name (see file languages)
3162 \begin_layout Description
3163 Origin JSpitzm, 18 Jan 2010
3166 \begin_layout Subsection*
3167 spelling-continuously
3169 \begin_layout Description
3170 Action Toggle continuous spell checking.
3172 \begin_layout Description
3173 Syntax spelling-continuously
3175 \begin_layout Description
3176 Origin vfr, 24 March 2013
3179 \begin_layout Subsection*
3182 \begin_layout Description
3183 Action Let the spell checker ignore the word under the cursor in the current session for the given language.
3185 \begin_layout Description
3186 Syntax spelling-ignore [<WORD>] [<LANG>]
3188 \begin_layout Description
3189 Params <WORD>: word to ignore <LANG>: language name (see file languages)
3191 \begin_layout Description
3192 Origin JSpitzm, 18 Jan 2010
3195 \begin_layout Subsection*
3198 \begin_layout Description
3199 Action Remove the word under the cursor from the respective spell checker dictionary.
3201 \begin_layout Description
3202 Syntax spelling-remove [<STRING>] [<LANG>]
3204 \begin_layout Description
3205 Params <WORD>: word to remove <LANG>: language name (see file languages)
3207 \begin_layout Description
3208 Origin SWitt, 28 July 2010
3211 \begin_layout Subsection*
3214 \begin_layout Description
3215 Action Delete a tab or up to an equivalent amount of spaces from a listings inset.
3217 \begin_layout Description
3218 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.
3220 \begin_layout Description
3223 \begin_layout Description
3224 Origin vfr, Sep 30 2008
3227 \begin_layout Subsection*
3230 \begin_layout Description
3231 Action Insert a tab into a listings inset.
3233 \begin_layout Description
3234 Notion It also works on a selection.
3236 \begin_layout Description
3239 \begin_layout Description
3240 Origin vfr, Sep 30 2008
3243 \begin_layout Subsection*
3246 \begin_layout Description
3247 Action Inserts table into the document.
3249 \begin_layout Description
3250 Notion See LFUN_INSET_MODIFY for some more details about tabular modifications.
3252 \begin_layout Description
3253 Syntax tabular-insert [<ROWS> <COLUMNS>]
3255 \begin_layout Description
3256 Params In case no arguments are given show insert dialog.
3258 \begin_layout Description
3259 Origin Jug, 12 Apr 2000
3262 \begin_layout Subsection*
3265 \begin_layout Description
3266 Action Look up thesaurus entries with respect to the word under the cursor.
3268 \begin_layout Description
3269 Syntax thesaurus-entry [<STRING>] [lang=<LANG>]
3271 \begin_layout Description
3272 Params <STRING>: word to look up <LANG>: language (see file languages)
3274 \begin_layout Description
3275 Origin Levon, 20 Jul 2001
3278 \begin_layout Subsection*
3281 \begin_layout Description
3282 Action Undoes the last edit.
3284 \begin_layout Description
3288 \begin_layout Subsection*
3291 \begin_layout Description
3292 Action Inserts a single unicode character.
3294 \begin_layout Description
3295 Syntax unicode-insert <CHAR>
3297 \begin_layout Description
3298 Params <CHAR>: The character to insert, given as its code point, in hexadecimal.
3300 \begin_layout Description
3301 Sample unicode-insert 0x0100
3303 \begin_layout Description
3304 Origin Lgb, 22 Oct 2006
3307 \begin_layout Subsection*
3310 \begin_layout Description
3311 Action Moves the cursor one line in upward direction.
3313 \begin_layout Description
3317 \begin_layout Subsection*
3320 \begin_layout Description
3321 Action Moves the cursor one line in upward direction adding the current position to the selection.
3323 \begin_layout Description
3327 \begin_layout Subsection*
3330 \begin_layout Description
3331 Action Moves the cursor to the logically previous beginning of a word.
3333 \begin_layout Description
3334 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.
3336 \begin_layout Description
3337 Syntax word-backward
3340 \begin_layout Subsection*
3341 word-backward-select
3343 \begin_layout Description
3344 Action Moves the cursor to the logically previous beginning of a word, adding the logically traversed text to the selection.
3346 \begin_layout Description
3347 Notion See also LFUN_WORD_BACKWARD.
3349 \begin_layout Description
3350 Syntax word-backward-select
3353 \begin_layout Subsection*
3356 \begin_layout Description
3357 Action Capitalizes the words in the selection (i.e. the first letters) or the letter on the cursor position.
3359 \begin_layout Description
3360 Syntax word-capitalize
3363 \begin_layout Subsection*
3364 word-delete-backward
3366 \begin_layout Description
3367 Action Deletes characters to the beginning of the word (usually the "C+BackSpace" key).
3369 \begin_layout Description
3370 Syntax word-delete-backward
3373 \begin_layout Subsection*
3376 \begin_layout Description
3377 Action Deletes characters to the end of the word (usually the "C+Delete" key).
3379 \begin_layout Description
3380 Syntax word-delete-forward
3383 \begin_layout Subsection*
3386 \begin_layout Description
3387 Action Search for next occurrence of a string.
3389 \begin_layout Description
3390 Syntax word-find [<DATA>]
3392 \begin_layout Description
3393 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).
3395 \begin_layout Description
3396 Origin Andre, Jan 7 2004
3399 \begin_layout Subsection*
3402 \begin_layout Description
3403 Action Search for a given string in backward direction.
3405 \begin_layout Description
3406 Notion Case sensitive, match words. If no argument given, last search repeated.
3408 \begin_layout Description
3409 Syntax word-find-backward [<STRING>]
3411 \begin_layout Description
3412 Origin Etienne, 20 Feb 1998
3415 \begin_layout Subsection*
3418 \begin_layout Description
3419 Action Search for a given string in forward direction.
3421 \begin_layout Description
3422 Notion Case sensitive, match words. If no argument given, last search repeated.
3424 \begin_layout Description
3425 Syntax word-find-forward [<STRING>]
3427 \begin_layout Description
3428 Origin Etienne, 16 Feb 1998
3431 \begin_layout Subsection*
3434 \begin_layout Description
3435 Action Search for next occurrence of a pattern.
3437 \begin_layout Description
3438 Syntax word-findadv [<DATA>]
3440 \begin_layout Description
3441 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).
3443 \begin_layout Description
3444 Origin Tommaso, Nov 15 2007
3447 \begin_layout Subsection*
3450 \begin_layout Description
3451 Action Moves the cursor to the logically next beginning of a word.
3453 \begin_layout Description
3454 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.
3456 \begin_layout Description
3460 \begin_layout Subsection*
3463 \begin_layout Description
3464 Action Moves the cursor to the logically next beginning of a word, adding the logically traversed text to the selection.
3466 \begin_layout Description
3467 Notion See also LFUN_WORD_FORWARD.
3469 \begin_layout Description
3470 Syntax word-forward-select
3473 \begin_layout Subsection*
3476 \begin_layout Description
3477 Action Moves the cursor to the next beginning of a word "on the left".
3479 \begin_layout Description
3480 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.
3482 \begin_layout Description
3485 \begin_layout Description
3486 Origin dov, 28 Oct 2007
3489 \begin_layout Subsection*
3492 \begin_layout Description
3493 Action Moves the cursor to the next beginning of a word "on the left", adding *logically* traversed text to the selection.
3495 \begin_layout Description
3496 Notion See also LFUN_WORD_LEFT for exact details of the movement.
3498 \begin_layout Description
3499 Syntax word-left-select
3501 \begin_layout Description
3502 Origin dov, 28 Oct 2007
3505 \begin_layout Subsection*
3508 \begin_layout Description
3509 Action Change the words in the selection or from the cursor position to the end of word to the lower case.
3511 \begin_layout Description
3515 \begin_layout Subsection*
3518 \begin_layout Description
3519 Action Replace a string in the document.
3521 \begin_layout Description
3522 Syntax word-replace [<DATA>]
3524 \begin_layout Description
3525 Params <DATA>: data is of the form "<replace>
3526 \begin_inset Newline newline
3530 \begin_inset Newline newline
3533 <casesensitive> <matchword> <all> <forward> <findnext>"
3535 \begin_layout Description
3536 Origin Andre, Jan 7 2004
3539 \begin_layout Subsection*
3542 \begin_layout Description
3543 Action Moves the cursor to the next beginning of a word "on the right".
3545 \begin_layout Description
3546 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.
3548 \begin_layout Description
3551 \begin_layout Description
3552 Origin dov, 28 Oct 2007
3555 \begin_layout Subsection*
3558 \begin_layout Description
3559 Action Moves the cursor to the next beginning of a word "on the right", adding *logically* traversed text to the selection.
3561 \begin_layout Description
3562 Notion See also LFUN_WORD_RIGHT for exact details of the movement.
3564 \begin_layout Description
3565 Syntax word-right-select
3567 \begin_layout Description
3568 Origin dov, 28 Oct 2007
3571 \begin_layout Subsection*
3574 \begin_layout Description
3575 Action Puts the word where the cursor stands into the selection.
3577 \begin_layout Description
3580 \begin_layout Description
3581 Origin Andre, 11 Sep 2002
3584 \begin_layout Subsection*
3587 \begin_layout Description
3588 Action Change the words in the selection or from the cursor position to the end of word to the upper case.
3590 \begin_layout Description
3594 \begin_layout Subsection*
3597 \begin_layout Description
3598 Action Inserts floats wrapped by the text around.
3600 \begin_layout Description
3601 Syntax wrap-insert <TYPE>
3603 \begin_layout Description
3604 Params <TYPE>: table|figure
3606 \begin_layout Description
3607 Origin Dekel, 7 Apr 2002
3610 \begin_layout Section
3611 Math Editor Functions
3613 \begin_layout Subsection*
3614 in-mathmacrotemplate
3616 \begin_layout Description
3617 Action Only active in Math Macro definition.
3619 \begin_layout Description
3620 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.
3622 \begin_layout Description
3623 Syntax in-mathmacrotemplate
3625 \begin_layout Description
3626 Origin sts, 06 January 2008
3629 \begin_layout Subsection*
3632 \begin_layout Description
3633 Action Inserts an extended matrix as provided by the amsmath package.
3635 \begin_layout Description
3636 Syntax math-matrix <COLS> <ROWS> [<DECORATION>]
3638 \begin_layout Description
3639 Params <DECORATION>: Decoration determines the LaTeX name of the matrix that should be created. Possible values include pmatrix, bmatrix, Bmatrix, vmatrix, Vmatrix and matrix. The default is 'matrix'.
3641 \begin_layout Description
3642 Sample math-ams-matrix 3 3 bmatrix
3645 \begin_layout Subsection*
3648 \begin_layout Description
3649 Action Inserts math fixed size delimiters (e.g. parentheses, brackets) enclosing expression.
3651 \begin_layout Description
3652 Syntax math-bigdelim <LSIZE> <LDELIM> <RSIZE> <RDELIM>
3654 \begin_layout Description
3655 Params <L/RSIZE>: bigl/r|Bigl/r|biggl/r|Biggl/r
3656 \begin_inset Newline newline
3659 <L/RDELIM>: TeX code for delimiter. See Delimiter dialog for delimiters to be used.
3661 \begin_layout Description
3662 Sample math-bigdelim "Bigl" "
3668 \begin_layout Description
3669 Origin Enrico & Georg, 7 May 2006
3672 \begin_layout Subsection*
3675 \begin_layout Description
3676 Action Inserts math delimiters (e.g. parentheses, brackets) enclosing expression.
3678 \begin_layout Description
3679 Syntax math-delim [<LEFT>] [<RIGHT>]
3681 \begin_layout Description
3682 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.
3684 \begin_layout Description
3685 Sample math-delim { rangle
3687 \begin_layout Description
3688 Origin Alejandro, 18 Jun 1996
3691 \begin_layout Subsection*
3694 \begin_layout Description
3695 Action Creates a new displayed equation in text mode. Toggles inlined/display formula in math mode.
3697 \begin_layout Description
3698 Syntax math-display [<ARG>]
3700 \begin_layout Description
3701 Params <ARG>: this argument will be passed to LFUN_MATH_INSERT when creating new equation from the text mode.
3703 \begin_layout Description
3704 Origin Alejandro, 18 Jun 1996
3707 \begin_layout Subsection*
3710 \begin_layout Description
3711 Action Calls external program and passes the current expression/equation as an argument for the calculation in the format appropriate to the given language.
3713 \begin_layout Description
3714 Notion Selection can be used to determine the input for the external program.
3716 \begin_layout Description
3717 Syntax math-extern <LANG> [<COMMAND>]
3719 \begin_layout Description
3720 Params <LANG>: octave|maxima|maple|mathematica|script
3721 \begin_inset Newline newline
3724 where "script" stands for the external script (normalized expression will be passed)
3726 \begin_layout Description
3727 Sample math-extern maple simplify
3729 \begin_layout Description
3730 Origin Andre, 24 Apr 2001
3733 \begin_layout Subsection*
3736 \begin_layout Description
3737 Action Changes the text style used in math.
3739 \begin_layout Description
3740 Syntax math-font-style <STYLE>
3742 \begin_layout Description
3743 Params <STYLE>: mathnormal|mathcal|mathfrak|mathrm|mathsf|mathbf|textnormal
3744 \begin_inset Newline newline
3747 |textrm|textsf|texttt|textbf|textmd|textit|textsc|textsl|textup
3749 \begin_layout Description
3750 Origin vfr, 9 jan 2009
3753 \begin_layout Subsection*
3756 \begin_layout Description
3757 Action Inserts math objects and symbols.
3759 \begin_layout Description
3760 Notion When <ARG> is a _single_ math inset with more than one cell (such as "x_y^z" or "
3762 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
3764 frac{x}{y}" replaces "abc" with "
3766 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.
3768 \begin_layout Description
3769 Syntax math-insert <ARG>
3771 \begin_layout Description
3772 Params <ARG>: Symbol or LaTeX code to be inserted.
3775 \begin_layout Subsection*
3778 \begin_layout Description
3779 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.
3781 \begin_layout Description
3782 Notion Put the cursor before the symbol with the limits and then invoke math-limits.
3784 \begin_layout Description
3785 Syntax math-limits [<STATE>]
3787 \begin_layout Description
3788 Params <STATE>: limits|nolimits
3791 \begin_layout Subsection*
3794 \begin_layout Description
3795 Action Inserts a math macro definition at the cursor position in the text.
3797 \begin_layout Description
3798 Syntax math-macro <NAME> [<NARGS>] [def]
3800 \begin_layout Description
3801 Params <NAME>: The name of the macro, e.g. "mymacro".
3802 \begin_inset Newline newline
3805 <NARGS>: The number of parameters of the macro. Default is 0. "def": Has no effect anymore, just for compatibility with former LyX versions.
3807 \begin_layout Description
3808 Origin ale, 10 May 1997; sts, 21 Dec 2007
3811 \begin_layout Subsection*
3812 math-macro-add-greedy-optional-param
3814 \begin_layout Description
3815 Action Add a greedy optional parameter.
3817 \begin_layout Description
3818 Notion Add a greedy optional parameter which eats the value from the following cells in mathed which are in the [value] format.
3820 \begin_layout Description
3821 Syntax math-macro-add-greedy-optional-param
3823 \begin_layout Description
3824 Origin sts, 06 January 2008
3827 \begin_layout Subsection*
3828 math-macro-add-optional-param
3830 \begin_layout Description
3831 Action Add an optional parameter.
3833 \begin_layout Description
3834 Notion Insert an optional parameter just behind the already existing optional parameters.
3836 \begin_layout Description
3837 Syntax math-macro-add-optional-param
3839 \begin_layout Description
3840 Origin sts, 06 January 2008
3843 \begin_layout Subsection*
3844 math-macro-add-param
3846 \begin_layout Description
3847 Action Add a parameter.
3849 \begin_layout Description
3850 Notion Add a parameter to a Math Macro.
3852 \begin_layout Description
3853 Syntax math-macro-add-param <NUM>
3855 \begin_layout Description
3856 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.
3858 \begin_layout Description
3859 Origin sts, 06 January 2008
3862 \begin_layout Subsection*
3863 math-macro-append-greedy-param
3865 \begin_layout Description
3866 Action Append a greedy parameter.
3868 \begin_layout Description
3869 Notion Append a greedy parameter to a Math Macro which eats the following mathed cell in every instance of the macro in the buffer.
3871 \begin_layout Description
3872 Syntax math-macro-append-greedy-param
3874 \begin_layout Description
3875 Origin sts, 06 January 2008
3878 \begin_layout Subsection*
3881 \begin_layout Description
3882 Action Fold a Math Macro.
3884 \begin_layout Description
3885 Notion Fold the Math Macro the cursor is in if it was unfolded, i.e. displayed as
3889 \begin_layout Description
3890 Syntax math-macro-fold
3892 \begin_layout Description
3893 Origin sts, 06 January 2008
3896 \begin_layout Subsection*
3897 math-macro-make-nonoptional
3899 \begin_layout Description
3900 Action Make a parameter non-optional.
3902 \begin_layout Description
3903 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.
3905 \begin_layout Description
3906 Syntax math-macro-make-nonoptional
3908 \begin_layout Description
3909 Origin sts, 06 January 2008
3912 \begin_layout Subsection*
3913 math-macro-make-optional
3915 \begin_layout Description
3916 Action Make a parameter optional.
3918 \begin_layout Description
3919 Notion Turn the first non-optional parameter of a Math Macro into an optional parameter with a default value.
3921 \begin_layout Description
3922 Syntax math-macro-make-optional
3924 \begin_layout Description
3925 Origin sts, 06 January 2008
3928 \begin_layout Subsection*
3929 math-macro-remove-greedy-param
3931 \begin_layout Description
3932 Action Remove a greedy parameter.
3934 \begin_layout Description
3935 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.
3937 \begin_layout Description
3938 Syntax math-macro-remove-greedy-param
3940 \begin_layout Description
3941 Origin sts, 06 January 2008
3944 \begin_layout Subsection*
3945 math-macro-remove-optional-param
3947 \begin_layout Description
3948 Action Remove the last optional parameter.
3950 \begin_layout Description
3951 Notion Remove the last optional parameter of a Math Macro and remove it in all the instances of the macro in the buffer.
3953 \begin_layout Description
3954 Syntax math-macro-remove-optional-param
3956 \begin_layout Description
3957 Origin sts, 06 January 2008
3960 \begin_layout Subsection*
3961 math-macro-remove-param
3963 \begin_layout Description
3964 Action Remove the last parameter.
3966 \begin_layout Description
3967 Notion Remove the last parameter of a Math Macro and remove its value in all instances of the macro in the buffer.
3969 \begin_layout Description
3970 Syntax math-macro-remove-param <NUM>
3972 \begin_layout Description
3973 Params <NUM>: The number of the parameter to be deleted (1 for the first), defaults to the last one.
3975 \begin_layout Description
3976 Origin sts, 06 January 2008
3979 \begin_layout Subsection*
3982 \begin_layout Description
3983 Action Unfold a Math Macro.
3985 \begin_layout Description
3986 Notion Unfold the Math Macro the cursor is in, i.e. display it as
3990 \begin_layout Description
3991 Syntax math-macro-unfold
3993 \begin_layout Description
3994 Origin sts, 06 January 2008
3997 \begin_layout Subsection*
4000 \begin_layout Description
4001 Action Inserts a matrix.
4003 \begin_layout Description
4004 Syntax math-matrix <COLS> <ROWS> [<ALIGN>]
4006 \begin_layout Description
4007 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).
4009 \begin_layout Description
4010 Sample math-matrix 3 3 bccc
4013 \begin_layout Subsection*
4016 \begin_layout Description
4017 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.
4019 \begin_layout Description
4020 Notion If there is some selected text, it puts the text inside created math box.
4022 \begin_layout Description
4023 Syntax math-mode [on|<ARG>]
4025 \begin_layout Description
4026 Params <ARG>: eventual argument (LaTeX code) is passed to LFUN_MATH_INSERT .
4027 \begin_inset Newline newline
4030 "on": allow only entering of math mode from text mode.
4032 \begin_layout Description
4033 Origin Alejandro, 4 Jun 1996
4036 \begin_layout Subsection*
4039 \begin_layout Description
4040 Action Mutates the type of math inset to the newly selected one.
4042 \begin_layout Description
4043 Syntax math-mutate <TYPE>
4045 \begin_layout Description
4046 Params <TYPE>: none|simple|equation|eqnarray|align|alignat|xalignat|xxalignat| multline|gather|flalign
4048 \begin_layout Description
4049 Origin Andre, 23 May 2001
4052 \begin_layout Subsection*
4053 math-number-line-toggle
4055 \begin_layout Description
4056 Action Toggles numbering of the current formula line.
4058 \begin_layout Description
4059 Notion Must be in display formula mode.
4061 \begin_layout Description
4062 Syntax math-number-line-toggle
4064 \begin_layout Description
4065 Origin Alejandro, 18 Jun 1996
4068 \begin_layout Subsection*
4071 \begin_layout Description
4072 Action Toggles numbering/labeling of the current formula.
4074 \begin_layout Description
4075 Notion Must be in display formula mode.
4077 \begin_layout Description
4078 Syntax math-number-toggle
4080 \begin_layout Description
4081 Origin Alejandro, 4 Jun 1996
4084 \begin_layout Subsection*
4087 \begin_layout Description
4088 Action Changes arbitrarily the size used by math fonts inside a context.
4090 \begin_layout Description
4091 Notion Provides an interface to the LaTeX math mode font size commands.
4093 \begin_layout Description
4094 Syntax math-size <STYLE>
4096 \begin_layout Description
4107 \begin_layout Description
4108 Origin Alejandro, 15 Aug 1996; sanda, 14 Jun 2008
4111 \begin_layout Subsection*
4114 \begin_layout Description
4115 Action Inserts space into math expression.
4117 \begin_layout Description
4118 Notion Use spacebar after entering this space to change type of space.
4120 \begin_layout Description
4121 Syntax math-space [<TYPE>] [<LEN>]
4123 \begin_layout Description
4124 Params <TYPE>: negative spaces: !|negthinspace|negmedspace|negthickspace
4125 \begin_inset Newline newline
4128 positive spaces: ,|thinspace|:|medspace|;|thickspace|enskip|quad|qquad
4129 \begin_inset Newline newline
4132 custom space: hspace
4133 \begin_inset Newline newline
4136 "," used by default.
4137 \begin_inset Newline newline
4140 Note that ! is equivalent to negthinspace, , = thinspace, : = medspace, and ; = thickspace.
4141 \begin_inset Newline newline
4144 <LEN>: length for custom spaces (hspace)
4146 \begin_layout Description
4147 Origin Andre, 25 Jul 2001; sanda, 16 Jun 2008
4150 \begin_layout Subsection*
4153 \begin_layout Description
4154 Action Enters subscript expression in math expression.
4156 \begin_layout Description
4157 Syntax math-subscript
4159 \begin_layout Description
4160 Origin vermeer, 12 Dec 2001
4163 \begin_layout Subsection*
4166 \begin_layout Description
4167 Action Enters superscript expression in math expression.
4169 \begin_layout Description
4170 Syntax math-superscript
4172 \begin_layout Description
4173 Origin vermeer, 12 Dec 2001
4176 \begin_layout Subsection*
4179 \begin_layout Description
4180 Action Enters regexp mode (i.e., puts regexp insets on the current cursor position). Used by the advanced search dialog.
4182 \begin_layout Description
4183 Notion If there is any selected text, then it is moved inside the created regexp inset.
4185 \begin_layout Description
4186 Syntax regexp-mode [<ARG>]
4188 \begin_layout Description
4189 Params <ARG>: eventual argument (regular expression).
4191 \begin_layout Description
4192 Origin Tommaso, 4 Oct 2008
4195 \begin_layout Section
4196 Buffer Fuctions (File and Window related)
4198 \begin_layout Subsection*
4201 \begin_layout Description
4202 Action Activate the branch.
4204 \begin_layout Description
4205 Syntax branch-activate <BRANCH>
4207 \begin_layout Description
4208 Params <BRANCH>: The branch to activate
4210 \begin_layout Description
4211 Sample lyx -x "branch-activate answers" -e pdf2 finalexam.lyx
4212 \begin_inset Newline newline
4215 could be used to export a pdf with the answers branch included without one's having to open LyX and activate the branch manually.
4217 \begin_layout Description
4218 Origin rgh, 27 May 2008
4221 \begin_layout Subsection*
4224 \begin_layout Description
4225 Action Add a branch to the buffer's BranchList.
4227 \begin_layout Description
4228 Syntax branch-add <BRANCH>
4230 \begin_layout Description
4231 Params <BRANCH>: Name of the branch to add
4233 \begin_layout Description
4234 Origin spitz, 7 Jul 2009
4237 \begin_layout Subsection*
4240 \begin_layout Description
4241 Action Create new branch and directly put the branch inset into the document.
4243 \begin_layout Description
4244 Syntax branch-add-insert [<NAME>]
4246 \begin_layout Description
4247 Params <NAME>: Branch name. If it is not specified, you will be asked.
4249 \begin_layout Description
4250 Origin sanda, 10 Jul 2009
4253 \begin_layout Subsection*
4256 \begin_layout Description
4257 Action De-activate the branch.
4259 \begin_layout Description
4260 Syntax branch-deactivate <BRANCH>
4262 \begin_layout Description
4263 Params <BRANCH>: The branch to deactivate
4265 \begin_layout Description
4266 Origin rgh, 27 May 2008
4269 \begin_layout Subsection*
4270 branch-master-activate
4272 \begin_layout Description
4273 Action Activate the branch in the master buffer.
4275 \begin_layout Description
4276 Syntax branch-master-activate <BRANCH>
4278 \begin_layout Description
4279 Params <BRANCH>: The branch to activate
4281 \begin_layout Description
4282 Sample lyx -x "branch-activate answers" -e pdf2 finalexam.lyx
4283 \begin_inset Newline newline
4286 could be used to export a pdf with the answers branch included without one's having to open LyX and activate the branch manually.
4288 \begin_layout Description
4289 Origin spitz, 30 Sep 2012
4292 \begin_layout Subsection*
4293 branch-master-deactivate
4295 \begin_layout Description
4296 Action De-activate the branch in the master buffer.
4298 \begin_layout Description
4299 Syntax branch-master-deactivate <BRANCH>
4301 \begin_layout Description
4302 Params <BRANCH>: The branch to deactivate
4304 \begin_layout Description
4305 Origin spitz, 30 Sep 2012
4308 \begin_layout Subsection*
4311 \begin_layout Description
4312 Action Rename all branches of a given name in a document.
4314 \begin_layout Description
4315 Syntax branches-rename <OLDNAME> <NEWNAME>
4317 \begin_layout Description
4318 Params <OLDNAME>: Current name of the branch to be renamed <NEWNAME>: New name of the branch
4320 \begin_layout Description
4321 Origin spitz, 9 Jul 2009
4324 \begin_layout Subsection*
4327 \begin_layout Description
4328 Action Saves the current buffer to a temporary file.
4330 \begin_layout Description
4331 Notion Saves the current buffer to a file named "#filename#". This LFUN is called automatically by LyX, to "autosave" the current buffer.
4333 \begin_layout Description
4334 Syntax buffer-auto-save
4337 \begin_layout Subsection*
4340 \begin_layout Description
4341 Action Loads the given child document.
4343 \begin_layout Description
4344 Notion The current document is treated as a parent.
4346 \begin_layout Description
4347 Syntax buffer-child-open <FILE>
4349 \begin_layout Description
4350 Params <FILE>: Filename of the child. The directory of the parent is assumed by default.
4352 \begin_layout Description
4353 Origin Ale, 28 May 1997
4356 \begin_layout Subsection*
4359 \begin_layout Description
4360 Action Runs chktex for the current document.
4362 \begin_layout Description
4363 Syntax buffer-chktex
4365 \begin_layout Description
4366 Origin Asger, 30 Oct 1997
4369 \begin_layout Subsection*
4372 \begin_layout Description
4373 Action Closes the current buffer.
4375 \begin_layout Description
4376 Notion Closes the current buffer, asking whether to save it, etc, if the buffer has been modified.
4378 \begin_layout Description
4382 \begin_layout Subsection*
4385 \begin_layout Description
4386 Action Closes all buffers.
4388 \begin_layout Description
4389 Notion Closes all buffers, asking whether to save it, etc, if a buffer has been modified.
4391 \begin_layout Description
4392 Syntax buffer-close-all
4395 \begin_layout Subsection*
4398 \begin_layout Description
4399 Action Exports the current buffer (document) to the given format.
4401 \begin_layout Description
4402 Syntax buffer-export <FORMAT> [<DEST>]
4404 \begin_layout Description
4405 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.
4406 \begin_inset Newline newline
4409 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. <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.
4411 \begin_layout Description
4412 Origin Lgb, 29 Jul 1997
4415 \begin_layout Subsection*
4418 \begin_layout Description
4419 Action Opens a dialog for exporting the current buffer.
4421 \begin_layout Description
4422 Syntax buffer-export-as [<FORMAT>]
4424 \begin_layout Description
4425 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.
4427 \begin_layout Description
4428 Sample buffer-export-as pdf2
4430 \begin_layout Description
4431 Origin tommaso, 6 Oct 2011
4434 \begin_layout Subsection*
4435 buffer-export-custom
4437 \begin_layout Description
4438 Action Exports the current buffer (document) from the given format using the given command on it.
4440 \begin_layout Description
4441 Syntax buffer-export-custom <FORMAT> <COMMAND>
4443 \begin_layout Description
4444 Params <FORMAT> format to start from (LyX will care to produce such intermediate file).
4445 \begin_inset Newline newline
4448 <COMMAND> this command will be launched on the file. Note that you can use "$$FName" string to qualify the intermediate file.
4450 \begin_layout Description
4451 Sample buffer-export-custom dvi dvips -f $$FName -o myfile.ps
4453 \begin_layout Description
4454 Origin leeming, 27 Mar 2004
4457 \begin_layout Subsection*
4460 \begin_layout Description
4461 Action Applies a command to all non-hidden buffers.
4463 \begin_layout Description
4464 Notion a buffer is `hidden' if it is internally open in LyX, but not visible in any window.
4466 \begin_layout Description
4467 Syntax buffer-forall <LFUN-COMMAND>
4469 \begin_layout Description
4470 Params <LFUN-COMMAND>: The command to be applied to the buffers.
4472 \begin_layout Description
4473 Sample Close all Notes in buffers:
4474 \begin_inset Newline newline
4477 buffer-forall inset-forall Note inset-toggle close
4478 \begin_inset Newline newline
4481 Toggle change tracking on buffers:
4482 \begin_inset Newline newline
4485 buffer-forall changes-track
4486 \begin_inset Newline newline
4489 Toggle read-only for buffers:
4490 \begin_inset Newline newline
4493 buffer-forall buffer-toggle-read-only
4494 \begin_inset Newline newline
4497 Show statistics for individual buffers:
4498 \begin_inset Newline newline
4501 buffer-forall statistics
4502 \begin_inset Newline newline
4505 Activate the branch named "Solutions" in buffers:
4506 \begin_inset Newline newline
4509 buffer-forall branch-activate Solutions
4510 \begin_inset Newline newline
4513 Export buffers to PDF (pdflatex):
4514 \begin_inset Newline newline
4517 buffer-forall buffer-export pdf2
4518 \begin_inset Newline newline
4523 \begin_layout Description
4524 Origin scottkostyshak, 20 Jul 2012
4527 \begin_layout Subsection*
4530 \begin_layout Description
4531 Action Import a given file as a lyx document.
4533 \begin_layout Description
4534 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.
4536 \begin_layout Description
4537 Syntax buffer-import <FORMAT> [<FILE>]
4539 \begin_layout Description
4540 Origin Asger, 24 Jul 1998
4543 \begin_layout Subsection*
4546 \begin_layout Description
4547 Action Set language of the current document.
4549 \begin_layout Description
4550 Syntax buffer-language <LANG>
4552 \begin_layout Description
4553 Params <LANG>: language name. See lib/languages for list.
4555 \begin_layout Description
4556 Origin leeming, 30 Mar 2004
4559 \begin_layout Subsection*
4562 \begin_layout Description
4563 Action Creates a new buffer (that is, document) and switches to it.
4565 \begin_layout Description
4566 Notion Implicit path can be set in Preferences dialog.
4568 \begin_layout Description
4569 Syntax buffer-new [<FILE>]
4571 \begin_layout Description
4572 Params <FILE>: filename of created file with absolute path.
4575 \begin_layout Subsection*
4578 \begin_layout Description
4579 Action Creates a new buffer (that is, document) from a template.
4581 \begin_layout Description
4582 Notion Path for new files and templates can be set in Preferences dialog. Template will be asked for via Open-dialog.
4584 \begin_layout Description
4585 Syntax buffer-new-template [<FILE>]
4587 \begin_layout Description
4588 Params <FILE>: filename of created file with absolute path.
4591 \begin_layout Subsection*
4594 \begin_layout Description
4595 Action Switch to the next opened document.
4597 \begin_layout Description
4598 Notion Note that this does not necessarily mean next in tabbar (for full list see View menu).
4600 \begin_layout Description
4604 \begin_layout Subsection*
4607 \begin_layout Description
4608 Action Apply the given settings to the current document.
4610 \begin_layout Description
4611 Syntax buffer-params-apply [<ARGS>]
4613 \begin_layout Description
4614 Params <ARGS>: contains the particular settings to be saved. They obey the syntax you can find in document header of usual .lyx file.
4616 \begin_layout Description
4617 Origin leeming, 30 Mar 2004
4620 \begin_layout Subsection*
4623 \begin_layout Description
4624 Action Switch to the previous opened document.
4626 \begin_layout Description
4627 Syntax buffer-previous
4630 \begin_layout Subsection*
4633 \begin_layout Description
4634 Action Prints the current document.
4636 \begin_layout Description
4637 Notion Many settings can be given via the preferences dialog.
4639 \begin_layout Description
4640 Syntax buffer-print <TARGET> <TARGET-NAME> <COMMAND>
4642 \begin_layout Description
4643 Params <TARGET> is either "printer" or "file".
4644 \begin_inset Newline newline
4647 <TARGER-NAME> is either "default" or file name or printer name.
4648 \begin_inset Newline newline
4651 <COMMAND> command ensuring the printing job.
4653 \begin_layout Description
4654 Sample buffer-print file "/trash/newfile1.ps" "dvips"
4656 \begin_layout Description
4657 Origin leeming, 28 Mar 2004
4660 \begin_layout Subsection*
4663 \begin_layout Description
4664 Action Reverts opened document.
4666 \begin_layout Description
4667 Syntax buffer-reload
4669 \begin_layout Description
4670 Origin Asger, 2 Feb 1997
4673 \begin_layout Subsection*
4674 buffer-save-as-default
4676 \begin_layout Description
4677 Action Save the current document settings as default.
4679 \begin_layout Description
4680 Notion The file will will be saved into ~/.lyx/templates/defaults.lyx .
4682 \begin_layout Description
4683 Syntax buffer-save-as-default [<ARGS>]
4685 \begin_layout Description
4686 Params <ARGS>: contains the particular settings to be saved. They obey the syntax you can find in document header of usual .lyx file.
4688 \begin_layout Description
4689 Origin leeming, 30 Mar 2004
4692 \begin_layout Subsection*
4695 \begin_layout Description
4696 Action Display and switch to the given buffer.
4698 \begin_layout Description
4699 Syntax buffer-switch <BUFFER>
4701 \begin_layout Description
4702 Params <BUFFER>: path and filename of already opened (but possibly hidden) document which is to be shown.
4705 \begin_layout Subsection*
4706 buffer-toggle-compression
4708 \begin_layout Description
4709 Action Toggles compression of the current document on/off.
4711 \begin_layout Description
4712 Syntax buffer-toggle-compression
4714 \begin_layout Description
4715 Origin bpeng, 27 Apr 2006
4718 \begin_layout Subsection*
4719 buffer-toggle-read-only
4721 \begin_layout Description
4722 Action Toggle editing mode of the current document between read/write and read-only.
4724 \begin_layout Description
4725 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.
4727 \begin_layout Description
4728 Syntax buffer-toggle-read-only
4730 \begin_layout Description
4731 Origin Lgb, 27 May 1997
4734 \begin_layout Subsection*
4737 \begin_layout Description
4738 Action Exports the current document and put the result into the temporary directory.
4740 \begin_layout Description
4741 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).
4743 \begin_layout Description
4744 Syntax buffer-update [<FORMAT>]
4746 \begin_layout Description
4747 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.
4749 \begin_layout Description
4750 Origin Dekel, 5 Aug 2000
4753 \begin_layout Subsection*
4756 \begin_layout Description
4757 Action Displays current buffer in chosen format.
4759 \begin_layout Description
4760 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.
4762 \begin_layout Description
4763 Syntax buffer-view [<FORMAT>]
4765 \begin_layout Description
4766 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.
4769 \begin_layout Subsection*
4772 \begin_layout Description
4773 Action Saves the current buffer.
4775 \begin_layout Description
4776 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.
4778 \begin_layout Description
4782 \begin_layout Subsection*
4785 \begin_layout Description
4786 Action Save all changed documents.
4788 \begin_layout Description
4789 Syntax buffer-write-all
4791 \begin_layout Description
4792 Origin rgh, gpothier 6 Aug 2007
4795 \begin_layout Subsection*
4798 \begin_layout Description
4799 Action Rename and save current buffer.
4801 \begin_layout Description
4802 Syntax buffer-write-as <FILENAME>
4804 \begin_layout Description
4805 Params <FILENAME>: New name of the buffer/file. A relative path is with respect to the original location of the buffer/file.
4808 \begin_layout Subsection*
4811 \begin_layout Description
4812 Action Increases the zoom of the screen fonts.
4814 \begin_layout Description
4815 Syntax buffer-zoom-in [<ZOOM>]
4817 \begin_layout Description
4818 Params <ZOOM>: The zoom in %, the default is 20.
4820 \begin_layout Description
4821 Origin vfr, 30 Mar 2009
4824 \begin_layout Subsection*
4827 \begin_layout Description
4828 Action Decreases the zoom of the screen fonts.
4830 \begin_layout Description
4831 Syntax buffer-zoom-out [<ZOOM>]
4833 \begin_layout Description
4834 Params <ZOOM>: The zoom in %, the default is 20.
4836 \begin_layout Description
4837 Origin vfr, 30 Mar 2009
4840 \begin_layout Subsection*
4843 \begin_layout Description
4844 Action Generates the code (literate programming).
4846 \begin_layout Description
4847 Notion Latex file with extension
4849 literate_extension is generated. Then LyX invokes
4851 build_command (with a default of ``make'') to generate the code and
4853 build_error_filter to process the compilation error messages.
4854 \begin_inset Newline newline
4857 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:
4858 \begin_inset Newline newline
4863 build_command "my_script my_arguments"
4864 \begin_inset Newline newline
4869 build_error_filter differs from the
4871 literate_error_filter only in that the former will identify error messages from your compiler.
4873 \begin_layout Description
4874 Syntax build-program
4877 \begin_layout Subsection*
4880 \begin_layout Description
4881 Action Open LyX document.
4883 \begin_layout Description
4884 Syntax file-open [<FILE>]
4886 \begin_layout Description
4887 Params <FILE>: Filename to be opened.
4890 \begin_layout Subsection*
4893 \begin_layout Description
4894 Action Open the given help file according to the language setting.
4896 \begin_layout Description
4897 Syntax help-open <FILE>[.lyx]
4899 \begin_layout Description
4900 Params <FILE>: any document from (/usr/share/)doc directory.
4902 \begin_layout Description
4903 Origin Jug, 27 Jun 1999
4906 \begin_layout Subsection*
4909 \begin_layout Description
4910 Action Terminates the current LyX instance.
4912 \begin_layout Description
4913 Notion Terminates the current LyX instance, asking whether to save modified documents, etc.
4915 \begin_layout Description
4919 \begin_layout Subsection*
4920 master-buffer-update
4922 \begin_layout Description
4923 Action Update (export) the document built from the master buffer, if the current buffer is part of a master/child document.
4925 \begin_layout Description
4926 Syntax master-buffer-update [<FORMAT>]
4928 \begin_layout Description
4929 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.
4931 \begin_layout Description
4932 Origin Tommaso, 20 Sep 2007
4935 \begin_layout Subsection*
4938 \begin_layout Description
4939 Action Show a preview built from the master buffer, if available. if the current buffer is part of a master/child document.
4941 \begin_layout Description
4942 Syntax master-buffer-view [<FORMAT>]
4944 \begin_layout Description
4945 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.
4947 \begin_layout Description
4948 Origin Tommaso, 20 Sep 2007
4951 \begin_layout Subsection*
4954 \begin_layout Description
4955 Action Opens the menu given by its name.
4957 \begin_layout Description
4958 Syntax menu-open <NAME>
4960 \begin_layout Description
4961 Params <NAME>: menu name. See various .inc files in lib/ui for candidates.
4964 \begin_layout Subsection*
4967 \begin_layout Description
4968 Action Close the current tab group.
4970 \begin_layout Description
4971 Notion This only closes the work areas, not the buffers themselves. The still opened buffers can be visualized in another tab group.
4973 \begin_layout Description
4974 Syntax tab-group-close
4976 \begin_layout Description
4977 Origin Abdel, 21 Feb 2008
4980 \begin_layout Subsection*
4983 \begin_layout Description
4984 Action Toggles visibility of a given toolbar between on/off/auto.
4986 \begin_layout Description
4987 Notion Skipping "auto" when allowauto is false.
4989 \begin_layout Description
4990 Syntax toolbar-toggle <NAME> [allowauto]
4992 \begin_layout Description
4993 Params <NAME>: standard|extra|table|math|mathmacrotemplate|
4994 \begin_inset Newline newline
4997 minibuffer|review|view/update|math_panels|vcs| view-others|update-others
4999 \begin_layout Description
5000 Origin Edwin, 21 May 2007
5003 \begin_layout Subsection*
5006 \begin_layout Description
5007 Action Various UI visibility-toggling actions.
5009 \begin_layout Description
5010 Syntax ui-toggle <statusbar|menubar|scrollbar|frame|fullscreen>
5012 \begin_layout Description
5013 Params statusbar : Toggle visibility of the statusbar.
5014 \begin_inset Newline newline
5017 menubar : Toggle visibility of the menubar.
5018 \begin_inset Newline newline
5021 scrollbar : Toggle visibility of the scrollbar.
5022 \begin_inset Newline newline
5025 frame : Toggle visibility of the frames around editing window.
5026 \begin_inset Newline newline
5029 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.
5031 \begin_layout Description
5032 Origin sanda, 9 Feb 2007
5035 \begin_layout Subsection*
5038 \begin_layout Description
5039 Action Close the current document work area.
5041 \begin_layout Description
5042 Notion Close the current work area. If no other work areas are showing the buffer, then close the associated buffer as well.
5044 \begin_layout Description
5047 \begin_layout Description
5048 Origin Tommaso, 15 Sep 2012
5051 \begin_layout Subsection*
5054 \begin_layout Description
5055 Action Creates another split view of current buffer.
5057 \begin_layout Description
5058 Notion All split views act in the same way independently.
5060 \begin_layout Description
5061 Syntax view-split <vertical|horizontal>
5063 \begin_layout Description
5064 Params horizontal : The work areas are laid out side by side.
5065 \begin_inset Newline newline
5068 vertical : The work areas laid out vertically.
5070 \begin_layout Description
5071 Origin Abdel, 20 Feb 2008
5074 \begin_layout Subsection*
5077 \begin_layout Description
5078 Action Closes the current LyX window.
5080 \begin_layout Description
5083 \begin_layout Description
5084 Origin Abdel, 23 Oct 2006
5087 \begin_layout Subsection*
5090 \begin_layout Description
5091 Action Creates new empty LyX window.
5093 \begin_layout Description
5094 Notion Already opened documents from the previous window can be found under View menu.
5096 \begin_layout Description
5097 Syntax window-new [<GEOMETRY>]
5099 \begin_layout Description
5100 Params <GEOMETRY>: pass the geometry of the window. This parameter is currently accepted only on Windows platform.
5102 \begin_layout Description
5103 Origin Abdel, 21 Oct 2006
5106 \begin_layout Section
5107 System Functions (Preferences, LyX Server etc.)
5109 \begin_layout Subsection*
5110 buffer-toggle-output-sync
5112 \begin_layout Description
5113 Action Toggles including of resources for forward/reverse search of the given document.
5115 \begin_layout Description
5116 Notion When toggled on, SyncTeX is invoked for PDF, while srcltx package is used for DVI. Custom LaTeX macro can be defined in preferences.
5118 \begin_layout Description
5119 Syntax buffer-toggle-output-sync
5121 \begin_layout Description
5122 Origin sanda, 25 May 2010
5125 \begin_layout Subsection*
5128 \begin_layout Description
5129 Action Executes a command defined in a .def file.
5131 \begin_layout Description
5132 Notion The definitions are by default read from lib/commands/default.def.
5133 \begin_inset Newline newline
5136 A .def file allows to define a command with
5138 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).
5140 def_file "FileName" allows to include another .def file.
5141 \begin_inset Newline newline
5144 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.
5146 \begin_layout Description
5149 \begin_layout Description
5150 Params <NAME>: Name of the command that must be called.
5152 \begin_layout Description
5153 Origin broider, 2 Oct 2007
5156 \begin_layout Subsection*
5159 \begin_layout Description
5160 Action Cancels sequence prepared by LFUN_META_PREFIX .
5162 \begin_layout Description
5166 \begin_layout Subsection*
5167 command-alternatives
5169 \begin_layout Description
5170 Action Runs the first listed command that is enabled.
5172 \begin_layout Description
5173 Notion This can be used to bind multiple functions to a single key, and then which one is used will depend upon the context.
5175 \begin_layout Description
5176 Syntax command-alternatives <CMDS>
5178 \begin_layout Description
5179 Params <CMDS>: Sequence of commands separated by semicolons.
5181 \begin_layout Description
5182 Sample command-alternatives completion-accept;cell-forward
5184 \begin_layout Description
5185 Origin rgh, 24 September 2008
5188 \begin_layout Subsection*
5191 \begin_layout Description
5192 Action Run more commands (LFUN and its parameters) in a sequence.
5194 \begin_layout Description
5195 Syntax command-sequence <CMDS>
5197 \begin_layout Description
5198 Params <CMDS>: Sequence of commands separated by semicolons.
5200 \begin_layout Description
5201 Sample command-sequence cut; ert-insert; self-insert
5203 ; paste; self-insert {}; inset-toggle;
5205 \begin_layout Description
5206 Origin Andre, 11 Nov 1999
5209 \begin_layout Subsection*
5210 cursor-follows-scrollbar-toggle
5212 \begin_layout Description
5213 Action Determine whether to keep cursor inside the editing window regardless of the scrollbar movement.
5215 \begin_layout Description
5216 Syntax toggle-cursor-follows-scrollbar
5218 \begin_layout Description
5219 Origin ARRae, 2 Dec 1997
5222 \begin_layout Subsection*
5225 \begin_layout Description
5226 Action Set debug output level.
5228 \begin_layout Description
5229 Syntax debug-level-set <LEVEL>
5231 \begin_layout Description
5232 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.
5234 \begin_layout Description
5235 Origin sanda, 28 Dec 2009
5238 \begin_layout Subsection*
5241 \begin_layout Description
5242 Action Sets the cursor position in the previewed (dvi/pdf) file based on the row number in LyX window.
5244 \begin_layout Description
5245 Notion The external program used for forward search call can be specified in LyX Output preferences. See Additional manual for details of these settings.
5247 \begin_layout Description
5248 Syntax forward-search
5250 \begin_layout Description
5251 Origin sanda, 14 Apr 2010
5254 \begin_layout Subsection*
5257 \begin_layout Description
5258 Action Apply the given settings to user preferences.
5260 \begin_layout Description
5261 Syntax lyxrc-apply <SETTINGS>
5263 \begin_layout Description
5264 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.
5267 \begin_layout Subsection*
5270 \begin_layout Description
5271 Action Shows message in statusbar (for script purposes).
5273 \begin_layout Description
5274 Syntax message <STRING>
5276 \begin_layout Description
5277 Origin Lgb, 8 Apr 2001
5280 \begin_layout Subsection*
5283 \begin_layout Description
5284 Action Simulate halting Meta key (Alt key on PCs).
5286 \begin_layout Description
5287 Notion Used for buffer edition not for GUI control.
5289 \begin_layout Description
5293 \begin_layout Subsection*
5296 \begin_layout Description
5297 Action Save user preferences.
5299 \begin_layout Description
5300 Syntax preferences-save
5302 \begin_layout Description
5303 Origin Lgb, 27 Nov 1999
5306 \begin_layout Subsection*
5309 \begin_layout Description
5310 Action Reconfigure the automatic settings.
5312 \begin_layout Description
5315 \begin_layout Description
5316 Origin Asger, 14 Feb 1997
5319 \begin_layout Subsection*
5322 \begin_layout Description
5323 Action Returns path and file name of the currently edited document.
5325 \begin_layout Description
5326 Syntax server-get-filename
5329 \begin_layout Subsection*
5332 \begin_layout Description
5333 Action Returns the current layout (that is environment) name on the cursor position.
5335 \begin_layout Description
5336 Syntax server-get-layout
5339 \begin_layout Subsection*
5340 server-get-statistics
5342 \begin_layout Description
5343 Action Returns the statistics (number of words and characters) in the document or in the given selection.
5345 \begin_layout Description
5346 Notion Note that this function gives the number of words/chars written, not the number of characters which will be typeset.
5348 \begin_layout Description
5349 Syntax server-get-statistics [<TYPE>]
5351 \begin_layout Description
5352 Params <TYPE>: <words|chars|chars-space> The requested count; if not specified, the three values are returned, separated by a space.
5353 \begin_inset Newline newline
5357 \begin_inset Newline newline
5360 chars: count characters.
5361 \begin_inset Newline newline
5364 chars-space: count characters and spaces.
5366 \begin_layout Description
5367 Origin brokenclock, Oct 10 2014
5370 \begin_layout Subsection*
5373 \begin_layout Description
5374 Action Returns the coordinates of cursor position in the editing area.
5376 \begin_layout Description
5377 Syntax server-get-xy
5380 \begin_layout Subsection*
5381 server-goto-file-row
5383 \begin_layout Description
5384 Action Sets the cursor position in LyX based on the row number of generated TeX file.
5386 \begin_layout Description
5387 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).
5389 \begin_layout Description
5390 Syntax server-goto-file-row <FILE[.ext]> <ROW_NUMBER>
5392 \begin_layout Description
5393 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.
5394 \begin_inset Newline newline
5397 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).
5398 \begin_inset Newline newline
5401 .ext: extensions will be automatically replaced by .lyx.
5402 \begin_inset Newline newline
5405 <ROW_NUMBER> The row number of the LaTeX file to which to go.
5407 \begin_layout Description
5408 Sample server-goto-file-row /home/user/example.lyx 41
5409 \begin_inset Newline newline
5412 server-goto-file-row /tmp/lyx_tmpdir.XM3088/lyx_tmpbuf0/example.tex 41
5414 \begin_layout Description
5415 Origin Edmar, 23 Dec 1998
5418 \begin_layout Subsection*
5421 \begin_layout Description
5422 Action Sends notify message about the last key-sequence to client.
5424 \begin_layout Description
5425 Notion This can be used to grab last key-sequence used inside the LyX window. See also Debug extensions section in Additional features manual.
5427 \begin_layout Description
5428 Syntax server-notify
5431 \begin_layout Subsection*
5434 \begin_layout Description
5435 Action Sets the cursor position based on the editing area coordinates (similar to clicking on that point with left mouse button).
5437 \begin_layout Description
5438 Syntax server-set-xy <X> <Y>
5441 \begin_layout Subsection*
5444 \begin_layout Description
5445 Action Set the given LyX color to the color defined by the X11 name given.
5447 \begin_layout Description
5448 Notion A new color entry is created if the color is unknown. Color names can be stored as a part of user settings.
5450 \begin_layout Description
5451 Syntax set-color <LYX_NAME> <X11_NAME>
5453 \begin_layout Description
5454 Origin SLior, 11 Jun 2000
5457 \begin_layout Subsection*
5460 \begin_layout Description
5461 Action Count the statistics (number of words and characters) in the document or in the given selection and display it in a dialog box.
5463 \begin_layout Description
5464 Notion Note that this function gives the number of words/chars written, not the number of characters which will be typeset.
5466 \begin_layout Description
5469 \begin_layout Description
5470 Origin lasgouttes, Jan 27 2004; sanda, Jan 8 2008
5473 \begin_layout Subsection*
5476 \begin_layout Description
5477 Action Checks-in/commits the changes of the registered file to the repository.
5479 \begin_layout Description
5480 Notion In RCS case this also unlocks the file.
5482 \begin_layout Description
5485 \begin_layout Description
5486 Origin Lgb, 1 Jul 1997
5489 \begin_layout Subsection*
5492 \begin_layout Description
5493 Action Checks-out the document for edit (and locks it in some cases).
5495 \begin_layout Description
5498 \begin_layout Description
5499 Origin Lgb, 1 Jul 1997
5502 \begin_layout Subsection*
5505 \begin_layout Description
5506 Action Executes external command. This command is intended to support additional VCS commands.
5508 \begin_layout Description
5509 Syntax vc-command <FLAG> <PATH> <COMMAND>
5511 \begin_layout Description
5512 Params <FLAG>: Flags for the command can be combined together.
5513 \begin_inset Newline newline
5516 U - dUmmy - no flags
5517 \begin_inset Newline newline
5520 D - Doc - need document loaded to proceed
5521 \begin_inset Newline newline
5524 I - dIrty - mark document dirty
5525 \begin_inset Newline newline
5528 R - Reload - ensure that the document is saved and reload it after command execution
5529 \begin_inset Newline newline
5532 M - Message - ask for input string (commit message)
5533 \begin_inset Newline newline
5536 <PATH>: path where to start. $$p will be replaced by the current document path.
5537 \begin_inset Newline newline
5540 <COMMAND>: command to execute. $$i/$$p/$$m will be replaced by the current document(with absolute path)/path/message.
5542 \begin_layout Description
5543 Sample vc-command DR $$p "svn up"
5545 \begin_layout Description
5546 Origin sanda, 13 Jan 2009
5549 \begin_layout Subsection*
5552 \begin_layout Description
5553 Action Compares two revisions of the same file under version control.
5555 \begin_layout Description
5556 Syntax vc-compare [<REV1>] [<REV2>]
5558 \begin_layout Description
5559 Params Revision number either points directly to commit in history or if negative number -x it points to (last commit - x).
5560 \begin_inset Newline newline
5563 In RCS we subtract only in the last number of revision specification. Special case "0" is reserved for the last committed revision.
5564 \begin_inset Newline newline
5568 \begin_inset Newline newline
5571 <REV2>: Newer file. Used only if REV1 > 0.
5572 \begin_inset Newline newline
5575 If no parameter is given, interactive dialog will be shown.
5577 \begin_layout Description
5578 Sample Compare current document against last commit
5579 \begin_inset Newline newline
5583 \begin_inset Newline newline
5586 Compare current document against current revision - 5 commits
5587 \begin_inset Newline newline
5591 \begin_inset Newline newline
5594 Compare revisions 120 and 155
5595 \begin_inset Newline newline
5600 \begin_layout Description
5601 Origin sanda, 12 Feb 2010
5604 \begin_layout Subsection*
5607 \begin_layout Description
5608 Action Copies the document to another name.
5610 \begin_layout Description
5611 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.
5613 \begin_layout Description
5614 Syntax vc-copy <FILENAME>
5616 \begin_layout Description
5617 Params <FILENAME>: New name of the document.
5618 \begin_inset Newline newline
5621 A file dialog is opened if no filename is given.
5623 \begin_layout Description
5624 Origin gb, 05 Feb 2013
5627 \begin_layout Subsection*
5630 \begin_layout Description
5631 Action Toggles the locking property of the edited file.
5633 \begin_layout Description
5634 Notion This is currently implemented only for SVN.
5636 \begin_layout Description
5637 Syntax vc-locking-toggle
5639 \begin_layout Description
5640 Origin sanda, 25 Jun 2009
5643 \begin_layout Subsection*
5646 \begin_layout Description
5647 Action Register the document as an file inside version control system.
5649 \begin_layout Description
5650 Notion File is registered inside cvs, svn or rcs repository acording to the existence of cvs/svn/rcs entries in the document's directory.
5651 \begin_inset Newline newline
5654 See LyX Additional Features Manual (Version Control Chapter) for additional information.
5656 \begin_layout Description
5659 \begin_layout Description
5660 Origin Lgb, 1 Jul 1997
5663 \begin_layout Subsection*
5666 \begin_layout Description
5667 Action Renames the document to another name.
5669 \begin_layout Description
5670 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.
5672 \begin_layout Description
5673 Syntax vc-rename <FILENAME>
5675 \begin_layout Description
5676 Params <FILENAME>: New name of the document.
5677 \begin_inset Newline newline
5680 A file dialog is opened if no filename is given.
5682 \begin_layout Description
5683 Origin gb, 05 Feb 2013
5686 \begin_layout Subsection*
5689 \begin_layout Description
5690 Action Update the local archive directory in which resides the current document with the remote repository.
5692 \begin_layout Description
5693 Syntax vc-repo-update
5695 \begin_layout Description
5696 Origin sanda, 16 Oct 2009
5699 \begin_layout Subsection*
5702 \begin_layout Description
5703 Action Reverts the document to the last check-in/commit in VCS.
5705 \begin_layout Description
5708 \begin_layout Description
5709 Origin Lgb, 1 Jul 1997
5712 \begin_layout Subsection*
5715 \begin_layout Description
5716 Action Undo last check-in.
5718 \begin_layout Description
5719 Notion This is currently implemented only for RCS.
5721 \begin_layout Description
5724 \begin_layout Description
5725 Origin Lgb, 1 Jul 1997
5728 \begin_layout Section
5729 Hidden Functions (not listed for configuration)
5731 \begin_layout Subsection*
5734 \begin_layout Description
5735 Action Return the current key sequence and available options as a string.
5737 \begin_layout Description
5738 Notion No options are added if no current map exists.
5739 \begin_inset Newline newline
5742 This is probably usable only with connection to lyxserver.
5744 \begin_layout Description
5745 Syntax command-prefix
5748 \begin_layout Subsection*
5751 \begin_layout Description
5752 Action Inserts the given string (accordingly to the correct keymap).
5754 \begin_layout Description
5755 Notion Automatically replace the currently selected text. Depends on lyxrc settings "auto_region_delete".
5757 \begin_layout Description
5758 Syntax self-insert <STRING>