#LyX 2.2 created this file. For more info see http://www.lyx.org/ \lyxformat 508 \begin_document \begin_header \save_transient_properties true \origin /systemlyxdir/doc/ \textclass article \begin_preamble \renewcommand{\descriptionlabel}[1]{\hspace\labelsep\upshape\bfseries #1:} \renewenvironment{description}{\list{}{% \setlength{\itemsep}{-2pt} \advance\leftmargini6\p@ \itemindent-12\p@ \labelwidth\z@ \let\makelabel\descriptionlabel}% }{ \endlist } \end_preamble \use_default_options false \maintain_unincluded_children false \begin_local_layout Style Description LabelIndent MM LeftMargin MMMMMxx End \end_local_layout \language english \language_package default \inputencoding auto \fontencoding global \font_roman "default" "default" \font_sans "default" "default" \font_typewriter "default" "default" \font_math "auto" "auto" \font_default_family default \use_non_tex_fonts false \font_sc false \font_osf false \font_sf_scale 100 100 \font_tt_scale 100 100 \graphics default \default_output_format default \output_sync 0 \bibtex_command default \index_command default \paperfontsize default \spacing single \use_hyperref false \papersize default \use_geometry true \use_package amsmath 1 \use_package amssymb 1 \use_package cancel 1 \use_package esint 1 \use_package mathdots 1 \use_package mathtools 1 \use_package mhchem 1 \use_package stackrel 1 \use_package stmaryrd 1 \use_package undertilde 1 \cite_engine basic \cite_engine_type default \biblio_style plain \use_bibtopic false \use_indices false \paperorientation portrait \suppress_date false \justification true \use_refstyle 0 \index Index \shortcut idx \color #008000 \end_index \leftmargin 2.5cm \topmargin 2cm \rightmargin 3cm \bottommargin 2.5cm \secnumdepth 3 \tocdepth 3 \paragraph_separation indent \paragraph_indentation default \quotes_language english \papercolumns 1 \papersides 1 \paperpagestyle default \tracking_changes false \output_changes false \html_math_output 0 \html_css_as_file 0 \html_be_strict false \end_header \begin_body \begin_layout Title \SpecialChar LyX Functions (LFUNs) \end_layout \begin_layout Author The \SpecialChar LyX Team \end_layout \begin_layout Section* About this manual \end_layout \begin_layout Standard This manual documents the \begin_inset Quotes eld \end_inset LyX Functions \begin_inset Quotes erd \end_inset (abbreviated LFUNs). These are commands that are used to make \SpecialChar LyX perform specific actions. \SpecialChar LyX itself uses these functions internally, and every internal action is bound to an LFUN. \end_layout \begin_layout Standard LFUNs are also used in the files that define keyboard shortcuts, menu or toolbar items. So if you want to change\SpecialChar breakableslash customize the user interface, you need to deal with LFUNs. Furthermore, external programs can use LFUNs to communicate with and \begin_inset Quotes eld \end_inset remote-control \begin_inset Quotes erd \end_inset \SpecialChar LyX . Finally, you can also issue LFUNs directly via the so called mini-buffer which can be opened via \begin_inset Info type "shortcuts" arg "command-execute" \end_inset . \end_layout \begin_layout Standard In the following, all LFUNs are listed, categorized by function. \end_layout \begin_layout Section Layout Functions (Font, Layout and Textclass related) \end_layout \begin_layout Subsection* drop-layouts-choice \end_layout \begin_layout Description Action Displays list of layout choices. \end_layout \begin_layout Description Notion In the current (as of 2007) Qt4 frontend, this LFUN opens the dropbox allowing for choice of layout. \end_layout \begin_layout Description Syntax drop-layouts-choice \end_layout \begin_layout Subsection* environment-split \end_layout \begin_layout Description Action Splits the current environment with a Separator. \end_layout \begin_layout Description Syntax environment-split [outer] \end_layout \begin_layout Description Params outer: If this is given, LyX will split the outermost environment in the current nesting hierarchy. \end_layout \begin_layout Description Origin spitz, 23 Dec 2012 \end_layout \begin_layout Subsection* font-bold \end_layout \begin_layout Description Action Toggles the bold font (selection-wise) using mathbf in math. \end_layout \begin_layout Description Syntax font-bold \end_layout \begin_layout Subsection* font-boldsymbol \end_layout \begin_layout Description Action Toggles the bold font (selection-wise) using boldsymbol in math. \end_layout \begin_layout Description Syntax font-boldsymbol \end_layout \begin_layout Subsection* font-default \end_layout \begin_layout Description Action Reverts the settings of the font to the default values (selection-wise). \end_layout \begin_layout Description Syntax font-default \end_layout \begin_layout Subsection* font-emph \end_layout \begin_layout Description Action Toggles the emphasis font style (selection-wise). \end_layout \begin_layout Description Syntax font-emph \end_layout \begin_layout Subsection* font-frak \end_layout \begin_layout Description Action Toggles Fraktur family font (math-mode, selection-wise). \end_layout \begin_layout Description Syntax font-frak \end_layout \begin_layout Description Origin vermeer, 10 Jan 2002 \end_layout \begin_layout Subsection* font-ital \end_layout \begin_layout Description Action Toggles Italics font shape (math-mode, selection-wise). \end_layout \begin_layout Description Syntax font-ital \end_layout \begin_layout Description Origin vermeer, 10 Jan 2002 \end_layout \begin_layout Subsection* font-noun \end_layout \begin_layout Description Action Toggles Noun text style font (selection-wise). \end_layout \begin_layout Description Syntax font-noun \end_layout \begin_layout Subsection* font-roman \end_layout \begin_layout Description Action Toggles Roman family font (selection-wise). \end_layout \begin_layout Description Syntax font-roman \end_layout \begin_layout Subsection* font-sans \end_layout \begin_layout Description Action Toggles Sans Serif family font (selection-wise). \end_layout \begin_layout Description Syntax font-sans \end_layout \begin_layout Subsection* font-size \end_layout \begin_layout Description Action Sets font size according to lyx format string. \end_layout \begin_layout Description Syntax font-size \end_layout \begin_layout Description Params : tiny|scriptsize|footnotesize|small|normal|large|larger| \begin_inset Newline newline \end_inset largest|huge|giant|increase|decrease|default \end_layout \begin_layout Subsection* font-state \end_layout \begin_layout Description Action Returns the info about the current font. \end_layout \begin_layout Description Syntax font-state \end_layout \begin_layout Subsection* font-strikeout \end_layout \begin_layout Description Action Toggles strikeout (strike-through) in the font (selection-wise). \end_layout \begin_layout Description Syntax font-strikeout \end_layout \begin_layout Description Origin sanda, 3 May 2009 \end_layout \begin_layout Subsection* font-typewriter \end_layout \begin_layout Description Action Toggles the typewriter family font (selection-wise). \end_layout \begin_layout Description Syntax font-typewriter \end_layout \begin_layout Subsection* font-underline \end_layout \begin_layout Description Action Toggles underline in the font (selection-wise). \end_layout \begin_layout Description Syntax font-underline \end_layout \begin_layout Subsection* font-underunderline \end_layout \begin_layout Description Action Toggles double underline in the font (selection-wise). \end_layout \begin_layout Description Syntax font-underunderline \end_layout \begin_layout Description Origin sanda, 5 May 2009 \end_layout \begin_layout Subsection* font-underwave \end_layout \begin_layout Description Action Toggles wavy underline in the font (selection-wise). \end_layout \begin_layout Description Syntax font-underwave \end_layout \begin_layout Description Origin sanda, 5 May 2009 \end_layout \begin_layout Subsection* layout \end_layout \begin_layout Description Action Sets the layout (that is, environment) for the current paragraph. \end_layout \begin_layout Description Syntax layout \end_layout \begin_layout Description Params : the layout to use \end_layout \begin_layout Subsection* layout-module-add \end_layout \begin_layout Description Action Adds a module. \end_layout \begin_layout Description Notion Adds a module to the list of included modules for the current buffer. \end_layout \begin_layout Description Syntax layout-module-add \end_layout \begin_layout Description Params : the module to be added \end_layout \begin_layout Description Origin rgh, 25 August 2007 \end_layout \begin_layout Subsection* layout-modules-clear \end_layout \begin_layout Description Action Clears the module list. \end_layout \begin_layout Description Notion Clears the list of included modules for the current buffer. \end_layout \begin_layout Description Syntax layout-modules-clear \end_layout \begin_layout Description Origin rgh, 25 August 2007 \end_layout \begin_layout Subsection* layout-paragraph \end_layout \begin_layout Description Action Launches the paragraph settings dialog. \end_layout \begin_layout Description Syntax layout-paragraph \end_layout \begin_layout Subsection* layout-reload \end_layout \begin_layout Description Action Reloads layout information. \end_layout \begin_layout Description 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. \end_layout \begin_layout Description Syntax layout-reload \end_layout \begin_layout Description Origin rgh, 3 September 2007 \end_layout \begin_layout Subsection* layout-tabular \end_layout \begin_layout Description Action Launches the tabular settings dialog. \end_layout \begin_layout Description Syntax layout-tabular \end_layout \begin_layout Description Origin Jug, 31 Jul 2000 \end_layout \begin_layout Subsection* screen-font-update \end_layout \begin_layout Description Action Update fonts and its metrics. \end_layout \begin_layout Description Notion Automatically called after zoom, dpi, font names, or norm change. \end_layout \begin_layout Description Syntax screen-font-update \end_layout \begin_layout Description Origin ARRae, 13 Aug 2000 \end_layout \begin_layout Subsection* textclass-apply \end_layout \begin_layout Description Action Sets the text class for the current buffer. \end_layout \begin_layout Description Syntax textclass-apply \end_layout \begin_layout Description Params : the textclass to set. Note that this must be the filename, minus the ".layout" extension. \end_layout \begin_layout Subsection* textclass-load \end_layout \begin_layout Description Action Loads information for a textclass from disk. \end_layout \begin_layout Description Syntax textclass-load \end_layout \begin_layout Description Params : the textclass to load. Note that this must be the filename, minus the ".layout" extension. \end_layout \begin_layout Subsection* textstyle-apply \end_layout \begin_layout Description Action Toggle user-defined (=last-time used) text style. \end_layout \begin_layout Description Notion This style is set via LFUN_TEXTSTYLE_UPDATE, which is automatically triggered when using Text Style dialog. \end_layout \begin_layout Description Syntax textstyle-apply \end_layout \begin_layout Description Origin leeming, 12 Mar 2003 \end_layout \begin_layout Subsection* textstyle-update \end_layout \begin_layout Description Action Apply text style and update the settings to be used by LFUN_TEXTSTYLE_APPLY. \end_layout \begin_layout Description Syntax textstyle-update \end_layout \begin_layout Description Params : specifies font atributes, e.g. family, series, shape, size, emph, noun, underbar, number, color, language, toggleall. \begin_inset Newline newline \end_inset Use lyx -dbg action for exact syntax of text-style dialog parameters. \end_layout \begin_layout Description Origin leeming, 12 Mar 2003 \end_layout \begin_layout Section Editing Functions (Cursor and Mouse Movement, Copy/Paste etc.) \end_layout \begin_layout Subsection* accent-acute \end_layout \begin_layout Description Action Adds an acute accent to the next character typed. \end_layout \begin_layout Description Syntax accent-acute \end_layout \begin_layout Subsection* accent-breve \end_layout \begin_layout Description Action Adds a breve accent to the next character typed. \end_layout \begin_layout Description Syntax accent-breve \end_layout \begin_layout Subsection* accent-caron \end_layout \begin_layout Description Action Adds a caron to the next character typed. \end_layout \begin_layout Description Syntax accent-caron \end_layout \begin_layout Subsection* accent-cedilla \end_layout \begin_layout Description Action Adds a cedilla to the next character typed. \end_layout \begin_layout Description Syntax accent-cedilla \end_layout \begin_layout Subsection* accent-circle \end_layout \begin_layout Description Action Adds a circle accent to the next character typed. \end_layout \begin_layout Description Syntax accent-circle \end_layout \begin_layout Subsection* accent-circumflex \end_layout \begin_layout Description Action Adds a circumflex to the next character typed. \end_layout \begin_layout Description Syntax accent-circumflex \end_layout \begin_layout Subsection* accent-dot \end_layout \begin_layout Description Action Adds a dot accent to the next character typed. \end_layout \begin_layout Description Syntax accent-dot \end_layout \begin_layout Subsection* accent-grave \end_layout \begin_layout Description Action Adds a grave accent to the next character typed. \end_layout \begin_layout Description Syntax accent-grave \end_layout \begin_layout Subsection* accent-hungarian-umlaut \end_layout \begin_layout Description Action Adds a Hungarian umlaut to the next character typed. \end_layout \begin_layout Description Syntax accent-grave \end_layout \begin_layout Subsection* accent-macron \end_layout \begin_layout Description Action Adds a macron to the next character typed. \end_layout \begin_layout Description Syntax accent-macron \end_layout \begin_layout Subsection* accent-ogonek \end_layout \begin_layout Description Action Adds an ogonek accent to the next character typed. \end_layout \begin_layout Description Syntax accent-ogonek \end_layout \begin_layout Subsection* accent-perispomeni \end_layout \begin_layout Description Action Adds a perispomeni (Greek circumflex) over the next character typed. \end_layout \begin_layout Description Syntax accent-perispomeni \end_layout \begin_layout Subsection* accent-tie \end_layout \begin_layout Description Action Adds a tie over the next two character typed. \end_layout \begin_layout Description Notion The following char will finish the tie. \end_layout \begin_layout Description Syntax accent-tie \end_layout \begin_layout Subsection* accent-tilde \end_layout \begin_layout Description Action Adds a tilde over the next character typed. \end_layout \begin_layout Description Syntax accent-tilde \end_layout \begin_layout Subsection* accent-umlaut \end_layout \begin_layout Description Action Adds an umlaut over the next character typed. \end_layout \begin_layout Description Syntax accent-umlaut \end_layout \begin_layout Subsection* accent-underbar \end_layout \begin_layout Description Action Adds a bar under the next character typed. \end_layout \begin_layout Description Syntax accent-underbar \end_layout \begin_layout Subsection* accent-underdot \end_layout \begin_layout Description Action Adds a dot under the next character typed. \end_layout \begin_layout Description Syntax accent-underdot \end_layout \begin_layout Subsection* all-changes-accept \end_layout \begin_layout Description Action Accepts all tracked changes in the document. \end_layout \begin_layout Description Syntax all-changes-accept \end_layout \begin_layout Description Origin Levon, 16 Oct 2002 \end_layout \begin_layout Subsection* all-changes-reject \end_layout \begin_layout Description Action Rejects all tracked changes in the document. \end_layout \begin_layout Description Notion Reject does not work recursively; the user may have to repeat the operation. \end_layout \begin_layout Description Syntax all-changes-reject \end_layout \begin_layout Description Origin Levon, 16 Oct 2002 \end_layout \begin_layout Subsection* appendix \end_layout \begin_layout Description Action Start (or remove) Appendix on the given cursor position. \end_layout \begin_layout Description Syntax appendix \end_layout \begin_layout Description Origin ettrich, 5 May 1998 \end_layout \begin_layout Subsection* argument-insert \end_layout \begin_layout Description Action Inserts an argument (short title) inset. \end_layout \begin_layout Description Syntax argument-insert \end_layout \begin_layout Description Params : see layout declarations \end_layout \begin_layout Description Origin vermeer, 12 Aug 2002 \end_layout \begin_layout Subsection* bibtex-database-add \end_layout \begin_layout Description Action Adds database, which will be used for bibtex citations. \end_layout \begin_layout Description Notion Databases are added to the first BibTeX inset (Inset->List/TOC->BibTeX bibliography) found from the cursor position. \end_layout \begin_layout Description Syntax bibtex-database-add \end_layout \begin_layout Description Origin Ale, 30 May 1997 \end_layout \begin_layout Subsection* bibtex-database-del \end_layout \begin_layout Description Action Adds database, which will be used for bibtex citations. \end_layout \begin_layout Description Notion Databases are deleted from the first BibTeX inset (Inset->List/TOC->BibTeX bibliography) found from the cursor position. \end_layout \begin_layout Description Syntax bibtex-database-del \end_layout \begin_layout Description Origin Ale, 30 May 1997 \end_layout \begin_layout Subsection* bookmark-clear \end_layout \begin_layout Description Action Clears the list of saved bookmarks. \end_layout \begin_layout Description Syntax bookmark-clear \end_layout \begin_layout Description Origin bpeng, 31 October 2006 \end_layout \begin_layout Subsection* bookmark-goto \end_layout \begin_layout Description Action Moves the cursor to the numbered bookmark, opening the file if necessary. Note that bookmarks are saved per-session, not per file. \end_layout \begin_layout Description Notion Bookmark 0 has a special purpose. It is automatically set \begin_inset Newline newline \end_inset 1. to the paragraph you are currently editing \begin_inset Newline newline \end_inset 2. to the paragraph from where you are jumping to the last-edited position (jump-back feature) \begin_inset Newline newline \end_inset 3. when jumping from crossreference to the requested label by LFUN_LABEL_GOTO. \end_layout \begin_layout Description Syntax bookmark-goto \end_layout \begin_layout Description Params : the number of the bookmark to restore. \end_layout \begin_layout Description Origin Dekel, 27 January 2001 \end_layout \begin_layout Subsection* bookmark-save \end_layout \begin_layout Description Action Save a bookmark. \end_layout \begin_layout Description 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. \end_layout \begin_layout Description Syntax bookmark-save \end_layout \begin_layout Description Params : the number of the bookmark to save. \end_layout \begin_layout Description Origin Dekel, 27 January 2001 \end_layout \begin_layout Subsection* box-insert \end_layout \begin_layout Description Action Inserts Box inset. \end_layout \begin_layout Description Syntax box-insert [] \end_layout \begin_layout Description Params : Boxed|Frameless|Framed|ovalbox|Ovalbox|Shadowbox|Shaded|Doublebox \begin_inset Newline newline \end_inset Framed is the default one. \end_layout \begin_layout Description Origin vermeer, 7 Oct 2003 \end_layout \begin_layout Subsection* branch-insert \end_layout \begin_layout Description Action Inserts branch inset. \end_layout \begin_layout Description Syntax branch-insert \end_layout \begin_layout Description Origin vermeer, 17 Aug 2003 \end_layout \begin_layout Subsection* buffer-begin \end_layout \begin_layout Description Action Move the cursor to the beginning of the document. \end_layout \begin_layout Description Syntax buffer-begin \end_layout \begin_layout Subsection* buffer-begin-select \end_layout \begin_layout Description Action Move the cursor to the beginning of the document adding the traversed text to the selection. \end_layout \begin_layout Description Syntax buffer-begin-select \end_layout \begin_layout Subsection* buffer-end \end_layout \begin_layout Description Action Move the cursor to the end of the document. \end_layout \begin_layout Description Syntax buffer-end \end_layout \begin_layout Subsection* buffer-end-select \end_layout \begin_layout Description Action Move the cursor to the end of the document adding the traversed text to the selection. \end_layout \begin_layout Description Syntax buffer-end-select \end_layout \begin_layout Subsection* caption-insert \end_layout \begin_layout Description Action Inserts a caption inset. \end_layout \begin_layout Description Syntax caption-insert \end_layout \begin_layout Description Origin Lgb, 18 Jul 2000 \end_layout \begin_layout Subsection* cell-backward \end_layout \begin_layout Description Action Moves the cursor to the previous cell inside the table. \end_layout \begin_layout Description Syntax cell-backward \end_layout \begin_layout Description Origin Jug, 22 May 2000 \end_layout \begin_layout Subsection* cell-forward \end_layout \begin_layout Description Action Moves the cursor to the next cell inside the table. \end_layout \begin_layout Description Syntax cell-forward \end_layout \begin_layout Subsection* cell-split \end_layout \begin_layout Description Action Splits cell and shifts right part to the next cell (inside the math grid). \end_layout \begin_layout Description Syntax cell-split \end_layout \begin_layout Description Origin Ale, 15 May 1997 \end_layout \begin_layout Subsection* change-accept \end_layout \begin_layout Description Action Accepts tracked change inside the selection. \end_layout \begin_layout Description Syntax change-accept \end_layout \begin_layout Description Origin Levon, 16 Oct 2002 \end_layout \begin_layout Subsection* change-next \end_layout \begin_layout Description Action Moves the cursor to the position of the next change of the change tracking records. \end_layout \begin_layout Description Syntax change-next \end_layout \begin_layout Description Origin schmitt, 4 Oct 2006 \end_layout \begin_layout Subsection* change-previous \end_layout \begin_layout Description Action Moves the cursor to the position of the previous change of the change tracking records. \end_layout \begin_layout Description Syntax change-previous \end_layout \begin_layout Description Origin vfr, 4 Apr 2009 \end_layout \begin_layout Subsection* change-reject \end_layout \begin_layout Description Action Rejects tracked change inside the selection. \end_layout \begin_layout Description Syntax change-reject \end_layout \begin_layout Description Origin Levon, 16 Oct 2002 \end_layout \begin_layout Subsection* changes-merge \end_layout \begin_layout Description Action Open change tracking dialog for merging and moves the cursor to the position of the next change. \end_layout \begin_layout Description Syntax changes-merge \end_layout \begin_layout Description Origin Levon, 16 Oct 2002 \end_layout \begin_layout Subsection* changes-output \end_layout \begin_layout Description Action Toggles showing of change tracking in typeset output. \end_layout \begin_layout Description Syntax changes-output \end_layout \begin_layout Description Origin jspitzm, 21 Jan 2005 \end_layout \begin_layout Subsection* changes-track \end_layout \begin_layout Description Action Toggles change tracking to on/off. \end_layout \begin_layout Description Syntax changes-track \end_layout \begin_layout Description Origin levon, 1 Oct 2002 \end_layout \begin_layout Subsection* char-backward \end_layout \begin_layout Description Action Moves the cursor one position logically backwards. \end_layout \begin_layout Description 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. \end_layout \begin_layout Description Syntax char-backward \end_layout \begin_layout Subsection* char-backward-select \end_layout \begin_layout Description Action Moves the cursor one position logically backwards, adding traversed position to the selection. \end_layout \begin_layout Description Notion See also LFUN_CHAR_BACKWARD. \end_layout \begin_layout Description Syntax char-backward-select \end_layout \begin_layout Subsection* char-delete-backward \end_layout \begin_layout Description Action Deletes one character in the backward direction (usually the "BackSpace" key). \end_layout \begin_layout Description Syntax char-delete-backward \end_layout \begin_layout Subsection* char-delete-forward \end_layout \begin_layout Description Action Deletes one character in the backward direction (usually the "Delete" key). \end_layout \begin_layout Description Syntax char-delete-forward \end_layout \begin_layout Subsection* char-forward \end_layout \begin_layout Description Action Moves the cursor one position logically forward. \end_layout \begin_layout Description 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. \end_layout \begin_layout Description Syntax char-forward \end_layout \begin_layout Subsection* char-forward-select \end_layout \begin_layout Description Action Moves the cursor one position logically forward, adding traversed position to the selection. \end_layout \begin_layout Description Notion See also LFUN_CHAR_FORWARD. \end_layout \begin_layout Description Syntax char-forward-select \end_layout \begin_layout Subsection* char-left \end_layout \begin_layout Description Action Moves the cursor one position "to the left". \end_layout \begin_layout Description 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. \end_layout \begin_layout Description Syntax char-left \end_layout \begin_layout Subsection* char-left-select \end_layout \begin_layout Description Action Moves the cursor one position "to the left", adding traversed position to the selection. \end_layout \begin_layout Description Notion See also LFUN_CHAR_LEFT for exact details of the movement. \end_layout \begin_layout Description Syntax char-left-select \end_layout \begin_layout Subsection* char-right \end_layout \begin_layout Description Action Moves the cursor one position "to the right". \end_layout \begin_layout Description 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. \end_layout \begin_layout Description Syntax char-right \end_layout \begin_layout Subsection* char-right-select \end_layout \begin_layout Description Action Moves the cursor one position "to the right", adding traversed position to the selection. \end_layout \begin_layout Description Notion See also LFUN_CHAR_RIGHT for exact details of the movement. \end_layout \begin_layout Description Syntax char-right-select \end_layout \begin_layout Subsection* chars-transpose \end_layout \begin_layout Description Action Transposes the character at the cursor with the one before it. \end_layout \begin_layout Description Syntax chars-transpose \end_layout \begin_layout Description Origin Lgb, 25 Apr 2001 \end_layout \begin_layout Subsection* citation-insert \end_layout \begin_layout Description Action Inserts citation from loaded citation database. \end_layout \begin_layout Description Syntax citation-insert [[|]] \end_layout \begin_layout Description Params : Citation (shortcut listed in available citations). \begin_inset Newline newline \end_inset : text which should appear before citation. \end_layout \begin_layout Description Origin AAS, 97-02-23 \end_layout \begin_layout Subsection* clipboard-paste \end_layout \begin_layout Description Action Pastes text from the active clipboard (retains formatting if the clipboard contains formatted text). Pastes plain text if plain text is on the clipboard, but tries to interpret it in special ways for certain insets, e.g. converting csv data to rows and columns if the paste happens in a tabular inset. \end_layout \begin_layout Description 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. \end_layout \begin_layout Description Syntax clipboard-paste [] \end_layout \begin_layout Description Params : "paragraph" will cause pasting as one paragraph, i.e. "Join lines". \end_layout \begin_layout Description Origin Georg, 10 Jul 2006 \end_layout \begin_layout Subsection* clipboard-paste-simple \end_layout \begin_layout Description Action Pastes plain text from the active clipboard even if formatted LyX content is in the clipboard. Pastes plain text if plain text is on the clipboard, without trying to interpret it in special ways for certain insets, e.g. converting csv data to rows and columns if the paste happens in a tabular inset. \end_layout \begin_layout Description Syntax clipboard-paste-simple [] \end_layout \begin_layout Description Params : "paragraph" will cause pasting as one paragraph, i.e. "Join lines". \end_layout \begin_layout Subsection* command-execute \end_layout \begin_layout Description Action Switches the focus to the minibuffer so that the user can type in there. If necessary, it opens the minibuffer toolbar. \end_layout \begin_layout Description Notion Usually bound to M-x shortcut. \end_layout \begin_layout Description Syntax command-execute \end_layout \begin_layout Subsection* complete \end_layout \begin_layout Description Action Try to complete the word or command at the cursor position. \end_layout \begin_layout Description Syntax complete \end_layout \begin_layout Description Origin sts, Feb 19 2008 \end_layout \begin_layout Subsection* completion-accept \end_layout \begin_layout Description Action Accept suggested completion. \end_layout \begin_layout Description Syntax completion-accept \end_layout \begin_layout Description Origin sanda, Sep 08 2008 \end_layout \begin_layout Subsection* completion-cancel \end_layout \begin_layout Description Action Try to cancel completion, either the popup or the inline completion. \end_layout \begin_layout Description Syntax completion-cancel \end_layout \begin_layout Description Origin sts, Sep 07 2008 \end_layout \begin_layout Subsection* completion-inline \end_layout \begin_layout Description Action Show the inline completion at the cursor position. \end_layout \begin_layout Description Syntax completion-inline \end_layout \begin_layout Description Origin sts, Feb 19 2008 \end_layout \begin_layout Subsection* completion-popup \end_layout \begin_layout Description Action Show the completion popup at the cursor position. \end_layout \begin_layout Description Syntax completion-popup \end_layout \begin_layout Description Origin sts, Feb 19 2008 \end_layout \begin_layout Subsection* copy \end_layout \begin_layout Description Action Copies the current selection to the clipboard. \end_layout \begin_layout Description Syntax copy \end_layout \begin_layout Subsection* cut \end_layout \begin_layout Description Action Cuts to the clipboard. \end_layout \begin_layout Description Syntax cut \end_layout \begin_layout Subsection* date-insert \end_layout \begin_layout Description Action Inserts the current date. \end_layout \begin_layout Description Syntax date-insert [] \end_layout \begin_layout Description Params : Format of date. The default value (%x) can be set in Preferences->Date format. For possible formats see manual page of strftime function. \end_layout \begin_layout Description Origin jdblair, 31 Jan 2000 \end_layout \begin_layout Subsection* depth-decrement \end_layout \begin_layout Description Action Decrease the nesting depth of the (selected) paragraph(s) inside lists. \end_layout \begin_layout Description Syntax depth-decrement \end_layout \begin_layout Subsection* depth-increment \end_layout \begin_layout Description Action Increase the nesting depth of the (selected) paragraph(s) inside lists. \end_layout \begin_layout Description Syntax depth-increment \end_layout \begin_layout Subsection* dialog-disconnect-inset \end_layout \begin_layout Description Action Closes opened connection to opened inset. \end_layout \begin_layout Description Notion Connection is used for apply functions. \end_layout \begin_layout Description Syntax dialog-disconnect-inset \end_layout \begin_layout Description Origin leeming, 25 Feb 2003 \end_layout \begin_layout Subsection* dialog-hide \end_layout \begin_layout Description Action Hides showed dialog. Counterpart to LFUN_DIALOG_SHOW . \end_layout \begin_layout Description Syntax dialog-hide \end_layout \begin_layout Description Params See LFUN_DIALOG_SHOW . \end_layout \begin_layout Description Origin leeming, 25 Feb 2003 \end_layout \begin_layout Subsection* dialog-show \end_layout \begin_layout Description Action Shows hidden dialog or creates new one for a given function/inset settings etc. \end_layout \begin_layout Description Syntax dialog-show [] \end_layout \begin_layout Description Params : aboutlyx|bibitem|bibtex|box|branch|changes|character|citation| \begin_inset Newline newline \end_inset compare|document|errorlist|ert|external|file|findreplace|findreplaceadv|float| \begin_inset Newline newline \end_inset graphics|href|include|index|index_print|info|label|line|listings|log|mathdelimiter| \begin_inset Newline newline \end_inset mathmatrix|mathspace|nomenclature|nomencl_print|note|paragraph|phantom|prefs| \begin_inset Newline newline \end_inset print|ref|sendto|space|spellchecker|symbols|tabular|tabularcreate| \begin_inset Newline newline \end_inset thesaurus|texinfo|toc|view-source|vspace|wrap| \begin_inset Newline newline \end_inset : latexlog|vclog \begin_inset Newline newline \end_inset : data, usually settings for the given dialog. Use debug mode for the details. \end_layout \begin_layout Description Origin leeming, 17 Jun 2003 \end_layout \begin_layout Subsection* dialog-show-new-inset \end_layout \begin_layout Description Action Shows hidden dialog or create new one for a given inset settings etc. \end_layout \begin_layout Description Notion Internally uses LFUN_DIALOG_SHOW with processed data for a given inset. \end_layout \begin_layout Description Syntax dialog-show-new-inset [] \end_layout \begin_layout Description Params See LFUN_DIALOG_SHOW . \end_layout \begin_layout Description Origin leeming, 25 Feb 2003 \end_layout \begin_layout Subsection* dialog-toggle \end_layout \begin_layout Description Action Toggles dialog between showed/hidden state. \end_layout \begin_layout Description Notion Internally uses LFUN_DIALOG_SHOW , LFUN_DIALOG_HIDE . \end_layout \begin_layout Description Syntax dialog-toggle [] \end_layout \begin_layout Description Params See LFUN_DIALOG_SHOW . \end_layout \begin_layout Description Origin JSpitzm, 30 Apr 2007 \end_layout \begin_layout Subsection* dialog-update \end_layout \begin_layout Description Action Updates the dialog values from the inset/paragraph/document. \end_layout \begin_layout Description Syntax dialog-update \end_layout \begin_layout Description Params : paragraph|prefs| \begin_inset Newline newline \end_inset : inset name \end_layout \begin_layout Description Origin leeming, 25 Feb 2003 \end_layout \begin_layout Subsection* down \end_layout \begin_layout Description Action Moves the cursor one line in downward direction. \end_layout \begin_layout Description Syntax down \end_layout \begin_layout Subsection* down-select \end_layout \begin_layout Description Action Moves the cursor one line in downward direction adding the current position to the selection. \end_layout \begin_layout Description Syntax down-select \end_layout \begin_layout Subsection* ert-insert \end_layout \begin_layout Description Action Inserts an ERT inset. \end_layout \begin_layout Description Syntax ert-insert \end_layout \begin_layout Description Origin Jug, 18 Feb 2000 \end_layout \begin_layout Subsection* escape \end_layout \begin_layout Description Action Clears the selection. If no text is selected call LFUN_FINISHED_FORWARD. Inside math mode jumps out of the math inset. \end_layout \begin_layout Description Syntax escape \end_layout \begin_layout Description Origin Lgb, 17 May 2001 \end_layout \begin_layout Subsection* file-insert \end_layout \begin_layout Description Action Inserts another LyX file. \end_layout \begin_layout Description Syntax file-insert [] \end_layout \begin_layout Description Params : Filename to be inserted. \end_layout \begin_layout Subsection* file-insert-plaintext \end_layout \begin_layout Description Action Inserts plain text file. \end_layout \begin_layout Description Syntax file-insert-plaintext [] \end_layout \begin_layout Description Params : Filename to be inserted. \end_layout \begin_layout Description Origin CFO-G, 19 Nov 1997 \end_layout \begin_layout Subsection* file-insert-plaintext-para \end_layout \begin_layout Description Action Inserts plain text file as paragraph (i.e. join lines). \end_layout \begin_layout Description Syntax file-insert-plaintext-para [] \end_layout \begin_layout Description Params : Filename to be inserted. \end_layout \begin_layout Description Origin Levon, 14 Feb 2001 \end_layout \begin_layout Subsection* flex-insert \end_layout \begin_layout Description Action Inserts CharStyle, Custom inset or XML short element. \end_layout \begin_layout Description Notion Look into the Customization manual for more information about these elements. \begin_inset Newline newline \end_inset 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. \begin_inset Newline newline \end_inset For dissolving the element see LFUN_INSET_DISSOLVE. \end_layout \begin_layout Description Syntax flex-insert Name \end_layout \begin_layout Description Params Name: This name must be defined either in your layout file or imported by some module. The definition is InsetLayout Name or InsetLayout . The Flex: prefix is optional. \end_layout \begin_layout Description Sample flex-insert Code \end_layout \begin_layout Subsection* float-insert \end_layout \begin_layout Description Action Inserts a float inset. \end_layout \begin_layout Description Syntax float-insert \end_layout \begin_layout Description Params : type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given. \end_layout \begin_layout Description Origin Lgb, 27 Jun 2000 \end_layout \begin_layout Subsection* float-list-insert \end_layout \begin_layout Description Action Inserts the list of floats in the document. \end_layout \begin_layout Description Syntax float-list-insert \end_layout \begin_layout Description Params : type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given. \end_layout \begin_layout Description Origin Lgb, 3 May 2001 \end_layout \begin_layout Subsection* float-wide-insert \end_layout \begin_layout Description Action Inserts float insets as in LFUN_FLOAT_INSERT but span multiple columns. \end_layout \begin_layout Description Notion Corresponds to the starred floats (figure*, table*, etc.) in LaTeX. \end_layout \begin_layout Description Syntax float-wide-insert \end_layout \begin_layout Description Params : type of float depends on the used textclass. Usually "algorithm", "table", "figure" parameters can be given. \end_layout \begin_layout Description Origin Lgb, 31 Oct 2001 \end_layout \begin_layout Subsection* footnote-insert \end_layout \begin_layout Description Action Inserts a footnote inset. \end_layout \begin_layout Description Syntax footnote-insert \end_layout \begin_layout Description Origin Jug, 7 Mar 2000 \end_layout \begin_layout Subsection* graphics-reload \end_layout \begin_layout Description Action Reloads the image if necessary. \end_layout \begin_layout Description Syntax graphics-reload \end_layout \begin_layout Description Origin vfr, 10 Aug 2009 \end_layout \begin_layout Subsection* href-insert \end_layout \begin_layout Description Action Inserts hyperlinks into the document (clickable in pdf output). \end_layout \begin_layout Description Notion Hyperlink target can be set via selection + hyperlink-insert function. \end_layout \begin_layout Description Syntax href-insert [] \end_layout \begin_layout Description Origin CFO-G, 21 Nov 1997 \end_layout \begin_layout Subsection* in-ipa \end_layout \begin_layout Description Action Only active in IPA inset. \end_layout \begin_layout Description 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. \end_layout \begin_layout Description Syntax in-ipa \end_layout \begin_layout Description Origin spitz, 20 May 2012 \end_layout \begin_layout Subsection* index-insert \end_layout \begin_layout Description Action Inserts Index entry. \end_layout \begin_layout Description Notion It automatically takes the word on the cursor position. \end_layout \begin_layout Description Syntax index-insert [] \end_layout \begin_layout Description Params : name of the index, if multiple indices are defined. With an empty argument, the default index is selected. \end_layout \begin_layout Description Origin leeming, 3 Aug 2000 \end_layout \begin_layout Subsection* index-print \end_layout \begin_layout Description Action Inserts list of Index entries on a new page. \end_layout \begin_layout Description Syntax index-print [] \end_layout \begin_layout Description Params : name of the index, if multiple indices are defined. With an empty argument, the default index is selected. \end_layout \begin_layout Description Origin Lgb, 27 Feb 1997 \end_layout \begin_layout Subsection* info-insert \end_layout \begin_layout Description Action Displays shortcuts, lyxrc, package and textclass availability and menu information in a non-editable boxed InsetText. \end_layout \begin_layout Description Notion Apart from lfun arguments you can use the following method: \begin_inset Newline newline \end_inset 1. input the type and argument of this inset, e.g. "menu paste", in the work area. \begin_inset Newline newline \end_inset 2. select the text and run info-insert lfun. \end_layout \begin_layout Description Syntax info-insert \end_layout \begin_layout Description Params : shortcut[s]|lyxrc|lyxinfo|package|textclass|menu|buffer \begin_inset Newline newline \end_inset : argument for a given type. Look into InsetInfo.h for detailed description. \begin_inset Newline newline \end_inset shortcut[s]: name of lfun (e.g math-insert \backslash alpha) \begin_inset Newline newline \end_inset lyxrc: name of rc_entry (e.g. bind_file) \begin_inset Newline newline \end_inset lyxinfo: "version" - used version of LyX \begin_inset Newline newline \end_inset package: name of latex package (e.g. listings) \begin_inset Newline newline \end_inset textclass: name of textclass (e.g. article) \begin_inset Newline newline \end_inset menu: name of lfun used in menu \begin_inset Newline newline \end_inset icon: icon of lfun used in toolbar or direct icon name \begin_inset Newline newline \end_inset buffer: "name"|"path"|"class"|"vcs-tree-revision"| "vcs-revision"|"vcs-author"|"vcs-date"|"vcs-time" \end_layout \begin_layout Description Sample command-sequence info-insert buffer path; info-insert buffer name \end_layout \begin_layout Description Origin bpeng, 7 Oct 2007 \end_layout \begin_layout Subsection* inset-apply \end_layout \begin_layout Description Action Apply data for an inset. \end_layout \begin_layout Description 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. \end_layout \begin_layout Description Syntax inset-apply \end_layout \begin_layout Description Params See LFUN_INSET_INSERT . \end_layout \begin_layout Subsection* inset-begin \end_layout \begin_layout Description 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 \end_layout \begin_layout Description Syntax inset-begin \end_layout \begin_layout Description Origin lasgouttes, 16 Mar 2009 \end_layout \begin_layout Subsection* inset-begin-select \end_layout \begin_layout Description 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). \end_layout \begin_layout Description Syntax inset-begin-select \end_layout \begin_layout Description Origin lasgouttes, 16 Mar 2009 \end_layout \begin_layout Subsection* inset-copy-as \end_layout \begin_layout Description Action Copies the inset to the clipboard as a certain type. \end_layout \begin_layout Description Notion Currently used only for InsetInfo where its content is copied as a text. \end_layout \begin_layout Description Syntax inset-copy-as \end_layout \begin_layout Description Origin vfr, 18 Apr 2010 \end_layout \begin_layout Subsection* inset-dissolve \end_layout \begin_layout Description Action Dissolve the current inset into text. \end_layout \begin_layout Description Syntax inset-dissolve [] \end_layout \begin_layout Description Params : 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. \begin_inset Newline newline \end_inset For values see lyx::InsetLayout::lyxtype_ . \end_layout \begin_layout Description Origin JSpitz, 7 Aug 2006 \end_layout \begin_layout Subsection* inset-edit \end_layout \begin_layout Description Action Edit the inset at cursor with an external application, if one is attributed. \end_layout \begin_layout Description Syntax inset-edit [] \end_layout \begin_layout Description Params : Parameters for the inset. \begin_inset Newline newline \end_inset Currently only the filename will be considered. \end_layout \begin_layout Description Origin JSpitzm, 27 Apr 2006 \end_layout \begin_layout Subsection* inset-end \end_layout \begin_layout Description 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 \end_layout \begin_layout Description Syntax inset-end \end_layout \begin_layout Description Origin lasgouttes, 16 Mar 2009 \end_layout \begin_layout Subsection* inset-end-select \end_layout \begin_layout Description 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). \end_layout \begin_layout Description Syntax inset-end-select \end_layout \begin_layout Description Origin lasgouttes, 16 Mar 2009 \end_layout \begin_layout Subsection* inset-forall \end_layout \begin_layout Description Action Apply the given commands on insets of a given name. \end_layout \begin_layout Description 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. \end_layout \begin_layout Description Syntax inset-forall \begin_inset Newline newline \end_inset : Type of Inset. If 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. \end_layout \begin_layout Description Sample Remove all index insets: \begin_inset Newline newline \end_inset inset-forall Index char-delete-forward \begin_inset Newline newline \end_inset Close all Notes (also works for a particular branch, for example): \begin_inset Newline newline \end_inset inset-forall Note inset-toggle close \begin_inset Newline newline \end_inset Transform all yellow notes to comments \begin_inset Newline newline \end_inset inset-forall Note:Note inset-modify note Note Comment \begin_inset Newline newline \end_inset Try to put LyX in an infinite loop if there is at least a Note: \begin_inset Newline newline \end_inset inset-forall Note char-backward \end_layout \begin_layout Description Origin lasgouttes, 27 Nov 2009 \end_layout \begin_layout Subsection* inset-insert \end_layout \begin_layout Description Action Insert new inset (type given by the parameters). \end_layout \begin_layout Description Syntax inset-insert \end_layout \begin_layout Description Params : \begin_inset Newline newline \end_inset : depends on the given inset. Use "lyx -dbg action" to explore. \end_layout \begin_layout Description Sample inset-insert ref LatexCommand reference "