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
19 \language_package default
24 \font_typewriter default
26 \font_default_family default
27 \use_non_tex_fonts false
33 \default_output_format default
35 \bibtex_command default
36 \index_command default
37 \paperfontsize default
42 \use_package amsmath 1
43 \use_package amssymb 1
46 \use_package mathdots 0
47 \use_package mathtools 0
49 \use_package stackrel 0
50 \use_package stmaryrd 0
51 \use_package undertilde 0
53 \cite_engine_type default
57 \paperorientation portrait
71 \paragraph_separation indent
72 \paragraph_indentation default
73 \quotes_language english
76 \paperpagestyle default
77 \tracking_changes false
98 \begin_layout Section*
102 \begin_layout Standard
103 This manual documents the
104 \begin_inset Quotes eld
108 \begin_inset Quotes erd
112 These are commands that are used to make LyX perform specific actions.
113 LyX itself uses these functions internally, and every internal action is
117 \begin_layout Standard
118 LFUNs are also used in the files that define keyboard shortcuts, menu or
120 So if you want to change\SpecialChar \slash{}
121 customize the user interface, you need to deal
123 Furthermore, external programs can use LFUNs to communicate with and
124 \begin_inset Quotes eld
128 \begin_inset Quotes erd
132 Finally, you can also issue LFUNs directly via the so called mini-buffer
133 which can be opened via
136 arg "command-execute"
142 \begin_layout Standard
143 In the following, all LFUNs are listed, categorized by function.
146 \begin_layout Section
147 Layout Functions (Font, Layout and Textclass related)
149 \begin_layout Subsection*
152 \begin_layout Description
153 Action Displays list of layout choices.
155 \begin_layout Description
156 Notion In the current (as of 2007) Qt4 frontend, this LFUN opens the dropbox allowing for choice of layout.
158 \begin_layout Description
159 Syntax drop-layouts-choice
162 \begin_layout Subsection*
165 \begin_layout Description
166 Action Splits the current environment with a Separator.
168 \begin_layout Description
169 Syntax environment-split [outer]
171 \begin_layout Description
172 Params outer: If this is given, LyX will split the outermost environment in the current nesting hierarchy.
174 \begin_layout Description
175 Origin spitz, 23 Dec 2012
178 \begin_layout Subsection*
181 \begin_layout Description
182 Action Toggles the bold font (selection-wise) using mathbf in math.
184 \begin_layout Description
188 \begin_layout Subsection*
191 \begin_layout Description
192 Action Toggles the bold font (selection-wise) using boldsymbol in math.
194 \begin_layout Description
195 Syntax font-boldsymbol
198 \begin_layout Subsection*
201 \begin_layout Description
202 Action Reverts the settings of the font to the default values (selection-wise).
204 \begin_layout Description
208 \begin_layout Subsection*
211 \begin_layout Description
212 Action Toggles the emphasis font style (selection-wise).
214 \begin_layout Description
218 \begin_layout Subsection*
221 \begin_layout Description
222 Action Toggles Fraktur family font (math-mode, selection-wise).
224 \begin_layout Description
227 \begin_layout Description
228 Origin vermeer, 10 Jan 2002
231 \begin_layout Subsection*
234 \begin_layout Description
235 Action Toggles Italics font shape (math-mode, selection-wise).
237 \begin_layout Description
240 \begin_layout Description
241 Origin vermeer, 10 Jan 2002
244 \begin_layout Subsection*
247 \begin_layout Description
248 Action Toggles Noun text style font (selection-wise).
250 \begin_layout Description
254 \begin_layout Subsection*
257 \begin_layout Description
258 Action Toggles Roman family font (selection-wise).
260 \begin_layout Description
264 \begin_layout Subsection*
267 \begin_layout Description
268 Action Toggles Sans Serif family font (selection-wise).
270 \begin_layout Description
274 \begin_layout Subsection*
277 \begin_layout Description
278 Action Sets font size according to lyx format string.
280 \begin_layout Description
281 Syntax font-size <SIZE>
283 \begin_layout Description
284 Params <SIZE>: tiny|scriptsize|footnotesize|small|normal|large|larger|
285 \begin_inset Newline newline
288 largest|huge|giant|increase|decrease|default
291 \begin_layout Subsection*
294 \begin_layout Description
295 Action Returns the info about the current font.
297 \begin_layout Description
301 \begin_layout Subsection*
304 \begin_layout Description
305 Action Toggles strikeout (strike-through) in the font (selection-wise).
307 \begin_layout Description
308 Syntax font-strikeout
310 \begin_layout Description
311 Origin sanda, 3 May 2009
314 \begin_layout Subsection*
317 \begin_layout Description
318 Action Toggles the typewriter family font (selection-wise).
320 \begin_layout Description
321 Syntax font-typewriter
324 \begin_layout Subsection*
327 \begin_layout Description
328 Action Toggles underline in the font (selection-wise).
330 \begin_layout Description
331 Syntax font-underline
334 \begin_layout Subsection*
337 \begin_layout Description
338 Action Toggles double underline in the font (selection-wise).
340 \begin_layout Description
341 Syntax font-underunderline
343 \begin_layout Description
344 Origin sanda, 5 May 2009
347 \begin_layout Subsection*
350 \begin_layout Description
351 Action Toggles wavy underline in the font (selection-wise).
353 \begin_layout Description
354 Syntax font-underwave
356 \begin_layout Description
357 Origin sanda, 5 May 2009
360 \begin_layout Subsection*
363 \begin_layout Description
364 Action Sets the layout (that is, environment) for the current paragraph.
366 \begin_layout Description
367 Syntax layout <LAYOUT>
369 \begin_layout Description
370 Params <LAYOUT>: the layout to use
373 \begin_layout Subsection*
376 \begin_layout Description
377 Action Adds a module.
379 \begin_layout Description
380 Notion Adds a module to the list of included modules for the current buffer.
382 \begin_layout Description
383 Syntax layout-module-add <MODULE>
385 \begin_layout Description
386 Params <MODULE>: the module to be added
388 \begin_layout Description
389 Origin rgh, 25 August 2007
392 \begin_layout Subsection*
395 \begin_layout Description
396 Action Clears the module list.
398 \begin_layout Description
399 Notion Clears the list of included modules for the current buffer.
401 \begin_layout Description
402 Syntax layout-modules-clear
404 \begin_layout Description
405 Origin rgh, 25 August 2007
408 \begin_layout Subsection*
411 \begin_layout Description
412 Action Launches the paragraph settings dialog.
414 \begin_layout Description
415 Syntax layout-paragraph
418 \begin_layout Subsection*
421 \begin_layout Description
422 Action Reloads layout information.
424 \begin_layout Description
425 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.
427 \begin_layout Description
430 \begin_layout Description
431 Origin rgh, 3 September 2007
434 \begin_layout Subsection*
437 \begin_layout Description
438 Action Launches the tabular settings dialog.
440 \begin_layout Description
441 Syntax layout-tabular
443 \begin_layout Description
444 Origin Jug, 31 Jul 2000
447 \begin_layout Subsection*
450 \begin_layout Description
451 Action Update fonts and its metrics.
453 \begin_layout Description
454 Notion Automatically called after zoom, dpi, font names, or norm change.
456 \begin_layout Description
457 Syntax screen-font-update
459 \begin_layout Description
460 Origin ARRae, 13 Aug 2000
463 \begin_layout Subsection*
466 \begin_layout Description
467 Action Sets the text class for the current buffer.
469 \begin_layout Description
470 Syntax textclass-apply <TEXTCLASS>
472 \begin_layout Description
473 Params <TEXTCLASS>: the textclass to set. Note that this must be the filename, minus the ".layout" extension.
476 \begin_layout Subsection*
479 \begin_layout Description
480 Action Loads information for a textclass from disk.
482 \begin_layout Description
483 Syntax textclass-load <TEXTCLASS>
485 \begin_layout Description
486 Params <TEXTCLASS>: the textclass to load. Note that this must be the filename, minus the ".layout" extension.
489 \begin_layout Subsection*
492 \begin_layout Description
493 Action Toggle user-defined (=last-time used) text style.
495 \begin_layout Description
496 Notion This style is set via LFUN_TEXTSTYLE_UPDATE, which is automatically triggered when using Text Style dialog.
498 \begin_layout Description
499 Syntax textstyle-apply
501 \begin_layout Description
502 Origin leeming, 12 Mar 2003
505 \begin_layout Subsection*
508 \begin_layout Description
509 Action Apply text style and update the settings to be used by LFUN_TEXTSTYLE_APPLY.
511 \begin_layout Description
512 Syntax textstyle-update <FONT_INFO>
514 \begin_layout Description
515 Params <FONT_INFO>: specifies font atributes, e.g. family, series, shape, size, emph, noun, underbar, number, color, language, toggleall.
516 \begin_inset Newline newline
519 Use lyx -dbg action for exact syntax of text-style dialog parameters.
521 \begin_layout Description
522 Origin leeming, 12 Mar 2003
525 \begin_layout Section
526 Editing Functions (Cursor and Mouse Movement, Copy/Paste etc.)
528 \begin_layout Subsection*
531 \begin_layout Description
532 Action Adds an acute accent to the next character typed.
534 \begin_layout Description
538 \begin_layout Subsection*
541 \begin_layout Description
542 Action Adds a breve accent to the next character typed.
544 \begin_layout Description
548 \begin_layout Subsection*
551 \begin_layout Description
552 Action Adds a caron to the next character typed.
554 \begin_layout Description
558 \begin_layout Subsection*
561 \begin_layout Description
562 Action Adds a cedilla to the next character typed.
564 \begin_layout Description
565 Syntax accent-cedilla
568 \begin_layout Subsection*
571 \begin_layout Description
572 Action Adds a circle accent to the next character typed.
574 \begin_layout Description
578 \begin_layout Subsection*
581 \begin_layout Description
582 Action Adds a circumflex to the next character typed.
584 \begin_layout Description
585 Syntax accent-circumflex
588 \begin_layout Subsection*
591 \begin_layout Description
592 Action Adds a dot accent to the next character typed.
594 \begin_layout Description
598 \begin_layout Subsection*
601 \begin_layout Description
602 Action Adds a grave accent to the next character typed.
604 \begin_layout Description
608 \begin_layout Subsection*
609 accent-hungarian-umlaut
611 \begin_layout Description
612 Action Adds a Hungarian umlaut to the next character typed.
614 \begin_layout Description
618 \begin_layout Subsection*
621 \begin_layout Description
622 Action Adds a macron to the next character typed.
624 \begin_layout Description
628 \begin_layout Subsection*
631 \begin_layout Description
632 Action Adds an ogonek accent to the next character typed.
634 \begin_layout Description
638 \begin_layout Subsection*
641 \begin_layout Description
642 Action Adds a tie over the next two character typed.
644 \begin_layout Description
645 Notion The following char will finish the tie.
647 \begin_layout Description
651 \begin_layout Subsection*
654 \begin_layout Description
655 Action Adds a tilde over the next character typed.
657 \begin_layout Description
661 \begin_layout Subsection*
664 \begin_layout Description
665 Action Adds an umlaut over the next character typed.
667 \begin_layout Description
671 \begin_layout Subsection*
674 \begin_layout Description
675 Action Adds a bar under the next character typed.
677 \begin_layout Description
678 Syntax accent-underbar
681 \begin_layout Subsection*
684 \begin_layout Description
685 Action Adds a dot under the next character typed.
687 \begin_layout Description
688 Syntax accent-underdot
691 \begin_layout Subsection*
694 \begin_layout Description
695 Action Accepts all tracked changes in the document.
697 \begin_layout Description
698 Syntax all-changes-accept
700 \begin_layout Description
701 Origin Levon, 16 Oct 2002
704 \begin_layout Subsection*
707 \begin_layout Description
708 Action Rejects all tracked changes in the document.
710 \begin_layout Description
711 Notion Reject does not work recursively; the user may have to repeat the operation.
713 \begin_layout Description
714 Syntax all-changes-reject
716 \begin_layout Description
717 Origin Levon, 16 Oct 2002
720 \begin_layout Subsection*
723 \begin_layout Description
724 Action Start (or remove) Appendix on the given cursor position.
726 \begin_layout Description
729 \begin_layout Description
730 Origin ettrich, 5 May 1998
733 \begin_layout Subsection*
736 \begin_layout Description
737 Action Inserts an argument (short title) inset.
739 \begin_layout Description
740 Syntax argument-insert <argument nr>
742 \begin_layout Description
743 Params <argument nr>: see layout declarations
745 \begin_layout Description
746 Origin vermeer, 12 Aug 2002
749 \begin_layout Subsection*
752 \begin_layout Description
753 Action Adds database, which will be used for bibtex citations.
755 \begin_layout Description
756 Notion Databases are added to the first BibTeX inset (Inset->List/TOC->BibTeX bibliography) found from the cursor position.
758 \begin_layout Description
759 Syntax bibtex-database-add <DATABASE-NAME>
761 \begin_layout Description
762 Origin Ale, 30 May 1997
765 \begin_layout Subsection*
768 \begin_layout Description
769 Action Adds database, which will be used for bibtex citations.
771 \begin_layout Description
772 Notion Databases are deleted from the first BibTeX inset (Inset->List/TOC->BibTeX bibliography) found from the cursor position.
774 \begin_layout Description
775 Syntax bibtex-database-del <DATABASE-NAME>
777 \begin_layout Description
778 Origin Ale, 30 May 1997
781 \begin_layout Subsection*
784 \begin_layout Description
785 Action Clears the list of saved bookmarks.
787 \begin_layout Description
788 Syntax bookmark-clear
790 \begin_layout Description
791 Origin bpeng, 31 October 2006
794 \begin_layout Subsection*
797 \begin_layout Description
798 Action Moves the cursor to the numbered bookmark, opening the file if necessary. Note that bookmarks are saved per-session, not per file.
800 \begin_layout Description
801 Notion Bookmark 0 has a special purpose. It is automatically set
802 \begin_inset Newline newline
805 1. to the paragraph you are currently editing
806 \begin_inset Newline newline
809 2. to the paragraph from where you are jumping to the last-edited position (jump-back feature)
810 \begin_inset Newline newline
813 3. when jumping from crossreference to the requested label by LFUN_LABEL_GOTO.
815 \begin_layout Description
816 Syntax bookmark-goto <NUMBER>
818 \begin_layout Description
819 Params <NUMBER>: the number of the bookmark to restore.
821 \begin_layout Description
822 Origin Dekel, 27 January 2001
825 \begin_layout Subsection*
828 \begin_layout Description
829 Action Save a bookmark.
831 \begin_layout Description
832 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.
834 \begin_layout Description
835 Syntax bookmark-save <NUMBER>
837 \begin_layout Description
838 Params <NUMBER>: the number of the bookmark to save.
840 \begin_layout Description
841 Origin Dekel, 27 January 2001
844 \begin_layout Subsection*
847 \begin_layout Description
848 Action Inserts Box inset.
850 \begin_layout Description
851 Syntax box-insert [<TYPE>]
853 \begin_layout Description
854 Params <TYPE>: Boxed|Frameless|Framed|ovalbox|Ovalbox|Shadowbox|Shaded|Doublebox
855 \begin_inset Newline newline
858 Framed is the default one.
860 \begin_layout Description
861 Origin vermeer, 7 Oct 2003
864 \begin_layout Subsection*
867 \begin_layout Description
868 Action Inserts branch inset.
870 \begin_layout Description
871 Syntax branch-insert <BRANCH-NAME>
873 \begin_layout Description
874 Origin vermeer, 17 Aug 2003
877 \begin_layout Subsection*
880 \begin_layout Description
881 Action Move the cursor to the beginning of the document.
883 \begin_layout Description
887 \begin_layout Subsection*
890 \begin_layout Description
891 Action Move the cursor to the beginning of the document adding the traversed text to the selection.
893 \begin_layout Description
894 Syntax buffer-begin-select
897 \begin_layout Subsection*
900 \begin_layout Description
901 Action Move the cursor to the end of the document.
903 \begin_layout Description
907 \begin_layout Subsection*
910 \begin_layout Description
911 Action Move the cursor to the end of the document adding the traversed text to the selection.
913 \begin_layout Description
914 Syntax buffer-end-select
917 \begin_layout Subsection*
920 \begin_layout Description
921 Action Inserts a caption inset.
923 \begin_layout Description
924 Syntax caption-insert
926 \begin_layout Description
927 Origin Lgb, 18 Jul 2000
930 \begin_layout Subsection*
933 \begin_layout Description
934 Action Moves the cursor to the previous cell inside the table.
936 \begin_layout Description
939 \begin_layout Description
940 Origin Jug, 22 May 2000
943 \begin_layout Subsection*
946 \begin_layout Description
947 Action Moves the cursor to the next cell inside the table.
949 \begin_layout Description
953 \begin_layout Subsection*
956 \begin_layout Description
957 Action Splits cell and shifts right part to the next cell (inside the math grid).
959 \begin_layout Description
962 \begin_layout Description
963 Origin Ale, 15 May 1997
966 \begin_layout Subsection*
969 \begin_layout Description
970 Action Accepts tracked change inside the selection.
972 \begin_layout Description
975 \begin_layout Description
976 Origin Levon, 16 Oct 2002
979 \begin_layout Subsection*
982 \begin_layout Description
983 Action Moves the cursor to the position of the next change of the change tracking records.
985 \begin_layout Description
988 \begin_layout Description
989 Origin schmitt, 4 Oct 2006
992 \begin_layout Subsection*
995 \begin_layout Description
996 Action Moves the cursor to the position of the previous change of the change tracking records.
998 \begin_layout Description
999 Syntax change-previous
1001 \begin_layout Description
1002 Origin vfr, 4 Apr 2009
1005 \begin_layout Subsection*
1008 \begin_layout Description
1009 Action Rejects tracked change inside the selection.
1011 \begin_layout Description
1012 Syntax change-reject
1014 \begin_layout Description
1015 Origin Levon, 16 Oct 2002
1018 \begin_layout Subsection*
1021 \begin_layout Description
1022 Action Open change tracking dialog for merging and moves the cursor to the position of the next change.
1024 \begin_layout Description
1025 Syntax changes-merge
1027 \begin_layout Description
1028 Origin Levon, 16 Oct 2002
1031 \begin_layout Subsection*
1034 \begin_layout Description
1035 Action Toggles showing of change tracking in typesetted output.
1037 \begin_layout Description
1038 Syntax changes-output
1040 \begin_layout Description
1041 Origin jspitzm, 21 Jan 2005
1044 \begin_layout Subsection*
1047 \begin_layout Description
1048 Action Toggles change tracking to on/off.
1050 \begin_layout Description
1051 Syntax changes-track
1053 \begin_layout Description
1054 Origin levon, 1 Oct 2002
1057 \begin_layout Subsection*
1060 \begin_layout Description
1061 Action Moves the cursor one position logically backwards.
1063 \begin_layout Description
1064 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.
1066 \begin_layout Description
1067 Syntax char-backward
1070 \begin_layout Subsection*
1071 char-backward-select
1073 \begin_layout Description
1074 Action Moves the cursor one position logically backwards, adding traversed position to the selection.
1076 \begin_layout Description
1077 Notion See also LFUN_CHAR_BACKWARD.
1079 \begin_layout Description
1080 Syntax char-backward-select
1083 \begin_layout Subsection*
1084 char-delete-backward
1086 \begin_layout Description
1087 Action Deletes one character in the backward direction (usually the "BackSpace" key).
1089 \begin_layout Description
1090 Syntax char-delete-backward
1093 \begin_layout Subsection*
1096 \begin_layout Description
1097 Action Deletes one character in the backward direction (usually the "Delete" key).
1099 \begin_layout Description
1100 Syntax char-delete-forward
1103 \begin_layout Subsection*
1106 \begin_layout Description
1107 Action Moves the cursor one position logically forward.
1109 \begin_layout Description
1110 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.
1112 \begin_layout Description
1116 \begin_layout Subsection*
1119 \begin_layout Description
1120 Action Moves the cursor one position logically forward, adding traversed position to the selection.
1122 \begin_layout Description
1123 Notion See also LFUN_CHAR_FORWARD.
1125 \begin_layout Description
1126 Syntax char-forward-select
1129 \begin_layout Subsection*
1132 \begin_layout Description
1133 Action Moves the cursor one position "to the left".
1135 \begin_layout Description
1136 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.
1138 \begin_layout Description
1142 \begin_layout Subsection*
1145 \begin_layout Description
1146 Action Moves the cursor one position "to the left", adding traversed position to the selection.
1148 \begin_layout Description
1149 Notion See also LFUN_CHAR_LEFT for exact details of the movement.
1151 \begin_layout Description
1152 Syntax char-left-select
1155 \begin_layout Subsection*
1158 \begin_layout Description
1159 Action Moves the cursor one position "to the right".
1161 \begin_layout Description
1162 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.
1164 \begin_layout Description
1168 \begin_layout Subsection*
1171 \begin_layout Description
1172 Action Moves the cursor one position "to the right", adding traversed position to the selection.
1174 \begin_layout Description
1175 Notion See also LFUN_CHAR_RIGHT for exact details of the movement.
1177 \begin_layout Description
1178 Syntax char-right-select
1181 \begin_layout Subsection*
1184 \begin_layout Description
1185 Action Transposes the character at the cursor with the one before it.
1187 \begin_layout Description
1188 Syntax chars-transpose
1190 \begin_layout Description
1191 Origin Lgb, 25 Apr 2001
1194 \begin_layout Subsection*
1197 \begin_layout Description
1198 Action Inserts citation from loaded citation database.
1200 \begin_layout Description
1201 Syntax citation-insert [<KEY>[|<TEXT_BEFORE>]]
1203 \begin_layout Description
1204 Params <KEY>: Citation (shortcut listed in available citations).
1205 \begin_inset Newline newline
1208 <TEXT_BEFORE>: text which should appear before citation.
1210 \begin_layout Description
1211 Origin AAS, 97-02-23
1214 \begin_layout Subsection*
1217 \begin_layout Description
1218 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 colums if tha paste happens in a tabular inset.
1220 \begin_layout Description
1221 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.
1223 \begin_layout Description
1224 Syntax clipboard-paste [<ARG>]
1226 \begin_layout Description
1227 Params <ARG>: "paragraph" will cause pasting as one paragraph, i.e. "Join lines".
1229 \begin_layout Description
1230 Origin Georg, 10 Jul 2006
1233 \begin_layout Subsection*
1234 clipboard-paste-simple
1236 \begin_layout Description
1237 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 colums if the paste happens in a tabular inset.
1239 \begin_layout Description
1240 Syntax clipboard-paste-simple [<ARG>]
1242 \begin_layout Description
1243 Params <ARG>: "paragraph" will cause pasting as one paragraph, i.e. "Join lines".
1246 \begin_layout Subsection*
1249 \begin_layout Description
1250 Action Switches the focus to the minibuffer so that the user can type in there. If necessary, it opens the minibuffer toolbar.
1252 \begin_layout Description
1253 Notion Usually bound to M-x shortcut.
1255 \begin_layout Description
1256 Syntax command-execute
1259 \begin_layout Subsection*
1262 \begin_layout Description
1263 Action Try to complete the word or command at the cursor position.
1265 \begin_layout Description
1268 \begin_layout Description
1269 Origin sts, Feb 19 2008
1272 \begin_layout Subsection*
1275 \begin_layout Description
1276 Action Accept suggested completion.
1278 \begin_layout Description
1279 Syntax completion-accept
1281 \begin_layout Description
1282 Origin sanda, Sep 08 2008
1285 \begin_layout Subsection*
1288 \begin_layout Description
1289 Action Try to cancel completion, either the popup or the inline completion.
1291 \begin_layout Description
1292 Syntax completion-cancel
1294 \begin_layout Description
1295 Origin sts, Sep 07 2008
1298 \begin_layout Subsection*
1301 \begin_layout Description
1302 Action Show the inline completion at the cursor position.
1304 \begin_layout Description
1305 Syntax completion-inline
1307 \begin_layout Description
1308 Origin sts, Feb 19 2008
1311 \begin_layout Subsection*
1314 \begin_layout Description
1315 Action Show the completion popup at the cursor position.
1317 \begin_layout Description
1318 Syntax completion-popup
1320 \begin_layout Description
1321 Origin sts, Feb 19 2008
1324 \begin_layout Subsection*
1327 \begin_layout Description
1328 Action Copies the current selection to the clipboard.
1330 \begin_layout Description
1334 \begin_layout Subsection*
1335 copy-label-as-reference
1337 \begin_layout Description
1338 Action Copies the label at the cursor as a cross-reference to be pasted elsewhere.
1340 \begin_layout Description
1341 Syntax copy-label-as-reference <LABEL>
1343 \begin_layout Description
1344 Params <LABEL>: The label to copy (for multi-line math)
1346 \begin_layout Description
1347 Origin sts, 16 Nov 2008
1350 \begin_layout Subsection*
1353 \begin_layout Description
1354 Action Cuts to the clipboard.
1356 \begin_layout Description
1360 \begin_layout Subsection*
1363 \begin_layout Description
1364 Action Inserts the current date.
1366 \begin_layout Description
1367 Syntax date-insert [<ARG>]
1369 \begin_layout Description
1370 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.
1372 \begin_layout Description
1373 Origin jdblair, 31 Jan 2000
1376 \begin_layout Subsection*
1379 \begin_layout Description
1380 Action Decrease the nesting depth of the (selected) paragraph(s) inside lists.
1382 \begin_layout Description
1383 Syntax depth-decrement
1386 \begin_layout Subsection*
1389 \begin_layout Description
1390 Action Increase the nesting depth of the (selected) paragraph(s) inside lists.
1392 \begin_layout Description
1393 Syntax depth-increment
1396 \begin_layout Subsection*
1397 dialog-disconnect-inset
1399 \begin_layout Description
1400 Action Closes opened connection to opened inset.
1402 \begin_layout Description
1403 Notion Connection is used for apply functions.
1405 \begin_layout Description
1406 Syntax dialog-disconnect-inset <INSET-NAME>
1408 \begin_layout Description
1409 Origin leeming, 25 Feb 2003
1412 \begin_layout Subsection*
1415 \begin_layout Description
1416 Action Hides showed dialog. Counterpart to LFUN_DIALOG_SHOW .
1418 \begin_layout Description
1419 Syntax dialog-hide <NAME>
1421 \begin_layout Description
1422 Params See LFUN_DIALOG_SHOW .
1424 \begin_layout Description
1425 Origin leeming, 25 Feb 2003
1428 \begin_layout Subsection*
1431 \begin_layout Description
1432 Action Shows hidden dialog or creates new one for a given function/inset settings etc.
1434 \begin_layout Description
1435 Syntax dialog-show <NAME> [<DATA>]
1437 \begin_layout Description
1438 Params <NAME>: aboutlyx|bibitem|bibtex|box|branch|changes|character|citation|
1439 \begin_inset Newline newline
1442 compare|document|errorlist|ert|external|file|findreplace|findreplaceadv|float|
1443 \begin_inset Newline newline
1446 graphics|href|include|index|index_print|info|label|line|listings|log|mathdelimiter|
1447 \begin_inset Newline newline
1450 mathmatrix|mathspace|nomenclature|nomencl_print|note|paragraph|phantom|prefs|
1451 \begin_inset Newline newline
1454 print|ref|sendto|space|spellchecker|symbols|tabular|tabularcreate|
1455 \begin_inset Newline newline
1458 thesaurus|texinfo|toc|view-source|vspace|wrap|<SPECIAL>
1459 \begin_inset Newline newline
1462 <SPECIAL>: latexlog|vclog
1463 \begin_inset Newline newline
1466 <DATA>: data, usually settings for the given dialog. Use debug mode for the details.
1468 \begin_layout Description
1469 Origin leeming, 17 Jun 2003
1472 \begin_layout Subsection*
1473 dialog-show-new-inset
1475 \begin_layout Description
1476 Action Shows hidden dialog or create new one for a given inset settings etc.
1478 \begin_layout Description
1479 Notion Internally uses LFUN_DIALOG_SHOW with processed data for a given inset.
1481 \begin_layout Description
1482 Syntax dialog-show-new-inset <NAME> [<DATA>]
1484 \begin_layout Description
1485 Params See LFUN_DIALOG_SHOW .
1487 \begin_layout Description
1488 Origin leeming, 25 Feb 2003
1491 \begin_layout Subsection*
1494 \begin_layout Description
1495 Action Toggles dialog between showed/hidden state.
1497 \begin_layout Description
1498 Notion Internally uses LFUN_DIALOG_SHOW , LFUN_DIALOG_HIDE .
1500 \begin_layout Description
1501 Syntax dialog-toggle <NAME> [<DATA>]
1503 \begin_layout Description
1504 Params See LFUN_DIALOG_SHOW .
1506 \begin_layout Description
1507 Origin JSpitzm, 30 Apr 2007
1510 \begin_layout Subsection*
1513 \begin_layout Description
1514 Action Updates the dialog values from the inset/paragraph/document.
1516 \begin_layout Description
1517 Syntax dialog-update <NAME>
1519 \begin_layout Description
1520 Params <NAME>: paragraph|prefs|<INSET>
1521 \begin_inset Newline newline
1526 \begin_layout Description
1527 Origin leeming, 25 Feb 2003
1530 \begin_layout Subsection*
1533 \begin_layout Description
1534 Action Moves the cursor one line in downward direction.
1536 \begin_layout Description
1540 \begin_layout Subsection*
1543 \begin_layout Description
1544 Action Moves the cursor one line in downward direction adding the current position to the selection.
1546 \begin_layout Description
1550 \begin_layout Subsection*
1553 \begin_layout Description
1554 Action Inserts an ERT inset.
1556 \begin_layout Description
1559 \begin_layout Description
1560 Origin Jug, 18 Feb 2000
1563 \begin_layout Subsection*
1566 \begin_layout Description
1567 Action Clears the selection. If no text is selected call LFUN_FINISHED_FORWARD. Inside math mode jumps out of the math inset.
1569 \begin_layout Description
1572 \begin_layout Description
1573 Origin Lgb, 17 May 2001
1576 \begin_layout Subsection*
1579 \begin_layout Description
1580 Action Inserts another LyX file.
1582 \begin_layout Description
1583 Syntax file-insert [<FILE>]
1585 \begin_layout Description
1586 Params <FILE>: Filename to be inserted.
1589 \begin_layout Subsection*
1590 file-insert-plaintext
1592 \begin_layout Description
1593 Action Inserts plain text file.
1595 \begin_layout Description
1596 Syntax file-insert-plaintext [<FILE>]
1598 \begin_layout Description
1599 Params <FILE>: Filename to be inserted.
1601 \begin_layout Description
1602 Origin CFO-G, 19 Nov 1997
1605 \begin_layout Subsection*
1606 file-insert-plaintext-para
1608 \begin_layout Description
1609 Action Inserts plain text file as paragraph (i.e. join lines).
1611 \begin_layout Description
1612 Syntax file-insert-plaintext-para [<FILE>]
1614 \begin_layout Description
1615 Params <FILE>: Filename to be inserted.
1617 \begin_layout Description
1618 Origin Levon, 14 Feb 2001
1621 \begin_layout Subsection*
1624 \begin_layout Description
1625 Action Inserts CharStyle, Custom inset or XML short element.
1627 \begin_layout Description
1628 Notion Look into the Customization manual for more information about these elements.
1629 \begin_inset Newline newline
1632 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.
1633 \begin_inset Newline newline
1636 For dissolving the element see LFUN_INSET_DISSOLVE.
1638 \begin_layout Description
1639 Syntax flex-insert Name
1641 \begin_layout Description
1642 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.
1644 \begin_layout Description
1645 Sample flex-insert Code
1648 \begin_layout Subsection*
1651 \begin_layout Description
1652 Action Inserts a float inset.
1654 \begin_layout Description
1655 Syntax float-insert <TYPE>
1657 \begin_layout Description
1658 Params <TYPE>: type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given.
1660 \begin_layout Description
1661 Origin Lgb, 27 Jun 2000
1664 \begin_layout Subsection*
1667 \begin_layout Description
1668 Action Inserts the list of floats in the document.
1670 \begin_layout Description
1671 Syntax float-list-insert <TYPE>
1673 \begin_layout Description
1674 Params <TYPE>: type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given.
1676 \begin_layout Description
1677 Origin Lgb, 3 May 2001
1680 \begin_layout Subsection*
1683 \begin_layout Description
1684 Action Inserts float insets as in LFUN_FLOAT_INSERT but span multiple columns.
1686 \begin_layout Description
1687 Notion Corresponds to the starred floats (figure*, table*, etc.) in LaTeX.
1689 \begin_layout Description
1690 Syntax float-wide-insert <TYPE>
1692 \begin_layout Description
1693 Params <TYPE>: type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given.
1695 \begin_layout Description
1696 Origin Lgb, 31 Oct 2001
1699 \begin_layout Subsection*
1702 \begin_layout Description
1703 Action Inserts a footnote inset.
1705 \begin_layout Description
1706 Syntax footnote-insert
1708 \begin_layout Description
1709 Origin Jug, 7 Mar 2000
1712 \begin_layout Subsection*
1715 \begin_layout Description
1716 Action Reloads the image if necessary.
1718 \begin_layout Description
1719 Syntax graphics-reload
1721 \begin_layout Description
1722 Origin vfr, 10 Aug 2009
1725 \begin_layout Subsection*
1728 \begin_layout Description
1729 Action Inserts hyperlinks into the document (clickable in pdf output).
1731 \begin_layout Description
1732 Notion Hyperlink target can be set via selection + hyperlink-insert function.
1734 \begin_layout Description
1735 Syntax href-insert [<TARGET>]
1737 \begin_layout Description
1738 Origin CFO-G, 21 Nov 1997
1741 \begin_layout Subsection*
1744 \begin_layout Description
1745 Action Only active in IPA inset.
1747 \begin_layout Description
1748 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.
1750 \begin_layout Description
1753 \begin_layout Description
1754 Origin spitz, 20 May 2012
1757 \begin_layout Subsection*
1760 \begin_layout Description
1761 Action Inserts Index entry.
1763 \begin_layout Description
1764 Notion It automatically takes the word on the cursor position.
1766 \begin_layout Description
1767 Syntax index-insert [<TYPE:Name>]
1769 \begin_layout Description
1770 Params <TYPE:Name>: name of the index, if multiple indices are defined. With an empty argument, the default index is selected.
1772 \begin_layout Description
1773 Origin leeming, 3 Aug 2000
1776 \begin_layout Subsection*
1779 \begin_layout Description
1780 Action Inserts list of Index entries on a new page.
1782 \begin_layout Description
1783 Syntax index-print [<TYPE:Name>]
1785 \begin_layout Description
1786 Params <TYPE:Name>: name of the index, if multiple indices are defined. With an empty argument, the default index is selected.
1788 \begin_layout Description
1789 Origin Lgb, 27 Feb 1997
1792 \begin_layout Subsection*
1795 \begin_layout Description
1796 Action Displays shortcuts, lyxrc, package and textclass availability and menu information in a non-editable boxed InsetText.
1798 \begin_layout Description
1799 Notion Apart from lfun arguments you can use the following method:
1800 \begin_inset Newline newline
1803 1. input the type and argument of this inset, e.g. "menu paste", in the work area.
1804 \begin_inset Newline newline
1807 2. select the text and run info-insert lfun.
1809 \begin_layout Description
1810 Syntax info-insert <TYPE> <ARG>
1812 \begin_layout Description
1813 Params <TYPE>: shortcut[s]|lyxrc|lyxinfo|package|textclass|menu|buffer
1814 \begin_inset Newline newline
1817 <ARG>: argument for a given type. Look into InsetInfo.h for detailed description.
1818 \begin_inset Newline newline
1821 shortcut[s]: name of lfun (e.g math-insert
1824 \begin_inset Newline newline
1827 lyxrc: name of rc_entry (e.g. bind_file)
1828 \begin_inset Newline newline
1831 lyxinfo: "version" - used version of LyX
1832 \begin_inset Newline newline
1835 package: name of latex package (e.g. listings)
1836 \begin_inset Newline newline
1839 textclass: name of textclass (e.g. article)
1840 \begin_inset Newline newline
1843 menu: name of lfun used in menu
1844 \begin_inset Newline newline
1847 icon: icon of lfun used in toolbar
1848 \begin_inset Newline newline
1851 buffer: "name"|"path"|"class"|"vcs-tree-revision"| "vcs-revision"|"vcs-author"|"vcs-date"|"vcs-time"
1853 \begin_layout Description
1854 Sample command-sequence info-insert buffer path; info-insert buffer name
1856 \begin_layout Description
1857 Origin bpeng, 7 Oct 2007
1860 \begin_layout Subsection*
1863 \begin_layout Description
1864 Action Apply data for an inset.
1866 \begin_layout Description
1867 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.
1869 \begin_layout Description
1870 Syntax inset-apply <ARGS>
1872 \begin_layout Description
1873 Params See LFUN_INSET_INSERT .
1876 \begin_layout Subsection*
1879 \begin_layout Description
1880 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
1882 \begin_layout Description
1885 \begin_layout Description
1886 Origin lasgouttes, 16 Mar 2009
1889 \begin_layout Subsection*
1892 \begin_layout Description
1893 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).
1895 \begin_layout Description
1896 Syntax inset-begin-select
1898 \begin_layout Description
1899 Origin lasgouttes, 16 Mar 2009
1902 \begin_layout Subsection*
1905 \begin_layout Description
1906 Action Copies the inset to the clipboard as a certain type.
1908 \begin_layout Description
1909 Notion Currently used only for InsetInfo where its content is copied as a text.
1911 \begin_layout Description
1912 Syntax inset-copy-as
1914 \begin_layout Description
1915 Origin vfr, 18 Apr 2010
1918 \begin_layout Subsection*
1921 \begin_layout Description
1922 Action Dissolve the current inset into text.
1924 \begin_layout Description
1925 Syntax inset-dissolve [<INSET>]
1927 \begin_layout Description
1928 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.
1929 \begin_inset Newline newline
1932 For values see lyx::InsetLayout::lyxtype_ .
1934 \begin_layout Description
1935 Origin JSpitz, 7 Aug 2006
1938 \begin_layout Subsection*
1941 \begin_layout Description
1942 Action Edit the inset at cursor with an external application, if one is attributed.
1944 \begin_layout Description
1945 Syntax inset-edit [<INSET_PARAMS>]
1947 \begin_layout Description
1948 Params <INSET_PARAMS>: Parameters for the inset.
1949 \begin_inset Newline newline
1952 Currently only the filename will be considered.
1954 \begin_layout Description
1955 Origin JSpitzm, 27 Apr 2006
1958 \begin_layout Subsection*
1961 \begin_layout Description
1962 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
1964 \begin_layout Description
1967 \begin_layout Description
1968 Origin lasgouttes, 16 Mar 2009
1971 \begin_layout Subsection*
1974 \begin_layout Description
1975 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).
1977 \begin_layout Description
1978 Syntax inset-end-select
1980 \begin_layout Description
1981 Origin lasgouttes, 16 Mar 2009
1984 \begin_layout Subsection*
1987 \begin_layout Description
1988 Action Apply the given commands on insets of a given name.
1990 \begin_layout Description
1991 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.
1993 \begin_layout Description
1994 Syntax inset-forall <NAME> <LFUN-COMMAND>
1995 \begin_inset Newline newline
1998 <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.
2000 \begin_layout Description
2001 Sample Remove all index insets:
2002 \begin_inset Newline newline
2005 inset-forall Index char-delete-forward
2006 \begin_inset Newline newline
2009 Close all Notes (also works for a particular branch, for example):
2010 \begin_inset Newline newline
2013 inset-forall Note inset-toggle close
2014 \begin_inset Newline newline
2017 Transform all yellow notes to comments
2018 \begin_inset Newline newline
2021 inset-forall Note:Note inset-modify note Note Comment
2022 \begin_inset Newline newline
2025 Try to put LyX in an infinite loop if there is at least a Note:
2026 \begin_inset Newline newline
2029 inset-forall Note char-backward
2031 \begin_layout Description
2032 Origin lasgouttes, 27 Nov 2009
2035 \begin_layout Subsection*
2038 \begin_layout Description
2039 Action Insert new inset (type given by the parameters).
2041 \begin_layout Description
2042 Syntax inset-insert <INSET> <ARGS>
2044 \begin_layout Description
2045 Params <INSET>: <bibitem|bibtex|citation|ert|listings|external|graphics|tabular|
2046 \begin_inset Newline newline
2049 hyperlink|include|index|label|line|nomencl|vspace|ref|toc|script>
2050 \begin_inset Newline newline
2053 <ARGS>: depends on the given inset. Use "lyx -dbg action" to explore.
2055 \begin_layout Description
2056 Sample inset-insert ref LatexCommand <Format> reference "<label name>"
2059 \begin_inset Newline newline
2062 where <label name> is the name of the referenced label and <Format> is one of the following:
2063 \begin_inset Newline newline
2067 \begin_inset Newline newline
2070 eqref -- (<reference>)
2071 \begin_inset Newline newline
2075 \begin_inset Newline newline
2078 vpageref -- on <page>
2079 \begin_inset Newline newline
2082 vref -- <reference> on <page>
2083 \begin_inset Newline newline
2086 formatted -- Formatted reference
2089 \begin_layout Subsection*
2092 \begin_layout Description
2093 Action Modify some properties of an inset.
2095 \begin_layout Description
2096 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.
2098 \begin_layout Description
2099 Syntax inset-modify <INSET> <ARGS>inset-modify changetype <TYPE>inset-modify tabular <FEATURE> [<ARG>]
2101 \begin_layout Description
2102 Params Generally see LFUN_INSET_INSERT for further details.
2103 \begin_inset Newline newline
2106 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.
2107 \begin_inset Newline newline
2110 <FEATURE>: append-row|append-column|delete-row|delete-column|copy-row|
2111 \begin_inset Newline newline
2114 copy-column|move-column-right|move-column-left|move-row-down|move-row-up|
2115 \begin_inset Newline newline
2118 toggle-line-top|toggle-line-bottom|toggle-line-left|toggle-line-right|
2119 \begin_inset Newline newline
2122 align-left|align-right|align-center|align-block|align-decimal|set-decimal-point|
2123 \begin_inset Newline newline
2126 valign-top|valign-bottom|valign-middle|longtabular-align-left|
2127 \begin_inset Newline newline
2130 longtabular-align-center|longtabular-align-right|m-align-left|m-align-right|
2131 \begin_inset Newline newline
2134 m-align-center|m-valign-top|m-valign-bottom|m-valign-middle|multicolumn|
2135 \begin_inset Newline newline
2138 set-all-lines|unset-all-lines|set-longtabular|unset-longtabular|set-pwidth|
2139 \begin_inset Newline newline
2142 set-mpwidth|set-rotate-tabular|unset-rotate-tabular|toggle-rotate-tabular|
2143 \begin_inset Newline newline
2146 set-rotate-cell|unset-rotate-cell|toggle-rotate-cell|set-usebox|set-lthead|
2147 \begin_inset Newline newline
2150 unset-lthead|set-ltfirsthead|unset-ltfirsthead|set-ltfoot|unset-ltfoot|
2151 \begin_inset Newline newline
2154 set-ltlastfoot|unset-ltlastfoot|set-ltnewpage|toggle-ltcaption|
2155 \begin_inset Newline newline
2158 set-special-column|set-special-multicolumn|set-special-multirow|
2159 \begin_inset Newline newline
2162 set-booktabs|unset-booktabs|set-top-space|set-bottom-space|
2163 \begin_inset Newline newline
2166 set-interline-space|set-border-lines|tabular-valign-top|
2167 \begin_inset Newline newline
2170 tabular-valign-middle|tabular-valign-bottom|set-tabular-width <ARG>: additional argument for some commands, use debug mode to explore its values.
2172 \begin_layout Description
2173 Sample inset-modify note Note Comment
2174 \begin_inset Newline newline
2177 inset-modify changetype Ovalbox
2180 \begin_layout Subsection*
2183 \begin_layout Description
2184 Action Selects all contents of an inset.
2186 \begin_layout Description
2187 Syntax inset-select-all
2189 \begin_layout Description
2190 Origin vfr, 22 Aug 2009
2193 \begin_layout Subsection*
2196 \begin_layout Description
2197 Action Open the inset's properties dialog.
2199 \begin_layout Description
2200 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.
2202 \begin_layout Description
2203 Syntax inset-settings <INSET>
2205 \begin_layout Description
2206 Params <INSET>: <bibitem|bibtex|box|branch|citation|ert|external|float|
2207 \begin_inset Newline newline
2210 graphics|href|include|index|index_print|label|line|
2211 \begin_inset Newline newline
2214 listings|note|phantom|ref|space|tabular|vspace|wrap>.
2217 \begin_layout Subsection*
2220 \begin_layout Description
2221 Action Toggles the collapsible inset at cursor position, or the inset we are currently in.
2223 \begin_layout Description
2224 Syntax inset-toggle [<ARG>]
2226 \begin_layout Description
2227 Params <ARG>: <open|close|toggle|assign>.
2228 \begin_inset Newline newline
2231 open/close/toggle are for collapsible insets. toggle is used when no argument is given.
2232 \begin_inset Newline newline
2235 assign synchronize the branch-inset with activation status of the branch. Used for global toggling when changed activation.
2237 \begin_layout Description
2238 Origin lasgouttes, 19 Jul 2001
2241 \begin_layout Subsection*
2244 \begin_layout Description
2245 Action Inserts an IPA inset.
2247 \begin_layout Description
2250 \begin_layout Description
2251 Origin spitz, 05 Mar 2012
2254 \begin_layout Subsection*
2257 \begin_layout Description
2258 Action Inserts special IPA macros into the document.
2260 \begin_layout Description
2261 Syntax ipamacro-insert <CHAR>
2263 \begin_layout Description
2264 Params <CHAR>: tone-falling, tone-rising, tone-high-rising, tone-low-rising, tone-high-rising-falling, deco bottomtiebar, deco toptiebar.
2266 \begin_layout Description
2267 Origin JSpitzm, 22 Aug 2012
2270 \begin_layout Subsection*
2273 \begin_layout Description
2274 Action Turn off the loaded keyboard map.
2276 \begin_layout Description
2280 \begin_layout Subsection*
2283 \begin_layout Description
2284 Action Turn on the primary keyboard map.
2286 \begin_layout Description
2287 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.
2288 \begin_inset Newline newline
2291 The language is to be set in the Preferences dialog.
2293 \begin_layout Description
2294 Syntax keymap-primary
2297 \begin_layout Subsection*
2300 \begin_layout Description
2301 Action Turn on the secondary keyboard map.
2303 \begin_layout Description
2304 Syntax keymap-secondary
2307 \begin_layout Subsection*
2310 \begin_layout Description
2311 Action Toggles keyboard maps (first/second/off).
2313 \begin_layout Description
2314 Syntax keymap-toggle
2316 \begin_layout Description
2317 Origin leeming, 30 Mar 2004
2320 \begin_layout Subsection*
2323 \begin_layout Description
2324 Action Goto a label.
2326 \begin_layout Description
2327 Syntax label-goto [<LABEL>]
2329 \begin_layout Description
2330 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.
2332 \begin_layout Description
2333 Origin Ale, 6 Aug 1997
2336 \begin_layout Subsection*
2339 \begin_layout Description
2340 Action Inserts label to text or displayed formula.
2342 \begin_layout Description
2343 Syntax label-insert [<LABEL>]
2345 \begin_layout Description
2346 Params <LABEL>: Requested label. If no label is given dialog requesting name will be opened.
2349 \begin_layout Subsection*
2350 label-insert-as-reference
2352 \begin_layout Description
2353 Action Inserts the label (in ToC pane) as a cross-reference at the position of the cursor.
2355 \begin_layout Description
2356 Syntax label-insert-as-reference
2358 \begin_layout Description
2359 Origin vfr, 7 Apr 2009
2362 \begin_layout Subsection*
2365 \begin_layout Description
2366 Action Set language from the current cursor position.
2368 \begin_layout Description
2369 Syntax language <LANG> [set]
2371 \begin_layout Description
2372 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).
2374 \begin_layout Description
2375 Origin Dekel, 2 Mar 2000
2378 \begin_layout Subsection*
2381 \begin_layout Description
2382 Action Move the cursor to the beginning of the (screen) line.
2384 \begin_layout Description
2388 \begin_layout Subsection*
2391 \begin_layout Description
2392 Action Move the cursor to the beginning of the (screen) line adding the traversed text to the selection.
2394 \begin_layout Description
2395 Syntax line-begin-select
2398 \begin_layout Subsection*
2401 \begin_layout Description
2402 Action Deletes the letters to the end of the (screen) line or deletes the selection.
2404 \begin_layout Description
2405 Syntax line-delete-forward
2408 \begin_layout Subsection*
2411 \begin_layout Description
2412 Action Move the cursor to the end of the (screen) line.
2414 \begin_layout Description
2418 \begin_layout Subsection*
2421 \begin_layout Description
2422 Action Move the cursor to the end of the (screen) line adding the traversed text to the selection.
2424 \begin_layout Description
2425 Syntax line-end-select
2428 \begin_layout Subsection*
2431 \begin_layout Description
2432 Action Inserts a new listings inset.
2434 \begin_layout Description
2435 Syntax listing-insert
2437 \begin_layout Description
2438 Origin Herbert, 10 Nov 2001; bpeng, 2 May 2007
2441 \begin_layout Subsection*
2444 \begin_layout Description
2445 Action Inserts a marginal note.
2447 \begin_layout Description
2448 Syntax marginalnote-insert
2450 \begin_layout Description
2451 Origin Lgb, 26 Jun 2000
2454 \begin_layout Subsection*
2457 \begin_layout Description
2458 Action Disable selecting of text-region.
2460 \begin_layout Description
2464 \begin_layout Subsection*
2467 \begin_layout Description
2468 Action Enable selecting of text-region.
2470 \begin_layout Description
2471 Notion After enabling you can simply move arrow keys to get selected region.
2473 \begin_layout Description
2477 \begin_layout Subsection*
2480 \begin_layout Description
2481 Action Toggle between LFUN_MARK_ON and LFUN_MARK_OFF .
2483 \begin_layout Description
2486 \begin_layout Description
2487 Origin Andre, May 5 2006
2490 \begin_layout Subsection*
2493 \begin_layout Description
2494 Action Inserts a line break or new line.
2496 \begin_layout Description
2497 Syntax newline-insert [<ARG>]
2499 \begin_layout Description
2500 Params <ARG>: <newline|linebreak> default: newline
2502 \begin_layout Description
2503 Origin JSpitzm, 25 Mar 2008
2506 \begin_layout Subsection*
2509 \begin_layout Description
2510 Action Inserts a new page.
2512 \begin_layout Description
2513 Syntax newpage-insert <ARG>
2515 \begin_layout Description
2516 Params <ARG>: <newpage|pagebreak|clearpage|cleardoublepage> default: newpage
2518 \begin_layout Description
2519 Origin uwestoehr, 24 Nov 2007
2522 \begin_layout Subsection*
2525 \begin_layout Description
2526 Action Inserts Nomenclature entry.
2528 \begin_layout Description
2529 Notion It automatically takes the word on the cursor position if no symbol is given.
2531 \begin_layout Description
2532 Syntax nomencl-insert [<SYMBOL>]
2534 \begin_layout Description
2535 Origin Ugras, 4 Nov 2006
2538 \begin_layout Subsection*
2541 \begin_layout Description
2542 Action Inserts list of Nomenclature entries.
2544 \begin_layout Description
2545 Syntax nomenclature-print
2547 \begin_layout Description
2548 Origin Ugras, 4 Nov 2006
2551 \begin_layout Subsection*
2554 \begin_layout Description
2555 Action Inserts Note on the current cursor position, move selection inside the inset.
2557 \begin_layout Description
2558 Syntax note-insert [<TYPE>]
2560 \begin_layout Description
2561 Params <TYPE>: <Note|Greyedout|Comment> default: Note
2564 \begin_layout Subsection*
2567 \begin_layout Description
2568 Action Moves the cursor to the beginning of next Note inset.
2570 \begin_layout Description
2574 \begin_layout Subsection*
2577 \begin_layout Description
2578 Action Move the current group in the downward direction in the structure of the document.
2580 \begin_layout Description
2581 Notion The "group" can be Part/Chapter/Section/etc. It moves the whole substructure of the group.
2583 \begin_layout Description
2586 \begin_layout Description
2587 Origin Vermeer, 23 Mar 2006
2590 \begin_layout Subsection*
2593 \begin_layout Description
2594 Action Moves the current group in the downward direction in the hierarchy of the document structure.
2596 \begin_layout Description
2597 Notion Part -> Chapter -> Section -> etc.
2599 \begin_layout Description
2602 \begin_layout Description
2603 Origin Vermeer, 23 Mar 2006
2606 \begin_layout Subsection*
2609 \begin_layout Description
2610 Action Moves the current group in the upward direction in the hierarchy of the document structure.
2612 \begin_layout Description
2613 Notion Part <- Chapter <- Section <- etc.
2615 \begin_layout Description
2618 \begin_layout Description
2619 Origin Vermeer, 23 Mar 2006
2622 \begin_layout Subsection*
2625 \begin_layout Description
2626 Action Move the current group in the upward direction in the structure of the document.
2628 \begin_layout Description
2629 Notion The "group" can be Part/Chapter/Section/etc. It moves the whole substructure of the group.
2631 \begin_layout Description
2634 \begin_layout Description
2635 Origin Vermeer, 23 Mar 2006
2638 \begin_layout Subsection*
2641 \begin_layout Description
2642 Action Breaks the current paragraph at the current location.
2644 \begin_layout Description
2645 Notion Removes the selection.
2647 \begin_layout Description
2648 Syntax paragraph-break [<LAYOUT>]
2650 \begin_layout Description
2651 Params <LAYOUT>: "inverse" - decreases depth by one (or change layout to default layout) when the cursor is at the end of the line.
2654 \begin_layout Subsection*
2657 \begin_layout Description
2658 Action Move the cursor to the next paragraph (or beginning of the current one) in downward direction.
2660 \begin_layout Description
2661 Syntax paragraph-down
2663 \begin_layout Description
2664 Origin Asger, 1 Oct 1996
2667 \begin_layout Subsection*
2668 paragraph-down-select
2670 \begin_layout Description
2671 Action Move the cursor and select the text to the next paragraph (or beginning of the current one) in downward direction.
2673 \begin_layout Description
2674 Syntax paragraph-down-select
2676 \begin_layout Description
2677 Origin Asger, 1 Oct 1996
2680 \begin_layout Subsection*
2683 \begin_layout Description
2684 Action Jump to a paragraph given by its id number and optionally the desired position within the paragraph.
2686 \begin_layout Description
2687 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).
2689 \begin_layout Description
2690 Syntax paragraph-goto <PAR_ID_NUMBER> <POSITION_IN_PAR>
2692 \begin_layout Description
2693 Params <PAR_ID_NUMBER>: paragraph id
2694 \begin_inset Newline newline
2697 <POSITION_IN_PAR>: desired position within the paragraph
2699 \begin_layout Description
2700 Origin Dekel, 26 Aug 2000
2703 \begin_layout Subsection*
2706 \begin_layout Description
2707 Action Moves the current paragraph downwards in the document.
2709 \begin_layout Description
2710 Syntax paragraph-move-down
2712 \begin_layout Description
2713 Origin Edwin, 8 Apr 2006
2716 \begin_layout Subsection*
2719 \begin_layout Description
2720 Action Moves the current paragraph upwards in the document.
2722 \begin_layout Description
2723 Notion Movement through the document will possibly break the paragraph-depth (e.g. itemize structure).
2725 \begin_layout Description
2726 Syntax paragraph-move-up
2728 \begin_layout Description
2729 Origin Edwin, 8 Apr 2006
2732 \begin_layout Subsection*
2735 \begin_layout Description
2736 Action Change paragraph settings.
2738 \begin_layout Description
2739 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.
2741 \begin_layout Description
2742 Syntax paragraph-params [<INDENT>] [<SPACING>] [<ALIGN>] [<OTHERS>]
2744 \begin_layout Description
2754 \begin_inset Newline newline
2759 paragraph_spacing default|single|onehalf|double|other SIZE
2760 \begin_inset Newline newline
2765 align block|left|right|center|default
2766 \begin_inset Newline newline
2771 labelwidthstring WIDTH|
2775 \begin_layout Description
2776 Origin rgh, Aug 15 2007
2779 \begin_layout Subsection*
2780 paragraph-params-apply
2782 \begin_layout Description
2783 Action Change paragraph settings.
2785 \begin_layout Description
2786 Notion Overwrite all nonspecified settings to the default ones. Use paragraph-params lfun if you don't want to overwrite others settings.
2788 \begin_layout Description
2789 Syntax paragraph-params-apply <INDENT> <SPACING> <ALIGN> <OTHERS>
2791 \begin_layout Description
2792 Params For parameters see LFUN_PARAGRAPH_PARAMS
2794 \begin_layout Description
2795 Origin leeming, 30 Mar 2004
2798 \begin_layout Subsection*
2801 \begin_layout Description
2802 Action Move the cursor to the next paragraph (or beginning of the current one) in upward direction.
2804 \begin_layout Description
2807 \begin_layout Description
2808 Origin Asger, 1 Oct 1996
2811 \begin_layout Subsection*
2814 \begin_layout Description
2815 Action Move the cursor and select the text to the next paragraph (or beginning of the current one) in upward direction.
2817 \begin_layout Description
2818 Syntax paragraph-up-select
2820 \begin_layout Description
2821 Origin Asger, 1 Oct 1996
2824 \begin_layout Subsection*
2827 \begin_layout Description
2828 Action Pastes material (text or picture) from the active clipboard.
2830 \begin_layout Description
2831 Syntax paste [<TYPE>|<NUM>]
2833 \begin_layout Description
2834 Params <TYPE>: emf|pdf|png|jpeg|linkback|wmf|latex|html
2835 \begin_inset Newline newline
2838 <NUM>: number of the selection in the internal clipboard stack to be pasted.
2841 \begin_layout Subsection*
2844 \begin_layout Description
2845 Action Inserts phantom on the current cursor position, move selection inside the inset.
2847 \begin_layout Description
2848 Syntax phantom-insert [<TYPE>]
2850 \begin_layout Description
2851 Params <TYPE>: <Phantom|HPhantom|VPhantom> default: Phantom
2853 \begin_layout Description
2854 Origin uwestoehr, 30 Jan 2009
2857 \begin_layout Subsection*
2860 \begin_layout Description
2861 Action Inserts a new preview inset.
2863 \begin_layout Description
2864 Syntax preview-insert
2866 \begin_layout Description
2867 Origin vfr, 28 Mar 2010
2870 \begin_layout Subsection*
2871 primary-selection-paste
2873 \begin_layout Description
2874 Action Pastes the currently selected text.
2876 \begin_layout Description
2877 Notion Primary selection mechanism is linux-only thing.
2879 \begin_layout Description
2880 Syntax primary-selection-paste [<ARG>]
2882 \begin_layout Description
2883 Params <ARG>: "paragraph" will cause pasting as one paragraph, i.e. "Join lines".
2886 \begin_layout Subsection*
2889 \begin_layout Description
2890 Action Inserts quotes according to the type and quote-language preference.
2892 \begin_layout Description
2893 Notion Currently English, Swedish, German, Polish, French, Danish quotes are distinguished.
2895 \begin_layout Description
2896 Syntax quote-insert [<TYPE>]
2898 \begin_layout Description
2899 Params <TYPE>: 'single' for single quotes, otherwise double quotes will be used.
2902 \begin_layout Subsection*
2905 \begin_layout Description
2906 Action Redoes the last thing undone.
2908 \begin_layout Description
2912 \begin_layout Subsection*
2915 \begin_layout Description
2916 Action Go to the next label or cross-reference.
2918 \begin_layout Description
2919 Syntax reference-next
2921 \begin_layout Description
2922 Origin Dekel, 14 Jan 2001
2925 \begin_layout Subsection*
2928 \begin_layout Description
2929 Action Repeat the given command.
2931 \begin_layout Description
2932 Syntax repeat <COUNT> <LFUN-COMMAND>
2934 \begin_layout Description
2935 Origin Andre, 27 Oct 2003
2938 \begin_layout Subsection*
2941 \begin_layout Description
2942 Action Moves the cursor one page in downward direction.
2944 \begin_layout Description
2948 \begin_layout Subsection*
2951 \begin_layout Description
2952 Action Moves the cursor one screen in downward direction adding the current position to the selection.
2954 \begin_layout Description
2955 Syntax screen-down-select
2958 \begin_layout Subsection*
2961 \begin_layout Description
2962 Action Recenters the screen on the current cursor position.
2964 \begin_layout Description
2965 Syntax screen-recenter
2968 \begin_layout Subsection*
2971 \begin_layout Description
2972 Action Repositions the screen such that the cursor is visible.
2974 \begin_layout Description
2975 Syntax screen-show-cursor
2977 \begin_layout Description
2978 Origin vfr, 25 Mar 2009
2981 \begin_layout Subsection*
2984 \begin_layout Description
2985 Action Moves the cursor one page in upward direction.
2987 \begin_layout Description
2991 \begin_layout Subsection*
2994 \begin_layout Description
2995 Action Moves the cursor one page in upward direction adding the current position to the selection.
2997 \begin_layout Description
2998 Syntax screen-up-select
3001 \begin_layout Subsection*
3004 \begin_layout Description
3005 Action Inserts a subscript or superscript inset.
3007 \begin_layout Description
3008 Syntax script-insert <TYPE>
3010 \begin_layout Description
3011 Params <TYPE>: subscript|superscript
3013 \begin_layout Description
3014 Origin Georg, 23 Nov 2010
3017 \begin_layout Subsection*
3020 \begin_layout Description
3021 Action Scroll the buffer view.
3023 \begin_layout Description
3024 Notion Only scrolls the screen up or down; does not move the cursor.
3026 \begin_layout Description
3027 Syntax scroll <TYPE> <QUANTITY>
3029 \begin_layout Description
3030 Params <TYPE>: line|page
3031 \begin_inset Newline newline
3034 <QUANTITY>: up|down|<number>
3036 \begin_layout Description
3037 Origin Abdel, Dec 27 2007
3040 \begin_layout Subsection*
3043 \begin_layout Description
3044 Action Selects the whole section.
3046 \begin_layout Description
3047 Notion The cursor should be in a section heading before calling this lfun.
3049 \begin_layout Description
3050 Syntax section-select
3052 \begin_layout Description
3053 Origin vfr, 05 May 2009
3056 \begin_layout Subsection*
3059 \begin_layout Description
3060 Action Pastes the internal selection text in permanent selection.
3062 \begin_layout Description
3063 Notion Created in order to have middle mouse button pasting correct (bound to command-alternatives selection-paste ; primary-selection-paste paragraph).
3065 \begin_layout Description
3066 Syntax selection-paste
3068 \begin_layout Description
3069 Origin lasgouttes, 14 Jan 2009
3072 \begin_layout Subsection*
3075 \begin_layout Description
3076 Action Set the group for the graphics inset on the cursor position.
3078 \begin_layout Description
3079 Syntax set-graphics-group [<GROUP>]
3081 \begin_layout Description
3082 Params <GROUP>: Id for an existing group. In case the Id is an empty string, the graphics inset is removed from the current group.
3084 \begin_layout Description
3085 Origin sanda, 6 May 2008
3088 \begin_layout Subsection*
3091 \begin_layout Description
3092 Action Inserts one of horizontal space insets.
3094 \begin_layout Description
3095 Syntax space-insert <NAME> [<LEN>]
3097 \begin_layout Description
3098 Params <NAME>: normal, protected, visible, thin, quad, qquad, enspace, enskip, negthinspace, negmedspace, negthickspace, hfill, hfill*, dotfill, hrulefill, hspace, hspace*
3099 \begin_inset Newline newline
3102 Only in math mode: med and thick.
3103 \begin_inset Newline newline
3106 <LEN>: length for custom spaces (hspace, hspace* for protected)
3108 \begin_layout Description
3109 Origin JSpitzm, 20 May 2003, Mar 17 2008
3112 \begin_layout Subsection*
3115 \begin_layout Description
3116 Action Inserts various characters into the document.
3118 \begin_layout Description
3119 Syntax specialchar-insert <CHAR>
3121 \begin_layout Description
3122 Params <CHAR>: hyphenation, ligature-break, slash, nobreakdash, dots, end-of-sentence, menu-separator.
3124 \begin_layout Description
3125 Origin JSpitzm, 6 Dec 2007
3128 \begin_layout Subsection*
3131 \begin_layout Description
3132 Action Add the word under the cursor to the respective spell checker dictionary.
3134 \begin_layout Description
3135 Syntax spelling-add [<STRING>] [<LANG>]
3137 \begin_layout Description
3138 Params <WORD>: word to add <LANG>: language name (see file languages)
3140 \begin_layout Description
3141 Origin JSpitzm, 18 Jan 2010
3144 \begin_layout Subsection*
3145 spelling-continuously
3147 \begin_layout Description
3148 Action Toggle continuous spell checking.
3150 \begin_layout Description
3151 Syntax spelling-continuously
3153 \begin_layout Description
3154 Origin vfr, 24 March 2013
3157 \begin_layout Subsection*
3160 \begin_layout Description
3161 Action Let the spell checker ignore the word under the cursor in the current session for the given language.
3163 \begin_layout Description
3164 Syntax spelling-ignore [<WORD>] [<LANG>]
3166 \begin_layout Description
3167 Params <WORD>: word to ignore <LANG>: language name (see file languages)
3169 \begin_layout Description
3170 Origin JSpitzm, 18 Jan 2010
3173 \begin_layout Subsection*
3176 \begin_layout Description
3177 Action Remove the word under the cursor from the respective spell checker dictionary.
3179 \begin_layout Description
3180 Syntax spelling-remove [<STRING>] [<LANG>]
3182 \begin_layout Description
3183 Params <WORD>: word to remove <LANG>: language name (see file languages)
3185 \begin_layout Description
3186 Origin SWitt, 28 July 2010
3189 \begin_layout Subsection*
3192 \begin_layout Description
3193 Action Delete a tab or up to an equivalent amount of spaces from a listings inset.
3195 \begin_layout Description
3196 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.
3198 \begin_layout Description
3201 \begin_layout Description
3202 Origin vfr, Sep 30 2008
3205 \begin_layout Subsection*
3208 \begin_layout Description
3209 Action Insert a tab into a listings inset.
3211 \begin_layout Description
3212 Notion It also works on a selection.
3214 \begin_layout Description
3217 \begin_layout Description
3218 Origin vfr, Sep 30 2008
3221 \begin_layout Subsection*
3224 \begin_layout Description
3225 Action Inserts table into the document.
3227 \begin_layout Description
3228 Notion See LFUN_INSET_MODIFY for some more details about tabular modifications.
3230 \begin_layout Description
3231 Syntax tabular-insert [<ROWS> <COLUMNS>]
3233 \begin_layout Description
3234 Params In case no arguments are given show insert dialog.
3236 \begin_layout Description
3237 Origin Jug, 12 Apr 2000
3240 \begin_layout Subsection*
3243 \begin_layout Description
3244 Action Look up thesaurus entries with respect to the word under the cursor.
3246 \begin_layout Description
3247 Syntax thesaurus-entry [<STRING>] [lang=<LANG>]
3249 \begin_layout Description
3250 Params <STRING>: word to look up <LANG>: language (see file languages)
3252 \begin_layout Description
3253 Origin Levon, 20 Jul 2001
3256 \begin_layout Subsection*
3259 \begin_layout Description
3260 Action Undoes the last edit.
3262 \begin_layout Description
3266 \begin_layout Subsection*
3269 \begin_layout Description
3270 Action Inserts a single unicode character.
3272 \begin_layout Description
3273 Syntax unicode-insert <CHAR>
3275 \begin_layout Description
3276 Params <CHAR>: The character to insert, given as its code point, in hexadecimal.
3278 \begin_layout Description
3279 Sample unicode-insert 0x0100
3281 \begin_layout Description
3282 Origin Lgb, 22 Oct 2006
3285 \begin_layout Subsection*
3288 \begin_layout Description
3289 Action Moves the cursor one line in upward direction.
3291 \begin_layout Description
3295 \begin_layout Subsection*
3298 \begin_layout Description
3299 Action Moves the cursor one line in upward direction adding the current position to the selection.
3301 \begin_layout Description
3305 \begin_layout Subsection*
3308 \begin_layout Description
3309 Action Moves the cursor to the logically previous beginning of a word.
3311 \begin_layout Description
3312 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.
3314 \begin_layout Description
3315 Syntax word-backward
3318 \begin_layout Subsection*
3319 word-backward-select
3321 \begin_layout Description
3322 Action Moves the cursor to the logically previous beginning of a word, adding the logically traversed text to the selection.
3324 \begin_layout Description
3325 Notion See also LFUN_WORD_BACKWARD.
3327 \begin_layout Description
3328 Syntax word-backward-select
3331 \begin_layout Subsection*
3334 \begin_layout Description
3335 Action Capitalizes the words in the selection (i.e. the first letters) or the letter on the cursor position.
3337 \begin_layout Description
3338 Syntax word-capitalize
3341 \begin_layout Subsection*
3342 word-delete-backward
3344 \begin_layout Description
3345 Action Deletes characters to the beginning of the word (usually the "C+BackSpace" key).
3347 \begin_layout Description
3348 Syntax word-delete-backward
3351 \begin_layout Subsection*
3354 \begin_layout Description
3355 Action Deletes characters to the end of the word (usually the "C+Delete" key).
3357 \begin_layout Description
3358 Syntax word-delete-forward
3361 \begin_layout Subsection*
3364 \begin_layout Description
3365 Action Search for next occurrence of a string.
3367 \begin_layout Description
3368 Syntax word-find [<DATA>]
3370 \begin_layout Description
3371 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).
3373 \begin_layout Description
3374 Origin Andre, Jan 7 2004
3377 \begin_layout Subsection*
3380 \begin_layout Description
3381 Action Search for a given string in backward direction.
3383 \begin_layout Description
3384 Notion Case sensitive, match words. If no argument given, last search repeated.
3386 \begin_layout Description
3387 Syntax word-find-backward [<STRING>]
3389 \begin_layout Description
3390 Origin Etienne, 20 Feb 1998
3393 \begin_layout Subsection*
3396 \begin_layout Description
3397 Action Search for a given string in forward direction.
3399 \begin_layout Description
3400 Notion Case sensitive, match words. If no argument given, last search repeated.
3402 \begin_layout Description
3403 Syntax word-find-forward [<STRING>]
3405 \begin_layout Description
3406 Origin Etienne, 16 Feb 1998
3409 \begin_layout Subsection*
3412 \begin_layout Description
3413 Action Search for next occurrence of a pattern.
3415 \begin_layout Description
3416 Syntax word-findadv [<DATA>]
3418 \begin_layout Description
3419 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).
3421 \begin_layout Description
3422 Origin Tommaso, Nov 15 2007
3425 \begin_layout Subsection*
3428 \begin_layout Description
3429 Action Moves the cursor to the logically next beginning of a word.
3431 \begin_layout Description
3432 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.
3434 \begin_layout Description
3438 \begin_layout Subsection*
3441 \begin_layout Description
3442 Action Moves the cursor to the logically next beginning of a word, adding the logically traversed text to the selection.
3444 \begin_layout Description
3445 Notion See also LFUN_WORD_FORWARD.
3447 \begin_layout Description
3448 Syntax word-forward-select
3451 \begin_layout Subsection*
3454 \begin_layout Description
3455 Action Moves the cursor to the next beginning of a word "on the left".
3457 \begin_layout Description
3458 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.
3460 \begin_layout Description
3463 \begin_layout Description
3464 Origin dov, 28 Oct 2007
3467 \begin_layout Subsection*
3470 \begin_layout Description
3471 Action Moves the cursor to the next beginning of a word "on the left", adding *logically* traversed text to the selection.
3473 \begin_layout Description
3474 Notion See also LFUN_WORD_LEFT for exact details of the movement.
3476 \begin_layout Description
3477 Syntax word-left-select
3479 \begin_layout Description
3480 Origin dov, 28 Oct 2007
3483 \begin_layout Subsection*
3486 \begin_layout Description
3487 Action Change the words in the selection or from the cursor position to the end of word to the lower case.
3489 \begin_layout Description
3493 \begin_layout Subsection*
3496 \begin_layout Description
3497 Action Replace a string in the document.
3499 \begin_layout Description
3500 Syntax word-replace [<DATA>]
3502 \begin_layout Description
3503 Params <DATA>: data is of the form "<replace>
3504 \begin_inset Newline newline
3508 \begin_inset Newline newline
3511 <casesensitive> <matchword> <all> <forward> <findnext>"
3513 \begin_layout Description
3514 Origin Andre, Jan 7 2004
3517 \begin_layout Subsection*
3520 \begin_layout Description
3521 Action Moves the cursor to the next beginning of a word "on the right".
3523 \begin_layout Description
3524 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.
3526 \begin_layout Description
3529 \begin_layout Description
3530 Origin dov, 28 Oct 2007
3533 \begin_layout Subsection*
3536 \begin_layout Description
3537 Action Moves the cursor to the next beginning of a word "on the right", adding *logically* traversed text to the selection.
3539 \begin_layout Description
3540 Notion See also LFUN_WORD_RIGHT for exact details of the movement.
3542 \begin_layout Description
3543 Syntax word-right-select
3545 \begin_layout Description
3546 Origin dov, 28 Oct 2007
3549 \begin_layout Subsection*
3552 \begin_layout Description
3553 Action Puts the word where the cursor stands into the selection.
3555 \begin_layout Description
3558 \begin_layout Description
3559 Origin Andre, 11 Sep 2002
3562 \begin_layout Subsection*
3565 \begin_layout Description
3566 Action Change the words in the selection or from the cursor position to the end of word to the upper case.
3568 \begin_layout Description
3572 \begin_layout Subsection*
3575 \begin_layout Description
3576 Action Inserts floats wrapped by the text around.
3578 \begin_layout Description
3579 Syntax wrap-insert <TYPE>
3581 \begin_layout Description
3582 Params <TYPE>: table|figure
3584 \begin_layout Description
3585 Origin Dekel, 7 Apr 2002
3588 \begin_layout Section
3589 Math Editor Functions
3591 \begin_layout Subsection*
3592 in-mathmacrotemplate
3594 \begin_layout Description
3595 Action Only active in Math Macro definition.
3597 \begin_layout Description
3598 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.
3600 \begin_layout Description
3601 Syntax in-mathmacrotemplate
3603 \begin_layout Description
3604 Origin sts, 06 January 2008
3607 \begin_layout Subsection*
3610 \begin_layout Description
3611 Action Inserts an extended matrix as provided by the amsmath package.
3613 \begin_layout Description
3614 Syntax math-matrix <COLS> <ROWS> [<DECORATION>]
3616 \begin_layout Description
3617 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'.
3619 \begin_layout Description
3620 Sample math-ams-matrix 3 3 bmatrix
3623 \begin_layout Subsection*
3626 \begin_layout Description
3627 Action Inserts math fixed size delimiters (e.g. parentheses, brackets) enclosing expression.
3629 \begin_layout Description
3630 Syntax math-bigdelim <LSIZE> <LDELIM> <RSIZE> <RDELIM>
3632 \begin_layout Description
3633 Params <L/RSIZE>: bigl/r|Bigl/r|biggl/r|Biggl/r
3634 \begin_inset Newline newline
3637 <L/RDELIM>: TeX code for delimiter. See Delimiter dialog for delimiters to be used.
3639 \begin_layout Description
3640 Sample math-bigdelim "Bigl" "
3646 \begin_layout Description
3647 Origin Enrico & Georg, 7 May 2006
3650 \begin_layout Subsection*
3653 \begin_layout Description
3654 Action Inserts math delimiters (e.g. parentheses, brackets) enclosing expression.
3656 \begin_layout Description
3657 Syntax math-delim [<LEFT>] [<RIGHT>]
3659 \begin_layout Description
3660 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.
3662 \begin_layout Description
3663 Sample math-delim { rangle
3665 \begin_layout Description
3666 Origin Alejandro, 18 Jun 1996
3669 \begin_layout Subsection*
3672 \begin_layout Description
3673 Action Creates a new displayed equation in text mode. Toggles inlined/display formula in math mode.
3675 \begin_layout Description
3676 Syntax math-display [<ARG>]
3678 \begin_layout Description
3679 Params <ARG>: this argument will be passed to LFUN_MATH_INSERT when creating new equation from the text mode.
3681 \begin_layout Description
3682 Origin Alejandro, 18 Jun 1996
3685 \begin_layout Subsection*
3688 \begin_layout Description
3689 Action Calls external program and passes the current expression/equation as an argument for the calculation in the format appropriate to the given language.
3691 \begin_layout Description
3692 Notion Selection can be used to determine the input for the external program.
3694 \begin_layout Description
3695 Syntax math-extern <LANG> [<COMMAND>]
3697 \begin_layout Description
3698 Params <LANG>: octave|maxima|maple|mathematica|script
3699 \begin_inset Newline newline
3702 where "script" stands for the external script (normalized expression will be passed)
3704 \begin_layout Description
3705 Sample math-extern maple simplify
3707 \begin_layout Description
3708 Origin Andre, 24 Apr 2001
3711 \begin_layout Subsection*
3714 \begin_layout Description
3715 Action Changes the text style used in math.
3717 \begin_layout Description
3718 Syntax math-font-style <STYLE>
3720 \begin_layout Description
3721 Params <STYLE>: mathnormal|mathcal|mathfrak|mathrm|mathsf|mathbf|textnormal
3722 \begin_inset Newline newline
3725 |textrm|textsf|texttt|textbf|textmd|textit|textsc|textsl|textup
3727 \begin_layout Description
3728 Origin vfr, 9 jan 2009
3731 \begin_layout Subsection*
3734 \begin_layout Description
3735 Action Inserts math objects and symbols.
3737 \begin_layout Description
3738 Notion When <ARG> is a _single_ math inset with more than one cell (such as "x_y^z" or "
3740 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
3742 frac{x}{y}" replaces "abc" with "
3744 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.
3746 \begin_layout Description
3747 Syntax math-insert <ARG>
3749 \begin_layout Description
3750 Params <ARG>: Symbol or LaTeX code to be inserted.
3753 \begin_layout Subsection*
3756 \begin_layout Description
3757 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.
3759 \begin_layout Description
3760 Notion Put the cursor before the symbol with the limits and then invoke math-limits.
3762 \begin_layout Description
3763 Syntax math-limits [<STATE>]
3765 \begin_layout Description
3766 Params <STATE>: limits|nolimits
3769 \begin_layout Subsection*
3772 \begin_layout Description
3773 Action Inserts a math macro definition at the cursor position in the text.
3775 \begin_layout Description
3776 Syntax math-macro <NAME> [<NARGS>] [def]
3778 \begin_layout Description
3779 Params <NAME>: The name of the macro, e.g. "mymacro".
3780 \begin_inset Newline newline
3783 <NARGS>: The number of parameters of the macro. Default is 0. "def": Has no effect anymore, just for compatibility with former LyX versions.
3785 \begin_layout Description
3786 Origin ale, 10 May 1997; sts, 21 Dec 2007
3789 \begin_layout Subsection*
3790 math-macro-add-greedy-optional-param
3792 \begin_layout Description
3793 Action Add a greedy optional parameter.
3795 \begin_layout Description
3796 Notion Add a greedy optional parameter which eats the value from the following cells in mathed which are in the [value] format.
3798 \begin_layout Description
3799 Syntax math-macro-add-greedy-optional-param
3801 \begin_layout Description
3802 Origin sts, 06 January 2008
3805 \begin_layout Subsection*
3806 math-macro-add-optional-param
3808 \begin_layout Description
3809 Action Add an optional parameter.
3811 \begin_layout Description
3812 Notion Insert an optional parameter just behind the already existing optional parameters.
3814 \begin_layout Description
3815 Syntax math-macro-add-optional-param
3817 \begin_layout Description
3818 Origin sts, 06 January 2008
3821 \begin_layout Subsection*
3822 math-macro-add-param
3824 \begin_layout Description
3825 Action Add a parameter.
3827 \begin_layout Description
3828 Notion Add a parameter to a Math Macro.
3830 \begin_layout Description
3831 Syntax math-macro-add-param <NUM>
3833 \begin_layout Description
3834 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.
3836 \begin_layout Description
3837 Origin sts, 06 January 2008
3840 \begin_layout Subsection*
3841 math-macro-append-greedy-param
3843 \begin_layout Description
3844 Action Append a greedy parameter.
3846 \begin_layout Description
3847 Notion Append a greedy parameter to a Math Macro which eats the following mathed cell in every instance of the macro in the buffer.
3849 \begin_layout Description
3850 Syntax math-macro-append-greedy-param
3852 \begin_layout Description
3853 Origin sts, 06 January 2008
3856 \begin_layout Subsection*
3859 \begin_layout Description
3860 Action Fold a Math Macro.
3862 \begin_layout Description
3863 Notion Fold the Math Macro the cursor is in if it was unfolded, i.e. displayed as
3867 \begin_layout Description
3868 Syntax math-macro-fold
3870 \begin_layout Description
3871 Origin sts, 06 January 2008
3874 \begin_layout Subsection*
3875 math-macro-make-nonoptional
3877 \begin_layout Description
3878 Action Make a parameter non-optional.
3880 \begin_layout Description
3881 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.
3883 \begin_layout Description
3884 Syntax math-macro-make-nonoptional
3886 \begin_layout Description
3887 Origin sts, 06 January 2008
3890 \begin_layout Subsection*
3891 math-macro-make-optional
3893 \begin_layout Description
3894 Action Make a parameter optional.
3896 \begin_layout Description
3897 Notion Turn the first non-optional parameter of a Math Macro into an optional parameter with a default value.
3899 \begin_layout Description
3900 Syntax math-macro-make-optional
3902 \begin_layout Description
3903 Origin sts, 06 January 2008
3906 \begin_layout Subsection*
3907 math-macro-remove-greedy-param
3909 \begin_layout Description
3910 Action Remove a greedy parameter.
3912 \begin_layout Description
3913 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.
3915 \begin_layout Description
3916 Syntax math-macro-remove-greedy-param
3918 \begin_layout Description
3919 Origin sts, 06 January 2008
3922 \begin_layout Subsection*
3923 math-macro-remove-optional-param
3925 \begin_layout Description
3926 Action Remove the last optional parameter.
3928 \begin_layout Description
3929 Notion Remove the last optional parameter of a Math Macro and remove it in all the instances of the macro in the buffer.
3931 \begin_layout Description
3932 Syntax math-macro-remove-optional-param
3934 \begin_layout Description
3935 Origin sts, 06 January 2008
3938 \begin_layout Subsection*
3939 math-macro-remove-param
3941 \begin_layout Description
3942 Action Remove the last parameter.
3944 \begin_layout Description
3945 Notion Remove the last parameter of a Math Macro and remove its value in all instances of the macro in the buffer.
3947 \begin_layout Description
3948 Syntax math-macro-remove-param <NUM>
3950 \begin_layout Description
3951 Params <NUM>: The number of the parameter to be deleted (1 for the first), defaults to the last one.
3953 \begin_layout Description
3954 Origin sts, 06 January 2008
3957 \begin_layout Subsection*
3960 \begin_layout Description
3961 Action Unfold a Math Macro.
3963 \begin_layout Description
3964 Notion Unfold the Math Macro the cursor is in, i.e. display it as
3968 \begin_layout Description
3969 Syntax math-macro-unfold
3971 \begin_layout Description
3972 Origin sts, 06 January 2008
3975 \begin_layout Subsection*
3978 \begin_layout Description
3979 Action Inserts a matrix.
3981 \begin_layout Description
3982 Syntax math-matrix <COLS> <ROWS> [<ALIGN>]
3984 \begin_layout Description
3985 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).
3987 \begin_layout Description
3988 Sample math-matrix 3 3 bccc
3991 \begin_layout Subsection*
3994 \begin_layout Description
3995 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.
3997 \begin_layout Description
3998 Notion If there is some selected text, it puts the text inside created math box.
4000 \begin_layout Description
4001 Syntax math-mode [on|<ARG>]
4003 \begin_layout Description
4004 Params <ARG>: eventual argument (LaTeX code) is passed to LFUN_MATH_INSERT .
4005 \begin_inset Newline newline
4008 "on": allow only entering of math mode from text mode.
4010 \begin_layout Description
4011 Origin Alejandro, 4 Jun 1996
4014 \begin_layout Subsection*
4017 \begin_layout Description
4018 Action Mutates the type of math inset to the newly selected one.
4020 \begin_layout Description
4021 Syntax math-mutate <TYPE>
4023 \begin_layout Description
4024 Params <TYPE>: none|simple|equation|eqnarray|align|alignat|xalignat|xxalignat| multline|gather|flalign
4026 \begin_layout Description
4027 Origin Andre, 23 May 2001
4030 \begin_layout Subsection*
4031 math-number-line-toggle
4033 \begin_layout Description
4034 Action Toggles numbering of the current formula line.
4036 \begin_layout Description
4037 Notion Must be in display formula mode.
4039 \begin_layout Description
4040 Syntax math-number-line-toggle
4042 \begin_layout Description
4043 Origin Alejandro, 18 Jun 1996
4046 \begin_layout Subsection*
4049 \begin_layout Description
4050 Action Toggles numbering/labeling of the current formula.
4052 \begin_layout Description
4053 Notion Must be in display formula mode.
4055 \begin_layout Description
4056 Syntax math-number-toggle
4058 \begin_layout Description
4059 Origin Alejandro, 4 Jun 1996
4062 \begin_layout Subsection*
4065 \begin_layout Description
4066 Action Changes arbitrarily the size used by math fonts inside a context.
4068 \begin_layout Description
4069 Notion Provides an interface to the LaTeX math mode font size commands.
4071 \begin_layout Description
4072 Syntax math-size <STYLE>
4074 \begin_layout Description
4085 \begin_layout Description
4086 Origin Alejandro, 15 Aug 1996; sanda, 14 Jun 2008
4089 \begin_layout Subsection*
4092 \begin_layout Description
4093 Action Inserts space into math expression.
4095 \begin_layout Description
4096 Notion Use spacebar after entering this space to change type of space.
4098 \begin_layout Description
4099 Syntax math-space [<TYPE>] [<LEN>]
4101 \begin_layout Description
4102 Params <TYPE>: negative spaces: !|negthinspace|negmedspace|negthickspace
4103 \begin_inset Newline newline
4106 positive spaces: ,|thinspace|:|medspace|;|thickspace|enskip|quad|qquad
4107 \begin_inset Newline newline
4110 custom space: hspace
4111 \begin_inset Newline newline
4114 "," used by default.
4115 \begin_inset Newline newline
4118 Note that ! is equivalent to negthinspace, , = thinspace, : = medspace, and ; = thickspace.
4119 \begin_inset Newline newline
4122 <LEN>: length for custom spaces (hspace)
4124 \begin_layout Description
4125 Origin Andre, 25 Jul 2001; sanda, 16 Jun 2008
4128 \begin_layout Subsection*
4131 \begin_layout Description
4132 Action Enters subscript expression in math expression.
4134 \begin_layout Description
4135 Syntax math-subscript
4137 \begin_layout Description
4138 Origin vermeer, 12 Dec 2001
4141 \begin_layout Subsection*
4144 \begin_layout Description
4145 Action Enters superscript expression in math expression.
4147 \begin_layout Description
4148 Syntax math-superscript
4150 \begin_layout Description
4151 Origin vermeer, 12 Dec 2001
4154 \begin_layout Subsection*
4157 \begin_layout Description
4158 Action Enters regexp mode (i.e., puts regexp insets on the current cursor position). Used by the advanced search dialog.
4160 \begin_layout Description
4161 Notion If there is any selected text, then it is moved inside the created regexp inset.
4163 \begin_layout Description
4164 Syntax regexp-mode [<ARG>]
4166 \begin_layout Description
4167 Params <ARG>: eventual argument (regular expression).
4169 \begin_layout Description
4170 Origin Tommaso, 4 Oct 2008
4173 \begin_layout Section
4174 Buffer Fuctions (File and Window related)
4176 \begin_layout Subsection*
4179 \begin_layout Description
4180 Action Activate the branch.
4182 \begin_layout Description
4183 Syntax branch-activate <BRANCH>
4185 \begin_layout Description
4186 Params <BRANCH>: The branch to activate
4188 \begin_layout Description
4189 Sample lyx -x "branch-activate answers" -e pdf2 finalexam.lyx
4190 \begin_inset Newline newline
4193 could be used to export a pdf with the answers branch included without one's having to open LyX and activate the branch manually.
4195 \begin_layout Description
4196 Origin rgh, 27 May 2008
4199 \begin_layout Subsection*
4202 \begin_layout Description
4203 Action Add a branch to the buffer's BranchList.
4205 \begin_layout Description
4206 Syntax branch-add <BRANCH>
4208 \begin_layout Description
4209 Params <BRANCH>: Name of the branch to add
4211 \begin_layout Description
4212 Origin spitz, 7 Jul 2009
4215 \begin_layout Subsection*
4218 \begin_layout Description
4219 Action Create new branch and directly put the branch inset into the document.
4221 \begin_layout Description
4222 Syntax branch-add-insert [<NAME>]
4224 \begin_layout Description
4225 Params <NAME>: Branch name. If it is not specified, you will be asked.
4227 \begin_layout Description
4228 Origin sanda, 10 Jul 2009
4231 \begin_layout Subsection*
4234 \begin_layout Description
4235 Action De-activate the branch.
4237 \begin_layout Description
4238 Syntax branch-deactivate <BRANCH>
4240 \begin_layout Description
4241 Params <BRANCH>: The branch to deactivate
4243 \begin_layout Description
4244 Origin rgh, 27 May 2008
4247 \begin_layout Subsection*
4248 branch-master-activate
4250 \begin_layout Description
4251 Action Activate the branch in the master buffer.
4253 \begin_layout Description
4254 Syntax branch-master-activate <BRANCH>
4256 \begin_layout Description
4257 Params <BRANCH>: The branch to activate
4259 \begin_layout Description
4260 Sample lyx -x "branch-activate answers" -e pdf2 finalexam.lyx
4261 \begin_inset Newline newline
4264 could be used to export a pdf with the answers branch included without one's having to open LyX and activate the branch manually.
4266 \begin_layout Description
4267 Origin spitz, 30 Sep 2012
4270 \begin_layout Subsection*
4271 branch-master-deactivate
4273 \begin_layout Description
4274 Action De-activate the branch in the master buffer.
4276 \begin_layout Description
4277 Syntax branch-master-deactivate <BRANCH>
4279 \begin_layout Description
4280 Params <BRANCH>: The branch to deactivate
4282 \begin_layout Description
4283 Origin spitz, 30 Sep 2012
4286 \begin_layout Subsection*
4289 \begin_layout Description
4290 Action Rename all branches of a given name in a document.
4292 \begin_layout Description
4293 Syntax branches-rename <OLDNAME> <NEWNAME>
4295 \begin_layout Description
4296 Params <OLDNAME>: Current name of the branch to be renamed <NEWNAME>: New name of the branch
4298 \begin_layout Description
4299 Origin spitz, 9 Jul 2009
4302 \begin_layout Subsection*
4305 \begin_layout Description
4306 Action Saves the current buffer to a temporary file.
4308 \begin_layout Description
4309 Notion Saves the current buffer to a file named "#filename#". This LFUN is called automatically by LyX, to "autosave" the current buffer.
4311 \begin_layout Description
4312 Syntax buffer-auto-save
4315 \begin_layout Subsection*
4318 \begin_layout Description
4319 Action Loads the given child document.
4321 \begin_layout Description
4322 Notion The current document is treated as a parent.
4324 \begin_layout Description
4325 Syntax buffer-child-open <FILE>
4327 \begin_layout Description
4328 Params <FILE>: Filename of the child. The directory of the parent is assumed by default.
4330 \begin_layout Description
4331 Origin Ale, 28 May 1997
4334 \begin_layout Subsection*
4337 \begin_layout Description
4338 Action Runs chktex for the current document.
4340 \begin_layout Description
4341 Syntax buffer-chktex
4343 \begin_layout Description
4344 Origin Asger, 30 Oct 1997
4347 \begin_layout Subsection*
4350 \begin_layout Description
4351 Action Closes the current buffer.
4353 \begin_layout Description
4354 Notion Closes the current buffer, asking whether to save it, etc, if the buffer has been modified.
4356 \begin_layout Description
4360 \begin_layout Subsection*
4363 \begin_layout Description
4364 Action Closes all buffers.
4366 \begin_layout Description
4367 Notion Closes all buffers, asking whether to save it, etc, if a buffer has been modified.
4369 \begin_layout Description
4370 Syntax buffer-close-all
4373 \begin_layout Subsection*
4376 \begin_layout Description
4377 Action Exports the current buffer (document) to the given format.
4379 \begin_layout Description
4380 Syntax buffer-export <FORMAT> [<DEST>]
4382 \begin_layout Description
4383 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.
4384 \begin_inset Newline newline
4387 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.
4389 \begin_layout Description
4390 Origin Lgb, 29 Jul 1997
4393 \begin_layout Subsection*
4396 \begin_layout Description
4397 Action Opens a dialog for exporting the current buffer.
4399 \begin_layout Description
4400 Syntax buffer-export-as [<FORMAT>]
4402 \begin_layout Description
4403 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.
4405 \begin_layout Description
4406 Sample buffer-export-as pdf2
4408 \begin_layout Description
4409 Origin tommaso, 6 Oct 2011
4412 \begin_layout Subsection*
4413 buffer-export-custom
4415 \begin_layout Description
4416 Action Exports the current buffer (document) from the given format using the given command on it.
4418 \begin_layout Description
4419 Syntax buffer-export-custom <FORMAT> <COMMAND>
4421 \begin_layout Description
4422 Params <FORMAT> format to start from (LyX will care to produce such intermediate file).
4423 \begin_inset Newline newline
4426 <COMMAND> this command will be launched on the file. Note that you can use "$$FName" string to qualify the intermediate file.
4428 \begin_layout Description
4429 Sample buffer-export-custom dvi dvips -f $$FName -o myfile.ps
4431 \begin_layout Description
4432 Origin leeming, 27 Mar 2004
4435 \begin_layout Subsection*
4438 \begin_layout Description
4439 Action Applies a command to all non-hidden buffers.
4441 \begin_layout Description
4442 Notion a buffer is `hidden' if it is internally open in LyX, but not visible in any window.
4444 \begin_layout Description
4445 Syntax buffer-forall <LFUN-COMMAND>
4447 \begin_layout Description
4448 Params <LFUN-COMMAND>: The command to be applied to the buffers.
4450 \begin_layout Description
4451 Sample Close all Notes in buffers:
4452 \begin_inset Newline newline
4455 buffer-forall inset-forall Note inset-toggle close
4456 \begin_inset Newline newline
4459 Toggle change tracking on buffers:
4460 \begin_inset Newline newline
4463 buffer-forall changes-track
4464 \begin_inset Newline newline
4467 Toggle read-only for buffers:
4468 \begin_inset Newline newline
4471 buffer-forall buffer-toggle-read-only
4472 \begin_inset Newline newline
4475 Show statistics for individual buffers:
4476 \begin_inset Newline newline
4479 buffer-forall statistics
4480 \begin_inset Newline newline
4483 Activate the branch named "Solutions" in buffers:
4484 \begin_inset Newline newline
4487 buffer-forall branch-activate Solutions
4488 \begin_inset Newline newline
4491 Export buffers to PDF (pdflatex):
4492 \begin_inset Newline newline
4495 buffer-forall buffer-export pdf2
4496 \begin_inset Newline newline
4501 \begin_layout Description
4502 Origin scottkostyshak, 20 Jul 2012
4505 \begin_layout Subsection*
4508 \begin_layout Description
4509 Action Import a given file as a lyx document.
4511 \begin_layout Description
4512 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.
4514 \begin_layout Description
4515 Syntax buffer-import <FORMAT> [<FILE>]
4517 \begin_layout Description
4518 Origin Asger, 24 Jul 1998
4521 \begin_layout Subsection*
4524 \begin_layout Description
4525 Action Set language of the current document.
4527 \begin_layout Description
4528 Syntax buffer-language <LANG>
4530 \begin_layout Description
4531 Params <LANG>: language name. See lib/languages for list.
4533 \begin_layout Description
4534 Origin leeming, 30 Mar 2004
4537 \begin_layout Subsection*
4540 \begin_layout Description
4541 Action Creates a new buffer (that is, document) and switches to it.
4543 \begin_layout Description
4544 Notion Implicit path can be set in Preferences dialog.
4546 \begin_layout Description
4547 Syntax buffer-new [<FILE>]
4549 \begin_layout Description
4550 Params <FILE>: filename of created file with absolute path.
4553 \begin_layout Subsection*
4556 \begin_layout Description
4557 Action Creates a new buffer (that is, document) from a template.
4559 \begin_layout Description
4560 Notion Path for new files and templates can be set in Preferences dialog. Template will be asked for via Open-dialog.
4562 \begin_layout Description
4563 Syntax buffer-new-template [<FILE>]
4565 \begin_layout Description
4566 Params <FILE>: filename of created file with absolute path.
4569 \begin_layout Subsection*
4572 \begin_layout Description
4573 Action Switch to the next opened document.
4575 \begin_layout Description
4576 Notion Note that this does not necessarily mean next in tabbar (for full list see View menu).
4578 \begin_layout Description
4582 \begin_layout Subsection*
4585 \begin_layout Description
4586 Action Apply the given settings to the current document.
4588 \begin_layout Description
4589 Syntax buffer-params-apply [<ARGS>]
4591 \begin_layout Description
4592 Params <ARGS>: contains the particular settings to be saved. They obey the syntax you can find in document header of usual .lyx file.
4594 \begin_layout Description
4595 Origin leeming, 30 Mar 2004
4598 \begin_layout Subsection*
4601 \begin_layout Description
4602 Action Switch to the previous opened document.
4604 \begin_layout Description
4605 Syntax buffer-previous
4608 \begin_layout Subsection*
4611 \begin_layout Description
4612 Action Prints the current document.
4614 \begin_layout Description
4615 Notion Many settings can be given via the preferences dialog.
4617 \begin_layout Description
4618 Syntax buffer-print <TARGET> <TARGET-NAME> <COMMAND>
4620 \begin_layout Description
4621 Params <TARGET> is either "printer" or "file".
4622 \begin_inset Newline newline
4625 <TARGER-NAME> is either "default" or file name or printer name.
4626 \begin_inset Newline newline
4629 <COMMAND> command ensuring the printing job.
4631 \begin_layout Description
4632 Sample buffer-print file "/trash/newfile1.ps" "dvips"
4634 \begin_layout Description
4635 Origin leeming, 28 Mar 2004
4638 \begin_layout Subsection*
4641 \begin_layout Description
4642 Action Reverts opened document.
4644 \begin_layout Description
4645 Syntax buffer-reload
4647 \begin_layout Description
4648 Origin Asger, 2 Feb 1997
4651 \begin_layout Subsection*
4652 buffer-save-as-default
4654 \begin_layout Description
4655 Action Save the current document settings as default.
4657 \begin_layout Description
4658 Notion The file will will be saved into ~/.lyx/templates/defaults.lyx .
4660 \begin_layout Description
4661 Syntax buffer-save-as-default [<ARGS>]
4663 \begin_layout Description
4664 Params <ARGS>: contains the particular settings to be saved. They obey the syntax you can find in document header of usual .lyx file.
4666 \begin_layout Description
4667 Origin leeming, 30 Mar 2004
4670 \begin_layout Subsection*
4673 \begin_layout Description
4674 Action Display and switch to the given buffer.
4676 \begin_layout Description
4677 Syntax buffer-switch <BUFFER>
4679 \begin_layout Description
4680 Params <BUFFER>: path and filename of already opened (but possibly hidden) document which is to be shown.
4683 \begin_layout Subsection*
4684 buffer-toggle-compression
4686 \begin_layout Description
4687 Action Toggles compression of the current document on/off.
4689 \begin_layout Description
4690 Syntax buffer-toggle-compression
4692 \begin_layout Description
4693 Origin bpeng, 27 Apr 2006
4696 \begin_layout Subsection*
4697 buffer-toggle-read-only
4699 \begin_layout Description
4700 Action Toggle editing mode of the current document between read/write and read-only.
4702 \begin_layout Description
4703 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.
4705 \begin_layout Description
4706 Syntax buffer-toggle-read-only
4708 \begin_layout Description
4709 Origin Lgb, 27 May 1997
4712 \begin_layout Subsection*
4715 \begin_layout Description
4716 Action Exports the current document and put the result into the temporary directory.
4718 \begin_layout Description
4719 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).
4721 \begin_layout Description
4722 Syntax buffer-update [<FORMAT>]
4724 \begin_layout Description
4725 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.
4727 \begin_layout Description
4728 Origin Dekel, 5 Aug 2000
4731 \begin_layout Subsection*
4734 \begin_layout Description
4735 Action Displays current buffer in chosen format.
4737 \begin_layout Description
4738 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.
4740 \begin_layout Description
4741 Syntax buffer-view [<FORMAT>]
4743 \begin_layout Description
4744 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.
4747 \begin_layout Subsection*
4750 \begin_layout Description
4751 Action Saves the current buffer.
4753 \begin_layout Description
4754 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.
4756 \begin_layout Description
4760 \begin_layout Subsection*
4763 \begin_layout Description
4764 Action Save all changed documents.
4766 \begin_layout Description
4767 Syntax buffer-write-all
4769 \begin_layout Description
4770 Origin rgh, gpothier 6 Aug 2007
4773 \begin_layout Subsection*
4776 \begin_layout Description
4777 Action Rename and save current buffer.
4779 \begin_layout Description
4780 Syntax buffer-write-as <FILENAME>
4782 \begin_layout Description
4783 Params <FILENAME>: New name of the buffer/file. A relative path is with respect to the original location of the buffer/file.
4786 \begin_layout Subsection*
4789 \begin_layout Description
4790 Action Increases the zoom of the screen fonts.
4792 \begin_layout Description
4793 Syntax buffer-zoom-in [<ZOOM>]
4795 \begin_layout Description
4796 Params <ZOOM>: The zoom in %, the default is 20.
4798 \begin_layout Description
4799 Origin vfr, 30 Mar 2009
4802 \begin_layout Subsection*
4805 \begin_layout Description
4806 Action Decreases the zoom of the screen fonts.
4808 \begin_layout Description
4809 Syntax buffer-zoom-out [<ZOOM>]
4811 \begin_layout Description
4812 Params <ZOOM>: The zoom in %, the default is 20.
4814 \begin_layout Description
4815 Origin vfr, 30 Mar 2009
4818 \begin_layout Subsection*
4821 \begin_layout Description
4822 Action Generates the code (literate programming).
4824 \begin_layout Description
4825 Notion Latex file with extension
4827 literate_extension is generated. Then LyX invokes
4829 build_command (with a default of ``make'') to generate the code and
4831 build_error_filter to process the compilation error messages.
4832 \begin_inset Newline newline
4835 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:
4836 \begin_inset Newline newline
4841 build_command "my_script my_arguments"
4842 \begin_inset Newline newline
4847 build_error_filter differs from the
4849 literate_error_filter only in that the former will identify error messages from your compiler.
4851 \begin_layout Description
4852 Syntax build-program
4855 \begin_layout Subsection*
4858 \begin_layout Description
4859 Action Open LyX document.
4861 \begin_layout Description
4862 Syntax file-open [<FILE>]
4864 \begin_layout Description
4865 Params <FILE>: Filename to be opened.
4868 \begin_layout Subsection*
4871 \begin_layout Description
4872 Action Open the given help file according to the language setting.
4874 \begin_layout Description
4875 Syntax help-open <FILE>[.lyx]
4877 \begin_layout Description
4878 Params <FILE>: any document from (/usr/share/)doc directory.
4880 \begin_layout Description
4881 Origin Jug, 27 Jun 1999
4884 \begin_layout Subsection*
4887 \begin_layout Description
4888 Action Terminates the current LyX instance.
4890 \begin_layout Description
4891 Notion Terminates the current LyX instance, asking whether to save modified documents, etc.
4893 \begin_layout Description
4897 \begin_layout Subsection*
4898 master-buffer-update
4900 \begin_layout Description
4901 Action Update (export) the document built from the master buffer, if the current buffer is part of a master/child document.
4903 \begin_layout Description
4904 Syntax master-buffer-update [<FORMAT>]
4906 \begin_layout Description
4907 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.
4909 \begin_layout Description
4910 Origin Tommaso, 20 Sep 2007
4913 \begin_layout Subsection*
4916 \begin_layout Description
4917 Action Show a preview built from the master buffer, if available. if the current buffer is part of a master/child document.
4919 \begin_layout Description
4920 Syntax master-buffer-view [<FORMAT>]
4922 \begin_layout Description
4923 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.
4925 \begin_layout Description
4926 Origin Tommaso, 20 Sep 2007
4929 \begin_layout Subsection*
4932 \begin_layout Description
4933 Action Opens the menu given by its name.
4935 \begin_layout Description
4936 Syntax menu-open <NAME>
4938 \begin_layout Description
4939 Params <NAME>: menu name. See various .inc files in lib/ui for candidates.
4942 \begin_layout Subsection*
4945 \begin_layout Description
4946 Action Close the current tab group.
4948 \begin_layout Description
4949 Notion This only closes the work areas, not the buffers themselves. The still opened buffers can be visualized in another tab group.
4951 \begin_layout Description
4952 Syntax tab-group-close
4954 \begin_layout Description
4955 Origin Abdel, 21 Feb 2008
4958 \begin_layout Subsection*
4961 \begin_layout Description
4962 Action Toggles visibility of a given toolbar between on/off/auto.
4964 \begin_layout Description
4965 Notion Skipping "auto" when allowauto is false.
4967 \begin_layout Description
4968 Syntax toolbar-toggle <NAME> [allowauto]
4970 \begin_layout Description
4971 Params <NAME>: standard|extra|table|math|mathmacrotemplate|
4972 \begin_inset Newline newline
4975 minibuffer|review|view/update|math_panels|vcs| view-others|update-others
4977 \begin_layout Description
4978 Origin Edwin, 21 May 2007
4981 \begin_layout Subsection*
4984 \begin_layout Description
4985 Action Various UI visibility-toggling actions.
4987 \begin_layout Description
4988 Syntax ui-toggle <statusbar|menubar|scrollbar|frame|fullscreen>
4990 \begin_layout Description
4991 Params statusbar : Toggle visibility of the statusbar.
4992 \begin_inset Newline newline
4995 menubar : Toggle visibility of the menubar.
4996 \begin_inset Newline newline
4999 scrollbar : Toggle visibility of the scrollbar.
5000 \begin_inset Newline newline
5003 frame : Toggle visibility of the frames around editing window.
5004 \begin_inset Newline newline
5007 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.
5009 \begin_layout Description
5010 Origin sanda, 9 Feb 2007
5013 \begin_layout Subsection*
5016 \begin_layout Description
5017 Action Close the current document work area.
5019 \begin_layout Description
5020 Notion Close the current work area. If no other work areas are showing the buffer, then close the associated buffer as well.
5022 \begin_layout Description
5025 \begin_layout Description
5026 Origin Tommaso, 15 Sep 2012
5029 \begin_layout Subsection*
5032 \begin_layout Description
5033 Action Creates another split view of current buffer.
5035 \begin_layout Description
5036 Notion All split views act in the same way independently.
5038 \begin_layout Description
5039 Syntax view-split <vertical|horizontal>
5041 \begin_layout Description
5042 Params horizontal : The work areas are laid out side by side.
5043 \begin_inset Newline newline
5046 vertical : The work areas laid out vertically.
5048 \begin_layout Description
5049 Origin Abdel, 20 Feb 2008
5052 \begin_layout Subsection*
5055 \begin_layout Description
5056 Action Closes the current LyX window.
5058 \begin_layout Description
5061 \begin_layout Description
5062 Origin Abdel, 23 Oct 2006
5065 \begin_layout Subsection*
5068 \begin_layout Description
5069 Action Creates new empty LyX window.
5071 \begin_layout Description
5072 Notion Already opened documents from the previous window can be found under View menu.
5074 \begin_layout Description
5075 Syntax window-new [<GEOMETRY>]
5077 \begin_layout Description
5078 Params <GEOMETRY>: pass the geometry of the window. This parameter is currently accepted only on Windows platform.
5080 \begin_layout Description
5081 Origin Abdel, 21 Oct 2006
5084 \begin_layout Section
5085 System Funtions (Preferences, LyX Server etc.)
5087 \begin_layout Subsection*
5088 buffer-toggle-output-sync
5090 \begin_layout Description
5091 Action Toggles including of resources for forward/reverse search of the given document.
5093 \begin_layout Description
5094 Notion When toggled on, SyncTeX is invoked for PDF, while srcltx package is used for DVI. Custom LaTeX macro can be defined in preferences.
5096 \begin_layout Description
5097 Syntax buffer-toggle-output-sync
5099 \begin_layout Description
5100 Origin sanda, 25 May 2010
5103 \begin_layout Subsection*
5106 \begin_layout Description
5107 Action Executes a command defined in a .def file.
5109 \begin_layout Description
5110 Notion The definitions are by default read from lib/commands/default.def.
5111 \begin_inset Newline newline
5114 A .def file allows to define a command with
5116 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).
5118 def_file "FileName" allows to include another .def file.
5119 \begin_inset Newline newline
5122 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.
5124 \begin_layout Description
5127 \begin_layout Description
5128 Params <NAME>: Name of the command that must be called.
5130 \begin_layout Description
5131 Origin broider, 2 Oct 2007
5134 \begin_layout Subsection*
5137 \begin_layout Description
5138 Action Cancels sequence prepared by LFUN_META_PREFIX .
5140 \begin_layout Description
5144 \begin_layout Subsection*
5145 command-alternatives
5147 \begin_layout Description
5148 Action Runs the first listed command that is enabled.
5150 \begin_layout Description
5151 Notion This can be used to bind multiple functions to a single key, and then which one is used will depend upon the context.
5153 \begin_layout Description
5154 Syntax command-alternatives <CMDS>
5156 \begin_layout Description
5157 Params <CMDS>: Sequence of commands separated by semicolons.
5159 \begin_layout Description
5160 Sample command-alternatives completion-accept;cell-forward
5162 \begin_layout Description
5163 Origin rgh, 24 September 2008
5166 \begin_layout Subsection*
5169 \begin_layout Description
5170 Action Run more commands (LFUN and its parameters) in a sequence.
5172 \begin_layout Description
5173 Syntax command-sequence <CMDS>
5175 \begin_layout Description
5176 Params <CMDS>: Sequence of commands separated by semicolons.
5178 \begin_layout Description
5179 Sample command-sequence cut; ert-insert; self-insert
5181 ; paste; self-insert {}; inset-toggle;
5183 \begin_layout Description
5184 Origin Andre, 11 Nov 1999
5187 \begin_layout Subsection*
5188 cursor-follows-scrollbar-toggle
5190 \begin_layout Description
5191 Action Determine whether to keep cursor inside the editing window regardless of the scrollbar movement.
5193 \begin_layout Description
5194 Syntax toggle-cursor-follows-scrollbar
5196 \begin_layout Description
5197 Origin ARRae, 2 Dec 1997
5200 \begin_layout Subsection*
5203 \begin_layout Description
5204 Action Set debug output level.
5206 \begin_layout Description
5207 Syntax debug-level-set <LEVEL>
5209 \begin_layout Description
5210 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.
5212 \begin_layout Description
5213 Origin sanda, 28 Dec 2009
5216 \begin_layout Subsection*
5219 \begin_layout Description
5220 Action Sets the cursor position in the previewed (dvi/pdf) file based on the row number in LyX window.
5222 \begin_layout Description
5223 Notion The external program used for forward search call can be specified in LyX Output preferences. See Additional manual for details of these settings.
5225 \begin_layout Description
5226 Syntax forward-search
5228 \begin_layout Description
5229 Origin sanda, 14 Apr 2010
5232 \begin_layout Subsection*
5235 \begin_layout Description
5236 Action Apply the given settings to user preferences.
5238 \begin_layout Description
5239 Syntax lyxrc-apply <SETTINGS>
5241 \begin_layout Description
5242 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.
5245 \begin_layout Subsection*
5248 \begin_layout Description
5249 Action Shows message in statusbar (for script purposes).
5251 \begin_layout Description
5252 Syntax message <STRING>
5254 \begin_layout Description
5255 Origin Lgb, 8 Apr 2001
5258 \begin_layout Subsection*
5261 \begin_layout Description
5262 Action Simulate halting Meta key (Alt key on PCs).
5264 \begin_layout Description
5265 Notion Used for buffer editation not for GUI control.
5267 \begin_layout Description
5271 \begin_layout Subsection*
5274 \begin_layout Description
5275 Action Save user preferences.
5277 \begin_layout Description
5278 Syntax preferences-save
5280 \begin_layout Description
5281 Origin Lgb, 27 Nov 1999
5284 \begin_layout Subsection*
5287 \begin_layout Description
5288 Action Reconfigure the automatic settings.
5290 \begin_layout Description
5293 \begin_layout Description
5294 Origin Asger, 14 Feb 1997
5297 \begin_layout Subsection*
5300 \begin_layout Description
5301 Action Returns path and file name of the currently edited document.
5303 \begin_layout Description
5304 Syntax server-get-filename
5307 \begin_layout Subsection*
5310 \begin_layout Description
5311 Action Returns the current layout (that is environment) name on the cursor position.
5313 \begin_layout Description
5314 Syntax server-get-layout
5317 \begin_layout Subsection*
5320 \begin_layout Description
5321 Action Returns the coordinates of cursor position in the editing area.
5323 \begin_layout Description
5324 Syntax server-get-xy
5327 \begin_layout Subsection*
5328 server-goto-file-row
5330 \begin_layout Description
5331 Action Sets the cursor position in LyX based on the row number of generated TeX file.
5333 \begin_layout Description
5334 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).
5336 \begin_layout Description
5337 Syntax server-goto-file-row <FILE[.ext]> <ROW_NUMBER>
5339 \begin_layout Description
5340 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.
5341 \begin_inset Newline newline
5344 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).
5345 \begin_inset Newline newline
5348 .ext: extensions will be automatically replaced by .lyx.
5349 \begin_inset Newline newline
5352 <ROW_NUMBER> The row number of the LaTeX file to which to go.
5354 \begin_layout Description
5355 Sample server-goto-file-row /home/user/example.lyx 41
5356 \begin_inset Newline newline
5359 server-goto-file-row /tmp/lyx_tmpdir.XM3088/lyx_tmpbuf0/example.tex 41
5361 \begin_layout Description
5362 Origin Edmar, 23 Dec 1998
5365 \begin_layout Subsection*
5368 \begin_layout Description
5369 Action Sends notify message about the last key-sequence to client.
5371 \begin_layout Description
5372 Notion This can be used to grab last key-sequence used inside the LyX window. See also Debug extensions section in Additional features manual.
5374 \begin_layout Description
5375 Syntax server-notify
5378 \begin_layout Subsection*
5381 \begin_layout Description
5382 Action Sets the cursor position based on the editing area coordinates (similar to clicking on that point with left mouse button).
5384 \begin_layout Description
5385 Syntax server-set-xy <X> <Y>
5388 \begin_layout Subsection*
5391 \begin_layout Description
5392 Action Set the given LyX color to the color defined by the X11 name given.
5394 \begin_layout Description
5395 Notion A new color entry is created if the color is unknown. Color names can be stored as a part of user settings.
5397 \begin_layout Description
5398 Syntax set-color <LYX_NAME> <X11_NAME>
5400 \begin_layout Description
5401 Origin SLior, 11 Jun 2000
5404 \begin_layout Subsection*
5407 \begin_layout Description
5408 Action Count the statistics (number of words and characters) in the document or in the given selection.
5410 \begin_layout Description
5411 Notion Note that this function gives the number of words/chars written, not the number of characters which will be typeset.
5413 \begin_layout Description
5416 \begin_layout Description
5417 Origin lasgouttes, Jan 27 2004; sanda, Jan 8 2008
5420 \begin_layout Subsection*
5423 \begin_layout Description
5424 Action Checks-in/commits the changes of the registered file to the repository.
5426 \begin_layout Description
5427 Notion In RCS case this also unlocks the file.
5429 \begin_layout Description
5432 \begin_layout Description
5433 Origin Lgb, 1 Jul 1997
5436 \begin_layout Subsection*
5439 \begin_layout Description
5440 Action Checks-out the document for edit (and locks it in some cases).
5442 \begin_layout Description
5445 \begin_layout Description
5446 Origin Lgb, 1 Jul 1997
5449 \begin_layout Subsection*
5452 \begin_layout Description
5453 Action Executes external command. This command is intended to support additional VCS commands.
5455 \begin_layout Description
5456 Syntax vc-command <FLAG> <PATH> <COMMAND>
5458 \begin_layout Description
5459 Params <FLAG>: Flags for the command can be combined together.
5460 \begin_inset Newline newline
5463 U - dUmmy - no flags
5464 \begin_inset Newline newline
5467 D - Doc - need document loaded to proceed
5468 \begin_inset Newline newline
5471 I - dIrty - mark document dirty
5472 \begin_inset Newline newline
5475 R - Reload - ensure that the document is saved and reload it after command execution
5476 \begin_inset Newline newline
5479 M - Message - ask for input string (commit message)
5480 \begin_inset Newline newline
5483 <PATH>: path where to start. $$p will be replaced by the current document path.
5484 \begin_inset Newline newline
5487 <COMMAND>: command to execute. $$i/$$p/$$m will be replaced by the current document(with absolute path)/path/message.
5489 \begin_layout Description
5490 Sample vc-command DR $$p "svn up"
5492 \begin_layout Description
5493 Origin sanda, 13 Jan 2009
5496 \begin_layout Subsection*
5499 \begin_layout Description
5500 Action Compares two revisions of the same file under version control.
5502 \begin_layout Description
5503 Syntax vc-compare [<REV1>] [<REV2>]
5505 \begin_layout Description
5506 Params Revision number either points directly to commit in history or if negative number -x it points to (last commit - x).
5507 \begin_inset Newline newline
5510 In RCS we subtract only in the last number of revision specification. Special case "0" is reserved for the last committed revision.
5511 \begin_inset Newline newline
5515 \begin_inset Newline newline
5518 <REV2>: Newer file. Used only if REV1 > 0.
5519 \begin_inset Newline newline
5522 If no parameter is given, interactive dialog will be shown.
5524 \begin_layout Description
5525 Sample Compare current document against last commit
5526 \begin_inset Newline newline
5530 \begin_inset Newline newline
5533 Compare current document against current revision - 5 commits
5534 \begin_inset Newline newline
5538 \begin_inset Newline newline
5541 Compare revisions 120 and 155
5542 \begin_inset Newline newline
5547 \begin_layout Description
5548 Origin sanda, 12 Feb 2010
5551 \begin_layout Subsection*
5554 \begin_layout Description
5555 Action Copies the document to another name.
5557 \begin_layout Description
5558 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.
5560 \begin_layout Description
5561 Syntax vc-copy <FILENAME>
5563 \begin_layout Description
5564 Params <FILENAME>: New name of the document.
5565 \begin_inset Newline newline
5568 A file dialog is opened if no filename is given.
5570 \begin_layout Description
5571 Origin gb, 05 Feb 2013
5574 \begin_layout Subsection*
5577 \begin_layout Description
5578 Action Toggles the locking property of the edited file.
5580 \begin_layout Description
5581 Notion This is currently implemented only for SVN.
5583 \begin_layout Description
5584 Syntax vc-locking-toggle
5586 \begin_layout Description
5587 Origin sanda, 25 Jun 2009
5590 \begin_layout Subsection*
5593 \begin_layout Description
5594 Action Register the document as an file inside version control system.
5596 \begin_layout Description
5597 Notion File is registered inside cvs, svn or rcs repository acording to the existence of cvs/svn/rcs entries in the document's directory.
5598 \begin_inset Newline newline
5601 See LyX Additional Features Manual (Version Control Chapter) for additional information.
5603 \begin_layout Description
5606 \begin_layout Description
5607 Origin Lgb, 1 Jul 1997
5610 \begin_layout Subsection*
5613 \begin_layout Description
5614 Action Renames the document to another name.
5616 \begin_layout Description
5617 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.
5619 \begin_layout Description
5620 Syntax vc-rename <FILENAME>
5622 \begin_layout Description
5623 Params <FILENAME>: New name of the document.
5624 \begin_inset Newline newline
5627 A file dialog is opened if no filename is given.
5629 \begin_layout Description
5630 Origin gb, 05 Feb 2013
5633 \begin_layout Subsection*
5636 \begin_layout Description
5637 Action Update the local archive directory in which resides the current document with the remote repository.
5639 \begin_layout Description
5640 Syntax vc-repo-update
5642 \begin_layout Description
5643 Origin sanda, 16 Oct 2009
5646 \begin_layout Subsection*
5649 \begin_layout Description
5650 Action Reverts the document to the last check-in/commit in VCS.
5652 \begin_layout Description
5655 \begin_layout Description
5656 Origin Lgb, 1 Jul 1997
5659 \begin_layout Subsection*
5662 \begin_layout Description
5663 Action Undo last check-in.
5665 \begin_layout Description
5666 Notion This is currently implemented only for RCS.
5668 \begin_layout Description
5671 \begin_layout Description
5672 Origin Lgb, 1 Jul 1997
5675 \begin_layout Section
5676 Hidden Functions (not listed for configuration)
5678 \begin_layout Subsection*
5681 \begin_layout Description
5682 Action Return the current key sequence and available options as a string.
5684 \begin_layout Description
5685 Notion No options are added if no current map exists.
5686 \begin_inset Newline newline
5689 This is probably usable only with connection to lyxserver.
5691 \begin_layout Description
5692 Syntax command-prefix
5695 \begin_layout Subsection*
5698 \begin_layout Description
5699 Action Inserts the given string (accordingly to the correct keymap).
5701 \begin_layout Description
5702 Notion Automatically replace the currently selected text. Depends on lyxrc settings "auto_region_delete".
5704 \begin_layout Description
5705 Syntax self-insert <STRING>