]> git.lyx.org Git - lyx.git/blobdiff - src/LyXAction.cpp
LFUN_TOGGLE_CURSOR_FOLLOWS_SCROLLBAR -> LFUN_CURSOR_FOLLOWS_SCROLLBAR_TOGGLE.
[lyx.git] / src / LyXAction.cpp
index ddcd6efdcacf01437ad3160fc354af66080c341b..3deb55bb892c9f92afd74f5fdbbd614479e24aae 100644 (file)
@@ -1,4 +1,4 @@
-/**
+/*!
  * \file LyXAction.cpp
  * This file is part of LyX, the document processor.
  * Licence details can be found in the file COPYING.
@@ -15,9 +15,9 @@
 
 #include "LyXAction.h"
 
-#include "support/debug.h"
 #include "FuncRequest.h"
 
+#include "support/debug.h"
 #include "support/lstrings.h"
 
 #include <boost/assert.hpp>
@@ -55,7 +55,7 @@ namespace lyx {
  * and put in <BRACKETS>, as so.
  */
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_
  * \li Action: 
  * \li Notion: 
@@ -63,6 +63,7 @@ namespace lyx {
  * \li Params: 
  * \li Sample:
  * \li Origin: 
+ * \endvar
  */
 
 LyXAction lyxaction;
@@ -103,230 +104,278 @@ void LyXAction::init()
 
        ev_item const items[] = {
 #endif
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_ACUTE
  * \li Action: Adds an acute accent \htmlonly (&aacute;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-acute
+ * \endvar
  */
                { LFUN_ACCENT_ACUTE, "accent-acute", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_BREVE
  * \li Action: Adds a breve accent \htmlonly (&#259;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-breve
+ * \endvar
  */
                { LFUN_ACCENT_BREVE, "accent-breve", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_CARON
  * \li Action: Adds a caron \htmlonly (&#462;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-caron
+ * \endvar
  */
                { LFUN_ACCENT_CARON, "accent-caron", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_CEDILLA
  * \li Action: Adds a cedilla \htmlonly (&ccedil;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-cedilla
+ * \endvar
  */
                { LFUN_ACCENT_CEDILLA, "accent-cedilla", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_CIRCLE
  * \li Action: Adds a circle accent \htmlonly (&aring;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-circle
+ * \endvar
  */
                { LFUN_ACCENT_CIRCLE, "accent-circle", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_CIRCUMFLEX
  * \li Action: Adds a circumflex \htmlonly (&ecirc;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-circumflex
+ * \endvar
  */
                { LFUN_ACCENT_CIRCUMFLEX, "accent-circumflex", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_DOT
  * \li Action: Adds a dot accent \htmlonly (&#380;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-dot
+ * \endvar
  */
                { LFUN_ACCENT_DOT, "accent-dot", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_GRAVE
  * \li Action: Adds a grave accent \htmlonly (&egrave;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-grave
+ * \endvar
  */
                { LFUN_ACCENT_GRAVE, "accent-grave", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_HUNGARIAN_UMLAUT
  * \li Action: Adds a Hungarian umlaut \htmlonly (&#337;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-grave
+ * \endvar
  */
                { LFUN_ACCENT_HUNGARIAN_UMLAUT, "accent-hungarian-umlaut", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_MACRON
  * \li Action: Adds a macron \htmlonly (&#257;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-macron
+ * \endvar
  */
                { LFUN_ACCENT_MACRON, "accent-macron", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_OGONEK
  * \li Action: Adds an ogonek accent \htmlonly (&#261;)\endhtmlonly
                to the next character typed.
  * \li Syntax: accent-ogonek
+ * \endvar
  */
                { LFUN_ACCENT_OGONEK, "accent-ogonek", Noop, Edit },
                { LFUN_ACCENT_SPECIAL_CARON, "accent-special-caron", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_TIE
  * \li Action: Adds a tie \htmlonly (a&#865;)\endhtmlonly
                over the next two character typed.
  * \li Notion: the following char will finish the tie.
  * \li Syntax: accent-tie
+ * \endvar
  */
                { LFUN_ACCENT_TIE, "accent-tie", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_TILDE
  * \li Action: Adds a tilde \htmlonly (&atilde;)\endhtmlonly
                over the next character typed.
  * \li Syntax: accent-tilde
+ * \endvar
  */
                { LFUN_ACCENT_TILDE, "accent-tilde", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_UMLAUT
  * \li Action: Adds an umlaut \htmlonly (&auml;)\endhtmlonly
                over the next character typed.
  * \li Syntax: accent-umlaut
+ * \endvar
  */
                { LFUN_ACCENT_UMLAUT, "accent-umlaut", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_UNDERBAR
  * \li Action: Adds a bar \htmlonly (a&#800;)\endhtmlonly
                under the next character typed.
  * \li Syntax: accent-underbar
+ * \endvar
  */
                { LFUN_ACCENT_UNDERBAR, "accent-underbar", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ACCENT_UNDERDOT
  * \li Action: Adds a dot \htmlonly (&#7841;)\endhtmlonly
                under the next character typed.
  * \li Syntax: accent-underdot
+ * \endvar
  */
                { LFUN_ACCENT_UNDERDOT, "accent-underdot", Noop, Edit },
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BREAK_PARAGRAPH
  * \li Action: Breaks the current paragraph at the current location.
  * \li Syntax: break-paragraph
+ * \endvar
  */
                { LFUN_BREAK_PARAGRAPH, "break-paragraph", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BREAK_PARAGRAPH_SKIP
  * \li Action: Breaks the current paragraph at the current location,
                unless used at the beginning of a line, where it sets
                the label width string to empty.
  * \li Syntax: break-paragraph-skip
+ * \endvar
  */
                { LFUN_BREAK_PARAGRAPH_SKIP, "break-paragraph-skip", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CAPTION_INSERT
  * \li Action: Inserts a caption inset.
  * \li Syntax: caption-insert
  * \li Origin: Lgb, 18 Jul 2000
+ * \endvar
  */
                { LFUN_CAPTION_INSERT, "caption-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_DATE_INSERT
  * \li Action: Inserts the current date.
  * \li Syntax: date-insert [<ARG>]
- * \li Param: <ARG>: Format of date. The default value (%x) can be set
+ * \li 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.
  * \li Origin: jdblair, 31 Jan 2000
+ * \endvar
  */
                { LFUN_DATE_INSERT, "date-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_FOOTNOTE_INSERT
  * \li Action: Inserts a footnote inset.
  * \li Syntax: footnote-insert
  * \li Origin: Jug, 7 Mar 2000
+ * \endvar
  */
                { LFUN_FOOTNOTE_INSERT, "footnote-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_ERT_INSERT
  * \li Action: Inserts an ERT inset.
  * \li Syntax: ert-insert
  * \li Origin: Jug, 18 Feb 2000
+ * \endvar
  */
                { LFUN_ERT_INSERT, "ert-insert", Noop, Edit },
                { LFUN_FLOAT_INSERT, "float-insert", Noop, Edit },
                { LFUN_FLOAT_WIDE_INSERT, "float-wide-insert", Noop, Edit },
                { LFUN_WRAP_INSERT, "wrap-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_HFILL_INSERT
  * \li Action: Inserts an hfill inset.
  * \li Syntax: hfill-insert
+ * \endvar
  */
                { LFUN_HFILL_INSERT, "hfill-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_OPTIONAL_INSERT
  * \li Action: Inserts an optional-argument (short title) inset.
  * \li Syntax: optional-insert
  * \li Origin: Martin, 12 Aug 2002
+ * \endvar
  */
                { LFUN_OPTIONAL_INSERT, "optional-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LINE_INSERT
  * \li Action: Inserts a horizontal line.
  * \li Syntax: line-insert
  * \li Origin: poenitz,  Oct 27 2003
+ * \endvar
  */
                { LFUN_LINE_INSERT, "line-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_NEWPAGE_INSERT
  * \li Action: Inserts a new page.
  * \li Syntax: newpage-insert
  * \li Origin: uwestoehr, 24 Nov 2007
+ * \endvar
  */
                { LFUN_NEWPAGE_INSERT, "newpage-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_PAGEBREAK_INSERT
  * \li Action: Inserts a pagebreak.
  * \li Syntax: pagebreak-insert
  * \li Origin: poenitz,  Oct 27 2003
+ * \endvar
  */
                { LFUN_PAGEBREAK_INSERT, "pagebreak-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MARGINALNOTE_INSERT
  * \li Action: Inserts a marginal note.
  * \li Syntax: marginalnote-insert
  * \li Origin: Lgb, 26 Jun 2000
+ * \endvar
  */
                { LFUN_MARGINALNOTE_INSERT, "marginalnote-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_UNICODE_INSERT
  * \li Action: Inserts a single unicode character.
  * \li Syntax: unicode-insert <CHAR>
  * \li Params: <CHAR>: The character to insert, given as its code
                        point, in hexadecimal, e.g.: unicode-insert 0x0100.
  * \li Origin: Lgb, 22 Oct 2006
+ * \endvar
  */
                { LFUN_UNICODE_INSERT, "unicode-insert", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LISTING_INSERT
  * \li Action: Inserts a new listings inset.
  * \li Syntax: listing-insert
  * \li Origin: Herbert, 10 Nov 2001; bpeng, 2 May 2007
+ * \endvar
  */
                { LFUN_LISTING_INSERT, "listing-insert", Noop, Edit },
                { LFUN_QUOTE_INSERT, "quote-insert", Noop, Edit },
                { LFUN_INFO_INSERT, "info-insert", Noop, Edit },
                { LFUN_BRANCH_INSERT, "branch-insert", Noop, Edit },
                { LFUN_BOX_INSERT, "box-insert", Noop, Edit },
+/*!
+ * \var lyx::kb_action lyx::LFUN_FLEX_INSERT
+ * \li Action: Inserts CharStyle, Custom inset or XML short element.
+ * \li Notion: Look into the Customization manual for more information about
+               these elements.\n
+              For dissolving the element see #LFUN_INSET_DISSOLVE.
+ * \li Syntax: flex-insert <TYPE:Name>
+ * \li Params: TYPE: CharStyle|Custom|Element|Standard
+                    Identifies whether this is a Character Style, a
+                    Custom Inset or an XML Element, and which dynamical 
+                    sub-menu this flex inset is in on the LyX menu tree. 
+                    If Standard (currently unused): none of these.
+              Name: This name must be defined either in your layout file
+                    or imported by some module. The definition is\n
+                    InsetLayout <TYPE:Name>
+ * \li Sample: flex-insert CharStyle:Code
+ * \endvar
+ */
                { LFUN_FLEX_INSERT, "flex-insert", Noop, Edit },
                { LFUN_SELF_INSERT, "self-insert", SingleParUpdate, Hidden },
                { LFUN_SPACE_INSERT, "space-insert", Noop, Edit },
@@ -339,7 +388,6 @@ void LyXAction::init()
 
 #if 0
                { LFUN_LIST_INSERT, "list-insert", Noop, Edit },
-               { LFUN_THEOREM_INSERT, "theorem-insert", Noop, Edit },
 #endif
 
                { LFUN_DELETE_BACKWARD_SKIP, "delete-backward-skip", Noop, Edit },
@@ -350,27 +398,29 @@ void LyXAction::init()
                { LFUN_UP_SELECT, "up-select", ReadOnly | SingleParUpdate, Edit },
                { LFUN_SCREEN_DOWN, "screen-down", ReadOnly, Edit },
                { LFUN_SCREEN_DOWN_SELECT, "screen-down-select", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_SCROLL
  * \li Action: Scroll the buffer view.
  * \li Notion: Only scrolls the screen up or down; does not move the cursor.
  * \li Syntax: scroll <TYPE> <QUANTITY>
  * \li Params: <TYPE>:  line|page\n
-               <QUANTITY>: up|down|<number>\n
+               <QUANTITY>: up|down|<number>
  * \li Origin: Abdelrazak Younes, Dec 27 2007
+ * \endvar
  */
                { LFUN_SCROLL, "scroll", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_SCREEN_RECENTER
  * \li Action: Recenters the screen on the current cursor position.
  * \li Syntax: screen-recenter
+ * \endvar
  */
                { LFUN_SCREEN_RECENTER, "screen-recenter", ReadOnly, Edit },
                { LFUN_SCREEN_UP, "screen-up", ReadOnly, Edit },
                { LFUN_SCREEN_UP_SELECT, "screen-up-select", ReadOnly, Edit },
 
                { LFUN_ERROR_NEXT, "error-next", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CHAR_BACKWARD
  * \li Action: Moves the cursor one position logically backwards.
  * \li Notion: This is not the action which should be bound to the arrow keys,
@@ -378,19 +428,21 @@ void LyXAction::init()
                language. The arrow keys should be bound to #LFUN_CHAR_LEFT or
                #LFUN_CHAR_RIGHT actions, which in turn may employ this one.
  * \li Syntax: char-backward
+ * \endvar
  */
                { LFUN_CHAR_BACKWARD, "char-backward", ReadOnly | NoUpdate, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CHAR_BACKWARD_SELECT
  * \li Action: Moves the cursor one position logically backwards, adding
                traversed position to the selection.
  * \li Notion: See also #LFUN_CHAR_BACKWARD.
  * \li Syntax: char-backward-select
+ * \endvar
  */
                { LFUN_CHAR_BACKWARD_SELECT, "char-backward-select", ReadOnly | SingleParUpdate, Edit },
                { LFUN_CHAR_DELETE_BACKWARD, "delete-backward", SingleParUpdate, Edit },
                { LFUN_CHAR_DELETE_FORWARD, "delete-forward", SingleParUpdate, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CHAR_FORWARD
  * \li Action: Moves the cursor one position logically forward.
  * \li Notion: This is not the action which should be bound to the arrow keys,
@@ -398,17 +450,19 @@ void LyXAction::init()
                The arrow keys should be bound to #LFUN_CHAR_LEFT or
                #LFUN_CHAR_RIGHT actions, which in turn may employ this one.
  * \li Syntax: char-forward
+ * \endvar
  */
                { LFUN_CHAR_FORWARD, "char-forward", ReadOnly | NoUpdate, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CHAR_FORWARD_SELECT
  * \li Action: Moves the cursor one position logically forward, adding
                traversed position to the selection.
  * \li Notion: See also #LFUN_CHAR_FORWARD.
  * \li Syntax: char-forward-select
+ * \endvar
  */
                { LFUN_CHAR_FORWARD_SELECT, "char-forward-select", ReadOnly | SingleParUpdate, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CHAR_LEFT
  * \li Action: Moves the cursor one position "to the left".
  * \li Notion: This is the action which should be taken when the "left" key
@@ -419,17 +473,19 @@ void LyXAction::init()
                mode", movement is logically forward in RTL paragraphs, and
                logically backwards in LTR paragraphs.
  * \li Syntax: char-left
+ * \endvar
  */
                { LFUN_CHAR_LEFT, "char-left", ReadOnly | NoUpdate, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CHAR_LEFT_SELECT
  * \li Action: Moves the cursor one position "to the left", adding 
                traversed position to the selection.
  * \li Notion: See also #LFUN_CHAR_LEFT for exact details of the movement.
  * \li Syntax: char-left-select
+ * \endvar
  */
                { LFUN_CHAR_LEFT_SELECT, "char-left-select", ReadOnly | SingleParUpdate, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CHAR_RIGHT
  * \li Action: Moves the cursor one position "to the right".
  * \li Notion: This is the action which should be taken when the "right" key
@@ -440,14 +496,16 @@ void LyXAction::init()
                mode", movement is logically forward in LTR paragraphs, and
                logically backwards in RTL paragraphs.
  * \li Syntax: char-right
+ * \endvar
  */
                { LFUN_CHAR_RIGHT, "char-right", ReadOnly | NoUpdate, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CHAR_RIGHT_SELECT
  * \li Action: Moves the cursor one position "to the right", adding
                traversed position to the selection.
  * \li Notion: See also #LFUN_CHAR_RIGHT for exact details of the movement.
  * \li Syntax: char-right-select
+ * \endvar
  */
                { LFUN_CHAR_RIGHT_SELECT, "char-right-select", ReadOnly | SingleParUpdate, Edit },
 
@@ -469,11 +527,12 @@ void LyXAction::init()
                { LFUN_WORD_UPCASE, "word-upcase", Noop, Edit },
                { LFUN_WORD_FIND, "word-find", ReadOnly, Edit },
                { LFUN_WORD_REPLACE, "word-replace", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_THESAURUS_ENTRY
  * \li Action: Look up thesaurus entries with respect to the word under the cursor.
  * \li Syntax: thesaurus-entry
  * \li Origin: Levon, 20 Jul 2001
+ * \endvar
  */
                { LFUN_THESAURUS_ENTRY, "thesaurus-entry", ReadOnly, Edit },
                { LFUN_BUFFER_BEGIN, "buffer-begin", ReadOnly, Edit },
@@ -489,55 +548,63 @@ void LyXAction::init()
                { LFUN_LINE_END_SELECT, "line-end-select", ReadOnly | SingleParUpdate, Edit },
                { LFUN_NEW_LINE, "new-line", Noop, Edit },
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_PARAGRAPH_MOVE_DOWN
  * \li Action: Moves the current paragraph downwards in the document.
  * \li Syntax: paragraph-move-down
  * \li Origin: Edwin, 8 Apr 2006
+ * \endvar
  */
                { LFUN_PARAGRAPH_MOVE_DOWN, "paragraph-move-down", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_PARAGRAPH_MOVE_UP
  * \li Action: Moves the current paragraph upwards in the document.
  * \li Syntax: paragraph-move-up
  * \li Origin: Edwin, 8 Apr 2006
+ * \endvar
  */
                { LFUN_PARAGRAPH_MOVE_UP, "paragraph-move-up", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_COPY
  * \li Action: Copies to the clipboard the last edit.
  * \li Syntax: copy
+ * \endvar
  */
                { LFUN_COPY, "copy", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CUT
  * \li Action: Cuts to the clipboard.
  * \li Syntax: cut
+ * \endvar
  */
                { LFUN_CUT, "cut", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_PASTE
  * \li Action: Pastes from the active clipboard.
  * \li Syntax: paste
+ * \endvar
  */
                { LFUN_PASTE, "paste", Noop, Edit },
                { LFUN_CLIPBOARD_PASTE, "clipboard-paste", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_PRIMARY_SELECTION_PASTE
  * \li Action: Pastes the material currently selected.
  * \li Syntax: primary-selection-paste
+ * \endvar
  */
                { LFUN_PRIMARY_SELECTION_PASTE, "primary-selection-paste", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_UNDO
  * \li Action: Undoes the last edit.
  * \li Syntax: undo
+ * \endvar
  */
                { LFUN_UNDO, "undo", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_REDO
  * \li Action: Redoes the last thing undone.
  * \li Syntax: redo
+ * \endvar
  */
                { LFUN_REDO, "redo", Noop, Edit },
                { LFUN_REPEAT, "repeat", NoBuffer, Edit },
@@ -577,46 +644,51 @@ void LyXAction::init()
                { LFUN_BIBTEX_DATABASE_ADD, "bibtex-database-add", Noop, Edit },
                { LFUN_BIBTEX_DATABASE_DEL, "bibtex-database-del", Noop, Edit },
 
- /**
+/*!
  * \var lyx::kb_action lyx::LFUN_LAYOUT
  * \li Action: Sets the layout (that is, environment) for the current paragraph.
  * \li Syntax: layout <LAYOUT>
  * \li Params: <LAYOUT>: the layout to use
+ * \endvar
  */
                { LFUN_LAYOUT, "layout", Noop, Layout },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LAYOUT_PARAGRAPH
  * \li Action: Launches the paragraph settings dialog.
  * \li Syntax: layout-paragraph
+ * \endvar
  */
                { LFUN_LAYOUT_PARAGRAPH, "layout-paragraph", ReadOnly, Layout },
                { LFUN_LAYOUT_TABULAR, "layout-tabular", Noop, Layout },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_DROP_LAYOUTS_CHOICE
  * \li Action: Displays list of layout choices.
  * \li Notion: In the current (as of 2007) Qt4 frontend, this LFUN opens the
                dropbox allowing for choice of layout.
  * \li Syntax: drop-layouts-choice
+ * \endvar
  */
                { LFUN_DROP_LAYOUTS_CHOICE, "drop-layouts-choice", ReadOnly, Layout },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LAYOUT_MODULES_CLEAR
  * \li Action: Clears the module list.
  * \li Notion: Clears the list of included modules for the current buffer.
  * \li Syntax: layout-modules-clear
  * \li Origin: rgh, 25 August 2007
+ * \endvar
  */
                { LFUN_LAYOUT_MODULES_CLEAR, "layout-modules-clear", Noop, Layout },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LAYOUT_MODULE_ADD
  * \li Action: Adds a module.
  * \li Notion: Adds a module to the list of included modules for the current buffer.
  * \li Syntax: layout-module-add <MODULE>
  * \li Params: <MODULE>: the module to be added
  * \li Origin: rgh, 25 August 2007
+ * \endvar
  */
                { LFUN_LAYOUT_MODULE_ADD, "layout-module-add", Noop, Layout },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LAYOUT_RELOAD
  * \li Action: Reloads layout information.
  * \li Notion: Reloads all layout information for the current buffer from disk, thus
@@ -625,43 +697,49 @@ void LyXAction::init()
                used when one is trying to do actual work.
  * \li Syntax: layout-reload
  * \li Origin: rgh, 3 September 2007
+ * \endvar
  */
                { LFUN_LAYOUT_RELOAD, "layout-reload", Noop, Layout },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_TEXTCLASS_APPLY
  * \li Action: Sets the text class for the current buffer.
  * \li Syntax: textclass-apply <TEXTCLASS>
  * \li Params: <TEXTCLASS>: the textclass to set. Note that this must be
                    the filename, minus the ".layout" extension.
+ * \endvar
  */
                { LFUN_TEXTCLASS_APPLY, "textclass-apply", Noop, Layout },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_TEXTCLASS_LOAD
  * \li Action: Loads information for a textclass from disk.
  * \li Syntax: textclass-load <TEXTCLASS>
  * \li Params: <TEXTCLASS>: the textclass to load. Note that this must be
                    the filename, minus the ".layout" extension.
+ * \endvar
  */
                { LFUN_TEXTCLASS_LOAD, "textclass-load", Noop, Layout },
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MARK_OFF
  * \li Action: Disable selecting of text-region.
  * \li Syntax: mark-off
+ * \endvar
  */
                { LFUN_MARK_OFF, "mark-off", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MARK_ON
  * \li Action: Enable selecting of text-region.
  * \li Notion: After enabling you can simply move arrow keys to get selected region.
  * \li Syntax: mark-on
+ * \endvar
  */
                { LFUN_MARK_ON, "mark-on", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MARK_TOGGLE
  * \li Action: Toggle between #LFUN_MARK_ON and #LFUN_MARK_OFF .
  * \li Syntax: mark-toggle
  * \li Origin: poenitz, May 5 2006
+ * \endvar
  */
                { LFUN_MARK_TOGGLE, "mark-toggle", ReadOnly, Edit },
                
@@ -678,43 +756,47 @@ void LyXAction::init()
                { LFUN_MATH_IMPORT_SELECTION, "math-import-selection", Noop, Math },
                { LFUN_MATH_MATRIX, "math-matrix", Noop, Math },
                { LFUN_MATH_MODE, "math-mode", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_NUMBER_LINE_TOGGLE
  * \li Action: Toggles numbering of the current formula line.
  * \li Notion: Must be in display formula mode.
  * \li Syntax: math-number-line-toggle
  * \li Origin: Alejandro 18 Jun 1996
+ * \endvar
  */
                { LFUN_MATH_NUMBER_LINE_TOGGLE, "math-number-line-toggle", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_NUMBER_TOGGLE
- * \li Action: Toggles numbering of the current formula.
+ * \li Action: Toggles numbering/labeling of the current formula.
  * \li Notion: Must be in display formula mode.
  * \li Syntax: math-number-toggle
  * \li Origin: Alejandro 4 Jun 1996
+ * \endvar
  */
                { LFUN_MATH_NUMBER_TOGGLE, "math-number-toggle", Noop, Math },
                { LFUN_MATH_EXTERN, "math-extern", Noop, Math },
                { LFUN_MATH_SIZE, "math-size", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_UNFOLD
  * \li Action: Unfold a Math Macro.
  * \li Notion: Unfold the Math Macro the cursor is in, i.e.
                display it as \foo.
  * \li Syntax: math-macro-unfold
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_UNFOLD, "math-macro-unfold", ReadOnly | SingleParUpdate, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_FOLD
  * \li Action: Fold a Math Macro.
  * \li Notion: Fold the Math Macro the cursor is in if it was
                unfolded, i.e. displayed as \foo before.
  * \li Syntax: math-macro-fold
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_FOLD, "math-macro-fold", ReadOnly | SingleParUpdate, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_ADD_PARAM
  * \li Action: Add a parameter.
  * \li Notion: Add a parameter to a Math Macro.
@@ -723,9 +805,10 @@ void LyXAction::init()
                parameter at the left), defaults to the last one.
  * \li Syntax: math-macro-add-param <NUM>
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_ADD_PARAM, "math-macro-add-param", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_REMOVE_PARAM
  * \li Action: Remove the last parameter.
  * \li Notion: Remove the last parameter of a Math Macro and
@@ -735,9 +818,10 @@ void LyXAction::init()
                the first), defaults to the last one.
  * \li Syntax: math-macro-remove-param <NUM>
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_REMOVE_PARAM, "math-macro-remove-param", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_APPEND_GREEDY_PARAM
  * \li Action: Append a greedy parameter.
  * \li Notion: Append a greedy parameter to a Math Macro which
@@ -745,9 +829,10 @@ void LyXAction::init()
                the macro in the buffer.
  * \li Syntax: math-macro-append-greedy-param
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_APPEND_GREEDY_PARAM, "math-macro-append-greedy-param", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_REMOVE_GREEDY_PARAM
  * \li Action: Remove a greedy parameter.
  * \li Notion: Remove a greedy parameter of a Math Macro and spit
@@ -756,18 +841,20 @@ void LyXAction::init()
                format is used.
  * \li Syntax: math-macro-remove-greedy-param
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_REMOVE_GREEDY_PARAM, "math-macro-remove-greedy-param", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_MAKE_OPTIONAL
  * \li Action: Make a parameter optional.
  * \li Notion: Turn the first non-optional parameter of a Math Macro
                into an optional parameter with a default value.
  * \li Syntax: math-macro-make-optional
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_MAKE_OPTIONAL, "math-macro-make-optional", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_MAKE_NONOPTIONAL
  * \li Action: Make a parameter non-optional.
  * \li Notion: Turn the last optional parameter of a Math Macro
@@ -775,27 +862,30 @@ void LyXAction::init()
                remembered to be reused later if the user changes his mind.
  * \li Syntax: math-macro-make-nonoptional
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_MAKE_NONOPTIONAL, "math-macro-make-nonoptional", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_ADD_OPTIONAL_PARAM
  * \li Action: Add an optional parameter.
  * \li Notion: Insert an optional parameter just behind the
                already existing optional parameters.
  * \li Syntax: math-macro-add-optional-param
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_ADD_OPTIONAL_PARAM, "math-macro-add-optional-param", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_REMOVE_OPTIONAL_PARAM
  * \li Action: Remove the last optional parameter.
  * \li Notion: Remove the last optional parameter of a Math Macro and
                remove it in all the instances of the macro in the buffer.
  * \li Syntax: math-macro-remove-optional-param
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_REMOVE_OPTIONAL_PARAM, "math-macro-remove-optional-param", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_MATH_MACRO_ADD_GREEDY_OPTIONAL_PARAM
  * \li Action: Add a greedy optional parameter.
  * \li Notion: Add a greedy optional parameter which eats the value
@@ -803,9 +893,10 @@ void LyXAction::init()
                format.
  * \li Syntax: math-macro-add-greedy-optional-param
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_MATH_MACRO_ADD_GREEDY_OPTIONAL_PARAM, "math-macro-add-greedy-optional-param", Noop, Math },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_IN_MATHMACROTEMPLATE
  * \li Action: Only active in Math Macro definition.
  * \li Notion: Dummy function which is only active in a Math Macro definition.
@@ -813,13 +904,14 @@ void LyXAction::init()
                into a Math Macro definition.
  * \li Syntax: in-mathmacrotemplate
  * \li Origin: sts, 06 January 2008
+ * \endvar
  */
                { LFUN_IN_MATHMACROTEMPLATE, "in-mathmacrotemplate", Noop, Math },
 
                { LFUN_PARAGRAPH_DOWN, "paragraph-down", ReadOnly | NoUpdate, Edit },
                { LFUN_PARAGRAPH_DOWN_SELECT, "paragraph-down-select", ReadOnly, Edit },
                { LFUN_PARAGRAPH_GOTO, "paragraph-goto", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_OUTLINE_UP
  * \li Action: Move the current group in the upward direction in the
                structure of the document.
@@ -827,9 +919,10 @@ void LyXAction::init()
                the whole substructure of the group.
  * \li Syntax: outline-up
  * \li Origin: Vermeer, 23 Mar 2006
+ * \endvar
  */
                { LFUN_OUTLINE_UP, "outline-up", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_OUTLINE_DOWN
  * \li Action: Move the current group in the downward direction in the
                structure of the document.
@@ -837,24 +930,27 @@ void LyXAction::init()
                the whole substructure of the group.
  * \li Syntax: outline-down
  * \li Origin: Vermeer, 23 Mar 2006
+ * \endvar
  */
                { LFUN_OUTLINE_DOWN, "outline-down", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_OUTLINE_IN
  * \li Action: Moves the current group in the downward direction in the
                hierarchy of the document structure.
  * \li Notion: Part -> Chapter -> Section -> etc.
  * \li Syntax: outline-in
  * \li Origin: Vermeer, 23 Mar 2006
+ * \endvar
  */
                { LFUN_OUTLINE_IN, "outline-in", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_OUTLINE_OUT
  * \li Action: Moves the current group in the upward direction in the
                hierarchy of the document structure.
  * \li Notion: Part <- Chapter <- Section <- etc.
  * \li Syntax: outline-out
  * \li Origin: Vermeer, 23 Mar 2006
+ * \endvar
  */
                { LFUN_OUTLINE_OUT, "outline-out", Noop, Edit },
 
@@ -886,18 +982,56 @@ void LyXAction::init()
                { LFUN_ALL_CHANGES_ACCEPT, "all-changes-accept", Noop, Edit },
                { LFUN_ALL_CHANGES_REJECT, "all-changes-reject", Noop, Edit },
 
+/*!
+ * \var lyx::kb_action lyx::LFUN_INSET_APPLY
+ * \li Action: Apply data for an inset.
+ * \li 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.
+ * \li Syntax: inset-apply <ARGS>
+ * \li Params: See #LFUN_INSET_INSERT .
+ * \endvar
+ */
                { LFUN_INSET_APPLY, "inset-apply", Noop, Edit },
                { LFUN_INSET_DISSOLVE, "inset-dissolve", Noop, Edit },
+/*!
+ * \var lyx::kb_action lyx::LFUN_INSET_INSERT
+ * \li Action: Insert new inset (type given by the parameters).
+ * \li Syntax: inset-insert <INSET> <ARGS>
+ * \li Params: <INSET>: <bibitem|bibtex|cite|ert|listings|external|graphics|
+                         hyperlink|include|index|label|nomencl|vspace|ref|toc>\n
+               <ARGS>: depends on the given inset. Use "lyx -dbg action" to
+                      explore.
+ * \li Sample: inset-insert ref LatexCommand <Format> reference "<label name>"\end_inset \n
+               where <label name> is the name of the referenced label and
+              <Format> is one of the following: \n
+              ref -- <reference> \n
+              eqref -- (<reference>) \n
+              pageref -- <page> \n
+               vpageref -- on <page> \n
+              vref -- <reference> on <page> \n
+               prettyref -- Formatted reference
+ * \endvar
+ */
                { LFUN_INSET_INSERT, "inset-insert", Noop, Edit },
+/*!
+ * \var lyx::kb_action lyx::LFUN_INSET_MODIFY
+ * \li Action: Modify existing inset.
+ * \li Notion: Used for label, floats, listings, box, branch, external, wrap
+               bibtex, ert, command, grahocs, note, vspace, tabular, bibitem,
+              inlude, ref insets.
+ * \li Syntax: inset-modify <INSET> <ARGS>
+ * \li Params: See #LFUN_INSET_INSERT for further details.
+ * \endvar
+ */
                { LFUN_INSET_MODIFY, "", Noop, Hidden },
                { LFUN_INSET_DIALOG_UPDATE, "", Noop, Hidden },
                { LFUN_INSET_SETTINGS, "inset-settings", ReadOnly, Edit },
-               { LFUN_INSET_REFRESH, "", Noop, Hidden },
                { LFUN_NEXT_INSET_TOGGLE, "next-inset-toggle", ReadOnly, Edit },
                { LFUN_INSET_TOGGLE, "", ReadOnly, Hidden },
                { LFUN_ALL_INSETS_TOGGLE, "all-insets-toggle", ReadOnly, Edit },
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_PARAGRAPH_PARAMS
  * \li Action: Change paragraph settings.
  * \li Notion: Modifies the current paragraph, or currently selected paragraphs.
@@ -909,21 +1043,23 @@ void LyXAction::init()
                <ALIGN>:   \\align block|left|right|center|default\n
                <OTHERS>:  \\labelwidthstring WIDTH|\\start_of_appendix\n
  * \li Origin: rgh, Aug 15 2007
+ * \endvar
  */
                { LFUN_PARAGRAPH_PARAMS, "paragraph-params", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_PARAGRAPH_PARAMS_APPLY
  * \li Action: Change paragraph settings.
  * \li Notion: Overwrite all nonspecified settings to the default ones.
                Use paragraph-params lfun if you don't want to overwrite others settings.
  * \li Syntax: paragraph-params-apply <INDENT> <SPACING> <ALIGN> <OTHERS>
- * \li Params: For parameters see LFUN_PARAGRAPH_PARAMS
+ * \li Params: For parameters see #LFUN_PARAGRAPH_PARAMS
  * \li Origin: leeming, 30 Mar 2004
+ * \endvar
  */
                { LFUN_PARAGRAPH_PARAMS_APPLY, "paragraph-params-apply", Noop, Edit },
                { LFUN_PARAGRAPH_UPDATE, "", Noop, Hidden },
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_FINISHED_FORWARD
  * \li Action: Moves the cursor out of the current slice, going forward.
  * \li Notion: Cursor movement within an inset may be different than cursor
@@ -933,27 +1069,31 @@ void LyXAction::init()
                last paragraph, for example), in order to move correctly
                back into the surrounding text.
  * \li Syntax: finished-forward
+ * \endvar
  */
                { LFUN_FINISHED_FORWARD, "", ReadOnly, Hidden },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_FINISHED_BACKWARD
  * \li Action: Moves the cursor out of the current slice, going backwards.
  * \li Notion: See also #LFUN_FINISHED_FORWARD.
  * \li Syntax: finished-backward
+ * \endvar
  */
                { LFUN_FINISHED_BACKWARD, "", ReadOnly, Hidden },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_FINISHED_RIGHT
  * \li Action: Moves the cursor out of the current slice, going right.
  * \li Notion: See also #LFUN_FINISHED_FORWARD
  * \li Syntax: finished-right
+ * \endvar
  */
                { LFUN_FINISHED_RIGHT, "", ReadOnly, Hidden },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_FINISHED_LEFT
  * \li Action: Moves the cursor out of the current slice, going left.
  * \li Notion: See also #LFUN_FINISHED_FORWARD.
  * \li Syntax: finished-left
+ * \endvar
  */
                { LFUN_FINISHED_LEFT, "", ReadOnly, Hidden },
 
@@ -963,7 +1103,7 @@ void LyXAction::init()
                { LFUN_LABEL_INSERT, "label-insert", Noop, Edit },
                { LFUN_REFERENCE_NEXT, "reference-next", ReadOnly, Edit },
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BOOKMARK_GOTO
  * \li Action: Goto a bookmark.
  * \li Notion: Moves the cursor to the numbered bookmark, opening the file
@@ -972,9 +1112,10 @@ void LyXAction::init()
  * \li Syntax: bookmark-goto <NUMBER>
  * \li Params: <NUMBER>: the number of the bookmark to restore.
  * \li Origin: Dekel, 27 January 2001
+ * \endvar
  */
                { LFUN_BOOKMARK_GOTO, "bookmark-goto", NoBuffer, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BOOKMARK_SAVE
  * \li Action: Save a bookmark.
  * \li Notion: Saves a numbered bookmark to the sessions file. The number
@@ -983,31 +1124,81 @@ void LyXAction::init()
  * \li Syntax: bookmark-save <NUMBER>
  * \li Params: <NUMBER>: the number of the bookmark to save.
  * \li Origin: Dekel, 27 January 2001
+ * \endvar
  */
                { LFUN_BOOKMARK_SAVE, "bookmark-save", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BOOKMARK_CLEAR
  * \li Action: Clears the list of saved bookmarks.
  * \li Syntax: bookmark-clear
  * \li Origin: bpeng, 31 October 2006
+ * \endvar
  */
                { LFUN_BOOKMARK_CLEAR, "bookmark-clear", NoBuffer, Edit },
 
                { LFUN_HELP_OPEN, "help-open", NoBuffer | Argument, Buffer },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LYX_QUIT
  * \li Action: Terminates the current LyX instance.
  * \li Notion: Terminates the current LyX instance, asking whether to save
                modified documents, etc.
  * \li Syntax: lyx-quit
+ * \endvar
  */
                { LFUN_LYX_QUIT, "lyx-quit", NoBuffer, Buffer },
+/*!
+ * \var lyx::kb_action lyx::LFUN_TOOLBAR_TOGGLE
+ * \li Action: Toggles visibility of a given toolbar between on/off/auto.
+ * \li Notion: Skiping "auto" when allowauto is false.
+ * \li Syntax: toolbar-toggle <NAME> [allowauto]
+ * \li Params: <NAME>: standard|extra|table|math|mathmacrotemplate|
+                       minibuffer|review|view/update|math_panels
+ * \li Origin: Edwin, 21 May 2007
+ * \endvar
+ */
                { LFUN_TOOLBAR_TOGGLE, "toolbar-toggle", NoBuffer, Buffer },
                { LFUN_MENU_OPEN, "menu-open", NoBuffer, Buffer },
+/*!
+ * \var lyx::kb_action lyx::LFUN_UI_TOGGLE
+ * \li Action: Various UI visibility-toggling actions.
+ * \li Syntax: ui-toggle <statusbar|menubar|frame|fullscreen>
+ * \li Params: statusbar  : Toggle visibility of the statusbar.\n
+               menubar    : Toggle visibility of the menubar.\n
+              scrollbar  : Toggle visibility of the scrollbar.\n
+              frame      : Toggle visibility of the frames around editing window.\n
+              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.
+ * \li Origin: ps, 9 Feb 2007
+ * \endvar
+ */
+               { LFUN_UI_TOGGLE, "ui-toggle", NoBuffer, Buffer },
 
                { LFUN_WINDOW_NEW, "window-new", NoBuffer, Buffer },
                { LFUN_WINDOW_CLOSE, "window-close", NoBuffer, Buffer },
 
+/*!
+ * \var lyx::kb_action lyx::LFUN_SPLIT_VIEW
+ * \li Action: Creates another split view of current buffer.
+ * \li Notion: All split views act in the same way indpendently.
+ * \li Syntax: split-view <vertical|horizontal>
+ * \li Params: horizontal : The work areas are laid out side by side.\n
+               vertical   : The work areas laid out vertically.\n
+ * \li Origin: abdel, 20 Feb 2008
+ * \endvar
+ */
+               { LFUN_SPLIT_VIEW, "split-view", ReadOnly, Buffer },
+
+/*!
+ * \var lyx::kb_action lyx::LFUN_CLOSE_TAB_GROUP
+ * \li Action: Close the current tab group.
+ * \li Notion: This only closes the work areas, not the buffer themselves.
+               The still opened buffers can be visualized in another tab group.
+ * \li Syntax: close-tab-group
+ * \li Origin: abdel, 21 Feb 2008
+ * \endvar
+ */
+               { LFUN_CLOSE_TAB_GROUP, "close-tab-group", ReadOnly, Buffer },
                { LFUN_DIALOG_SHOW, "dialog-show", NoBuffer, Edit },
                { LFUN_DIALOG_SHOW_NEW_INSET, "dialog-show-new-inset", Noop, Edit },
                { LFUN_DIALOG_UPDATE, "dialog-update", NoBuffer, Edit },
@@ -1035,58 +1226,134 @@ void LyXAction::init()
                { LFUN_SERVER_GET_LAYOUT, "server-get-layout", ReadOnly, System },
                { LFUN_SERVER_GET_NAME, "server-get-name", ReadOnly, System },
                { LFUN_SERVER_GET_XY, "server-get-xy", ReadOnly, System },
+/*!
+ * \var lyx::kb_action lyx::LFUN_SERVER_GOTO_FILE_ROW
+ * \li Action: Sets the cursor position based on the row number of generated TeX file.
+ * \li Syntax: server-goto-file-row <FILE_NAME> <ROW_NUMBER>
+ * \li Origin: Edmar, 23 Dec 1998
+ * \endvar
+ */
                { LFUN_SERVER_GOTO_FILE_ROW, "server-goto-file-row", ReadOnly, System },
                { LFUN_SERVER_NOTIFY, "server-notify", ReadOnly, System },
                { LFUN_SERVER_SET_XY, "server-set-xy", ReadOnly, System },
 
                { LFUN_BUILD_PROGRAM, "build-program", ReadOnly, Buffer },
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BUFFER_AUTO_SAVE
  * \li Action: Saves the current buffer to a temporary file.
  * \li Notion: Saves the current buffer to a file named "#filename#". This LFUN
                is called automatically by LyX, to "autosave" the current buffer.
        * \li Syntax: buffer-auto-save
+ * \endvar
  */
                { LFUN_BUFFER_AUTO_SAVE, "buffer-auto-save", Noop, Buffer },
                { LFUN_BUFFER_CHILD_OPEN, "buffer-child-open", ReadOnly, Buffer },
                { LFUN_BUFFER_CHKTEX, "buffer-chktex", ReadOnly, Buffer },
                { LFUN_BUFFER_TOGGLE_COMPRESSION, "buffer-toggle-compression", Noop, Buffer },
                { LFUN_BUFFER_TOGGLE_EMBEDDING, "buffer-toggle-embedding", Noop, Buffer },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BUFFER_CLOSE
  * \li Action: Closes the current buffer.
  * \li Notion: Closes the current buffer, asking whether to save it, etc,
                if the buffer has been modified.
  * \li Syntax: buffer-close
+ * \endvar
  */
                { LFUN_BUFFER_CLOSE, "buffer-close", ReadOnly, Buffer },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BUFFER_EXPORT
  * \li Action: Exports the current buffer (document) to the given format.
  * \li Syntax: buffer-export <FORMAT>
  * \li 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.
+                       "pdflatex" (plain tex for pdflatex) or "ps" for postscript.\n
+                       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.
  * \li Origin: Lgb, 29 Jul 1997
+ * \endvar
  */
                { LFUN_BUFFER_EXPORT, "buffer-export", ReadOnly, Buffer },
+/*!
+ * \var lyx::kb_action lyx::LFUN_BUFFER_EXPORT_CUSTOM
+ * \li Action: Exports the current buffer (document) from the given format using
+               the given command on it.
+ * \li Syntax: buffer-export-custom <FORMAT> <COMMAND>
+ * \li Params: <FORMAT> format to start from (LyX will care to produce such
+                        intermediate file).\n
+               <COMMAND> this command will be launched on the file. Note that you can
+              use "$$FName" string to qualify the intermediate file.
+ * \li Sample: buffer-export-custom dvi dvips -f $$FName -o myfile.ps
+ * \li Origin: leeming, 27 Mar 2004
+ * \endvar
+ */
                { LFUN_BUFFER_EXPORT_CUSTOM, "buffer-export-custom", ReadOnly, Buffer },
+/*!
+ * \var lyx::kb_action lyx::LFUN_BUFFER_PRINT
+ * \li Action: Prints the current document.
+ * \li Notion: Many settings can be given via the preferences dialog.
+ * \li Syntax: buffer-print <TARGET> <TARGET-NAME> <COMMAND>
+ * \li Params: <TARGET> is either "printer" or "file".\n
+               <TARGER-NAME> is either "default" or file name or printer name.\n
+              <COMMAND> command ensuring the printing job.
+ * \li Sample: buffer-print file "/trash/newfile1.ps" "dvips"
+ * \li Origin: leeming, 28 Mar 2004
+ * \endvar
+ */
                { LFUN_BUFFER_PRINT, "buffer-print", ReadOnly, Buffer },
+/*!
+ * \var lyx::kb_action lyx::LFUN_BUFFER_IMPORT
+ * \li Action: Import a given file as a lyx document.
+ * \li Notion: File can be imported iff lyx file format is (transitively) reachable via
+               defined convertors in preferences. Look into File->Import menu to get
+              an idea of the currently active import formats.
+ * \li Syntax: buffer-import <FORMAT> [<FILE>]
+ * \li Origin: Asger, 24 Jul 1998
+ * \endvar
+ */
                { LFUN_BUFFER_IMPORT, "buffer-import", NoBuffer, Buffer },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BUFFER_NEW
  * \li Action: Creates a new buffer (that is, document).
- * \li Syntax: buffer-new
+ * \li Notion: Implicit path can be set in Preferences dialog.
+ * \li Syntax: buffer-new [<FILE>]
+ * \li Params: <FILE>: filename of created file with absolute path.
+ * \endvar
  */
                { LFUN_BUFFER_NEW, "buffer-new", NoBuffer, Buffer },
+/*!
+ * \var lyx::kb_action lyx::LFUN_BUFFER_NEW_TEMPLATE
+ * \li Action: Creates a new buffer (that is, document) from a template.
+ * \li Notion: Path for new files and templates can be set in Preferences dialog.
+               Template will be asked for via Open-dialog.
+ * \li Syntax: buffer-new-template [<FILE>]
+ * \li Params: <FILE>: filename of created file with absolute path.
+ * \endvar
+ */
                { LFUN_BUFFER_NEW_TEMPLATE,"buffer-new-template", NoBuffer, Buffer },
                { LFUN_BUFFER_RELOAD, "buffer-reload", ReadOnly, Buffer },
+/*!
+ * \var lyx::kb_action lyx::LFUN_BUFFER_SWITCH
+ * \li Action: Switch to the given buffer.
+ * \li Notion: This is useful also in case you need simultaneously more views of the edited
+               document in different LyX windows.
+ * \li Syntax: buffer-new-template <BUFFER>
+ * \li Params: <BUFFER>: already opened document which is to be shown.
+ * \endvar
+ */
                { LFUN_BUFFER_SWITCH, "buffer-switch", NoBuffer | ReadOnly, Buffer },
+/*!
+ * \var lyx::kb_action lyx::LFUN_BUFFER_TOGGLE_READ_ONLY
+ * \li Action: Toggle editing mode of the current document between read/write and read-only.
+ * \li Syntax: buffer-toggle-read-only
+ * \li Origin: Lgb, 27 May 1997
+ * \endvar
+ */
                { LFUN_BUFFER_TOGGLE_READ_ONLY, "buffer-toggle-read-only", ReadOnly, Buffer },
-               { LFUN_BUFFER_UPDATE, "buffer-update", ReadOnly, Buffer },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BUFFER_VIEW
  * \li Action: Displays current buffer in chosen format.
  * \li Notion: Displays the contents of the current buffer in the chosen
@@ -1096,23 +1363,42 @@ void LyXAction::init()
  * \li 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.
+ * \endvar
  */
                { LFUN_BUFFER_VIEW, "buffer-view", ReadOnly, Buffer },
-/**
+/*!
+ * \var lyx::kb_action lyx::LFUN_BUFFER_UPDATE
+ * \li Action: Exports the current document and put the result into the
+               temporary directory.
+ * \li Notion: In case you are already viewing the exported document (see #LFUN_BUFFER_VIEW)
+               the output will be rewriten - updated. This is useful in case your viewer
+              is able to detect such changes (e.g. ghostview for postscript).
+ * \li Syntax: buffer-update <FORMAT>
+ * \li 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.
+ * \li Origin: Dekel, 5 Aug 2000
+ * \endvar
+ */
+               { LFUN_BUFFER_UPDATE, "buffer-update", ReadOnly, Buffer },
+
+/*!
  * \var lyx::kb_action lyx::LFUN_BUFFER_WRITE
  * \li Action: Saves the current buffer.
  * \li 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.
  * \li Syntax: buffer-write
+ * \endvar
  */
                { LFUN_BUFFER_WRITE, "buffer-write", ReadOnly, Buffer },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BUFFER_WRITE_AS
  * \li Action: Rename and save current buffer.
  * \li Syntax: buffer-write-as <FILENAME>
  * \li Params: <FILENAME>: New name of the buffer/file. A relative path
- *             is with respect to the original location of the buffer/file.
+               is with respect to the original location of the buffer/file.
+ * \endvar
  */
                { LFUN_BUFFER_WRITE_AS, "buffer-write-as", ReadOnly, Buffer },
                { LFUN_BUFFER_WRITE_ALL, "buffer-write-all", ReadOnly, Buffer },
@@ -1124,17 +1410,46 @@ void LyXAction::init()
                { LFUN_BUFFER_SAVE_AS_DEFAULT, "buffer-save-as-default", Noop, Buffer },
                { LFUN_BUFFER_PARAMS_APPLY, "buffer-params-apply", Noop, Buffer },
 
+/*!
+ * \var lyx::kb_action lyx::LFUN_FILE_INSERT
+ * \li Action: Inserts another LyX file.
+ * \li Syntax: file-insert [<FILE>]
+ * \li Params: <FILE>: Filename to be inserted.
+ * \endvar
+ */
                { LFUN_FILE_INSERT, "file-insert", Noop, Edit },
+/*!
+ * \var lyx::kb_action lyx::LFUN_FILE_INSERT_PLAINTEXT
+ * \li Action: Inserts plain text file.
+ * \li Syntax: file-insert-plaintext [<FILE>]
+ * \li Params: <FILE>: Filename to be inserted.
+ * \li Origin: CFO-G, 19 Nov 1997
+ * \endvar
+ */
                { LFUN_FILE_INSERT_PLAINTEXT, "file-insert-plaintext", Noop, Edit },
+/*!
+ * \var lyx::kb_action lyx::LFUN_FILE_INSERT_PLAINTEXT_PARA
+ * \li Action: Inserts plain text file as paragraph (i.e. join lines).
+ * \li Syntax: file-insert-plaintext-para [<FILE>]
+ * \li Params: <FILE>: Filename to be inserted.
+ * \li Origin: Levon, 14 Feb 2001
+ * \endvar
+ */
                { LFUN_FILE_INSERT_PLAINTEXT_PARA, "file-insert-plaintext-para", Noop, Edit },
-               { LFUN_FILE_NEW, "file-new", NoBuffer, Buffer },
+/*!
+ * \var lyx::kb_action lyx::LFUN_FILE_OPEN
+ * \li Action: Open LyX document.
+ * \li Syntax: file-open [<FILE>]
+ * \li Params: <FILE>: Filename to be opened.
+ * \endvar
+ */
                { LFUN_FILE_OPEN, "file-open", NoBuffer, Buffer },
 
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CALL
  * \li Action: Executes a command defined in a .def file.
- * \li Notion: The definitions are by default read from lib/commands/default.def .
+ * \li Notion: The definitions are by default read from lib/commands/default.def.\n
                A .def file allows to define a command with \\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).
@@ -1146,81 +1461,91 @@ void LyXAction::init()
  * \li Syntax: call <NAME>
  * \li Params: <NAME>: Name of the command that must be called.
  * \li Origin: broider, 2 Oct 2007
+ * \endvar
  */
                { LFUN_CALL, "call", NoBuffer, System },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_META_PREFIX
  * \li Action: Simulate halting Meta key (Alt key on PCs).
  * \li Notion: Used for buffer editation not for GUI control.
  * \li Syntax: meta-prefix
+ * \endvar
  */
                { LFUN_META_PREFIX, "meta-prefix", NoBuffer, System },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CANCEL
  * \li Action: Cancels sequence prepared by #LFUN_META_PREFIX .
  * \li Syntax: cancel
+ * \endvar
  */
                { LFUN_CANCEL, "cancel", NoBuffer, System },
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_COMMAND_EXECUTE
  * \li Action: Opens the minibuffer toolbar so that the user can type in there.
  * \li Notion: Usually bound to M-x shortcut.
  * \li Syntax: command-execute
+ * \endvar
  */
                { LFUN_COMMAND_EXECUTE, "command-execute", NoBuffer, Edit },
                { LFUN_COMMAND_PREFIX, "command-prefix", NoBuffer, Hidden },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_COMMAND_SEQUENCE
  * \li Action: Run more commands (LFUN and its parameters) in a sequence.
  * \li Syntax: command-sequence <CMDS>
  * \li Params: <CMDS>: Sequence of commands separated by semicolons.
  * \li Sample: command-sequence cut; ert-insert; self-insert \; paste; self-insert {}; inset-toggle;
  * \li Origin: Andre', 11 Nov 1999
+ * \endvar
  */
                { LFUN_COMMAND_SEQUENCE, "command-sequence", NoBuffer, System },
 
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_PREFERENCES_SAVE
  * \li Action: Save user preferences.
  * \li Syntax: preferences-save
  * \li Origin: Lgb, 27 Nov 1999
+ * \endvar
  */
                { LFUN_PREFERENCES_SAVE, "preferences-save", NoBuffer, System },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_RECONFIGURE
  * \li Action: Reconfigure the automatic settings.
  * \li Syntax: reconfigure
  * \li Origin: Asger, 14 Feb 1997
+ * \endvar
  */
                { LFUN_RECONFIGURE, "reconfigure", NoBuffer, System },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LYXRC_APPLY
  * \li Action: Apply the given settings to user preferences.
  * \li Syntax: lyxrc-apply <SETTINGS>
  * \li 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.
+ * \endvar
  */
                { LFUN_LYXRC_APPLY, "lyxrc-apply", NoBuffer, System },
-/**
- * \var lyx::kb_action lyx::LFUN_TOGGLE_CURSOR_FOLLOWS_SCROLLBAR
+/*!
+ * \var lyx::kb_action lyx::LFUN_CURSOR_FOLLOWS_SCROLLBAR_TOGGLE
  * \li Action: Determine whether keep cursor inside the editing window regardless
                the scrollbar movement.
  * \li Syntax: toggle-cursor-follows-scrollbar
  * \li Origin: ARRae, 2 Dec 1997
+ * \endvar
  */
-               { LFUN_TOGGLE_CURSOR_FOLLOWS_SCROLLBAR, "toggle-cursor-follows-scrollbar", ReadOnly, System },
-/**
+               { LFUN_CURSOR_FOLLOWS_SCROLLBAR_TOGGLE, "cursor-follows-scrollbar-toggle", ReadOnly, System },
+/*!
  * \var lyx::kb_action lyx::LFUN_SET_COLOR
  * \li Action: Set the given LyX color to the color defined by the X11 name given.
  * \li Notion: A new color entry is created if the color is unknown.
                Color names can be stored as a part of user settings.
  * \li Syntax: set-color <LYX_NAME> <X11_NAME>
  * \li Origin: SLior, 11 Jun 2000
+ * \endvar
  */
                { LFUN_SET_COLOR, "set-color", ReadOnly | NoBuffer, System },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_STATISTICS
  * \li Action: Count the statistics (number of words and characters)
                in the document or in the given selection.
@@ -1228,8 +1553,33 @@ void LyXAction::init()
                not the number of characters which will be typeset.
  * \li Syntax: statistics
  * \li Origin: lasgouttes, Jan 27 2004; ps, Jan 8 2008
+ * \endvar
  */
                { LFUN_STATISTICS, "statistics", ReadOnly, System },
+/*!
+ * \var lyx::kb_action lyx::LFUN_COMPLETION_INLINE
+ * \li Action: Show the inline completion at the cursor position.
+ * \li Syntax: completion-inline
+ * \li Origin: sts, Feb 19 2008
+ * \endvar
+ */
+               { LFUN_COMPLETION_INLINE, "completion-inline", ReadOnly | NoUpdate, Edit },
+/*!
+ * \var lyx::kb_action lyx::LFUN_COMPLETION_POPUP
+ * \li Action: Show the completion popup at the cursor position.
+ * \li Syntax: completion-popup
+ * \li Origin: sts, Feb 19 2008
+ * \endvar
+ */
+               { LFUN_COMPLETION_POPUP, "completion-popup", ReadOnly | NoUpdate, Edit },
+/*!
+ * \var lyx::kb_action lyx::LFUN_COMPLETION_COMPLETE
+ * \li Action: Try to complete the word or command at the cursor position.
+ * \li Syntax: complete
+ * \li Origin: sts, Feb 19 2008
+ * \endvar
+ */
+               { LFUN_COMPLETION_COMPLETE, "complete", SingleParUpdate, Edit },
 
                { LFUN_NOACTION, "", Noop, Hidden }
 #ifndef DOXYGEN_SHOULD_SKIP_THIS