]> git.lyx.org Git - lyx.git/blobdiff - src/LyXAction.cpp
* Doxy: polish html output.
[lyx.git] / src / LyXAction.cpp
index ec3abb52189ccc6aca4a895ccc7156861af0da43..4c4666cc1eb0172afe9d40e68a1e4cfa42f1bfa4 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.
@@ -55,12 +55,13 @@ namespace lyx {
  * and put in <BRACKETS>, as so.
  */
 
-/**
- * 
+/*!
+ * \var lyx::kb_action lyx::LFUN_
  * \li Action: 
  * \li Notion: 
  * \li Syntax: 
  * \li Params: 
+ * \li Sample:
  * \li Origin: 
  */
 
@@ -102,165 +103,224 @@ void LyXAction::init()
 
        ev_item const items[] = {
 #endif
-/**
- * \li Action: adds an acute accent (á) to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_ACUTE, "accent-acute", Noop, Edit },
-/**
- * \li Action: adds a breve accent to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_BREVE, "accent-breve", Noop, Edit },
-/**
- * \li Action: adds a caron to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_CARON, "accent-caron", Noop, Edit },
-/**
- * \li Action: adds a cedilla (ç) to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_CEDILLA, "accent-cedilla", Noop, Edit },
-/**
- * \li Action: adds a circle accent (Å) to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_CIRCLE, "accent-circle", Noop, Edit },
-/**
- * \li Action: adds a circumflex (â) to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_CIRCUMFLEX, "accent-circumflex", Noop, Edit },
-/**
- * \li Action: adds a dot accent to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_DOT, "accent-dot", Noop, Edit },
-/**
- * \li Action: adds a grave accent (à) to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_GRAVE, "accent-grave", Noop, Edit },
-/**
- * \li Action: adds a Hungarian umlaut to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_HUNGARIAN_UMLAUT, "accent-hungarian-umlaut", Noop, Edit },
-/**
- * \li Action: adds a macron to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_MACRON, "accent-macron", Noop, Edit },
-/**
- * \li Action: adds an ogonek accent to the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_OGONEK, "accent-ogonek", Noop, Edit },
                { LFUN_ACCENT_SPECIAL_CARON, "accent-special-caron", Noop, Edit },
-/**
- * \li Action: adds a tie over the next two character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_TIE, "accent-tie", Noop, Edit },
-/**
- * \li Action: adds a tilde (ñ) over the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_TILDE, "accent-tilde", Noop, Edit },
-/**
- * \li Action: adds an umlaut (ö) over the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_UMLAUT, "accent-umlaut", Noop, Edit },
-/**
- * \li Action: adds a bar under the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_UNDERBAR, "accent-underbar", Noop, Edit },
-/**
- * \li Action: adds a dot under the next character typed
+/*!
+ * \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
  */
                { LFUN_ACCENT_UNDERDOT, "accent-underdot", Noop, Edit },
 
-/**
- * \li Action: Breaks the current paragraph at the current location
+/*!
+ * \var lyx::kb_action lyx::LFUN_BREAK_PARAGRAPH
+ * \li Action: Breaks the current paragraph at the current location.
  * \li Syntax: break-paragraph
  */
                { 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
  */
                { 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
  */
                { LFUN_CAPTION_INSERT, "caption-insert", Noop, Edit },
-/**
- * \li Action: Inserts the current date
- * \li Syntax: date-insert <ARG>
- * \li Param: <ARG>: Strangely, this is inserted verbatim, no matter
-                     what it is.
+/*!
+ * \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
+                     in Preferences->Date format. For possible formats
+                     see manual page of strftime function.
+ * \li Origin: jdblair, 31 Jan 2000
  */
                { 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
  */
                { 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
  */
                { 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
  */
                { 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
  */
                { 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
  */
                { 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
  */
                { 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
  */
                { 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
  */
                { 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
  */
                { 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
  */
                { LFUN_LISTING_INSERT, "listing-insert", Noop, Edit },
                { LFUN_QUOTE_INSERT, "quote-insert", Noop, Edit },
@@ -290,9 +350,9 @@ 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 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
@@ -300,9 +360,9 @@ void LyXAction::init()
  * \li Origin: Abdelrazak Younes, Dec 27 2007
  */
                { LFUN_SCROLL, "scroll", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_SCREEN_RECENTER
- * \li Action: Recenters the screen on the current cursor position
+ * \li Action: Recenters the screen on the current cursor position.
  * \li Syntax: screen-recenter
  */
                { LFUN_SCREEN_RECENTER, "screen-recenter", ReadOnly, Edit },
@@ -310,15 +370,85 @@ void LyXAction::init()
                { 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,
+               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.
+ * \li Syntax: char-backward
+ */
                { 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
+ */
                { 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,
+               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.
+ * \li Syntax: char-forward
+ */
                { 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
+ */
                { 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
+               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.
+ * \li Syntax: char-left
+ */
                { 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
+ */
                { 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
+               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.
+ * \li Syntax: char-right
+ */
                { 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
+ */
                { LFUN_CHAR_RIGHT_SELECT, "char-right-select", ReadOnly | SingleParUpdate, Edit },
 
                { LFUN_WORD_BACKWARD, "word-backward", ReadOnly | NoUpdate, Edit },
@@ -339,7 +469,7 @@ 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
@@ -359,54 +489,54 @@ 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
  */
                { 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
  */
                { 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 Action: Copies to the clipboard the last edit.
  * \li Syntax: copy
  */
                { LFUN_COPY, "copy", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_CUT
- * \li Action: Cuts to the clipboard
+ * \li Action: Cuts to the clipboard.
  * \li Syntax: cut
  */
                { LFUN_CUT, "cut", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_PASTE
- * \li Action: Pastes from the active clipboard
+ * \li Action: Pastes from the active clipboard.
  * \li Syntax: paste
  */
                { 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 Action: Pastes the material currently selected.
  * \li Syntax: primary-selection-paste
  */
                { LFUN_PRIMARY_SELECTION_PASTE, "primary-selection-paste", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_UNDO
- * \li Action: Undoes the last edit
+ * \li Action: Undoes the last edit.
  * \li Syntax: undo
  */
                { LFUN_UNDO, "undo", Noop, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_REDO
- * \li Action: Redoes the last thing undone
+ * \li Action: Redoes the last thing undone.
  * \li Syntax: redo
  */
                { LFUN_REDO, "redo", Noop, Edit },
@@ -447,48 +577,48 @@ 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 Action: Sets the layout (that is, environment) for the current paragraph.
  * \li Syntax: layout <LAYOUT>
  * \li Params: <LAYOUT>: the layout to use
  */
                { LFUN_LAYOUT, "layout", Noop, Layout },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LAYOUT_PARAGRAPH
- * \li Action: Launches the paragraph settings dialog
+ * \li Action: Launches the paragraph settings dialog.
  * \li Syntax: layout-paragraph
  */
                { 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 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
+               dropbox allowing for choice of layout.
  * \li Syntax: drop-layouts-choice
  */
                { 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 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
  */
                { LFUN_LAYOUT_MODULES_CLEAR, "layout-modules-clear", Noop, Layout },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LAYOUT_MODULE_ADD
- * \li Action: Adds a module
+ * \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
  */
                { LFUN_LAYOUT_MODULE_ADD, "layout-module-add", Noop, Layout },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_LAYOUT_RELOAD
- * \li Action: Reloads layout information
+ * \li Action: Reloads layout information.
  * \li 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
@@ -497,37 +627,37 @@ void LyXAction::init()
  * \li Origin: rgh, 3 September 2007
  */
                { 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 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.
  */
                { 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 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.
  */
                { 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
  */
                { 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
  */
                { 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
@@ -548,7 +678,7 @@ 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.
@@ -556,7 +686,7 @@ void LyXAction::init()
  * \li Origin: Alejandro 18 Jun 1996
  */
                { 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 Notion: Must be in display formula mode.
@@ -566,28 +696,28 @@ void LyXAction::init()
                { 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 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
  */
                { 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 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
  */
                { 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
+ * \li Action: Add a parameter.
+ * \li Notion: Add a parameter to a Math Macro.
  * \li Params: <NUM>: The number of the parameter behind which the new one
                will be added (1 for the first, i.e. use 0 for add a
                parameter at the left), defaults to the last one.
@@ -595,9 +725,9 @@ void LyXAction::init()
  * \li Origin: sts, 06 January 2008
  */
                { 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 Action: Remove the last parameter.
  * \li Notion: Remove the last parameter of a Math Macro and
                remove its value in all instances of the macro
                in the buffer.
@@ -607,9 +737,9 @@ void LyXAction::init()
  * \li Origin: sts, 06 January 2008
  */
                { 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 Action: Append a greedy parameter.
  * \li Notion: Append a greedy parameter to a Math Macro which
                eats the following mathed cell in every instance of
                the macro in the buffer.
@@ -617,9 +747,9 @@ void LyXAction::init()
  * \li Origin: sts, 06 January 2008
  */
                { 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 Action: Remove a greedy parameter.
  * \li Notion: Remove a greedy parameter of a Math Macro and spit
                out the values of it in every instance of the macro
                in the buffer. If it is an optional parameter the [valud]
@@ -628,18 +758,18 @@ void LyXAction::init()
  * \li Origin: sts, 06 January 2008
  */
                { 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 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
  */
                { 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 Action: Make a parameter non-optional.
  * \li Notion: Turn the last optional parameter of a Math Macro
                into a non-optional parameter. The default value is
                remembered to be reused later if the user changes his mind.
@@ -647,27 +777,27 @@ void LyXAction::init()
  * \li Origin: sts, 06 January 2008
  */
                { 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 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
  */
                { 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 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
  */
                { 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 Action: Add a greedy optional parameter.
  * \li Notion: Add a greedy optional parameter which eats the value
                from the following cells in mathed which are in the [value]
                format.
@@ -675,9 +805,9 @@ void LyXAction::init()
  * \li Origin: sts, 06 January 2008
  */
                { 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 Action: Only active in Math Macro definition.
  * \li Notion: Dummy function which is only active in a Math Macro definition.
                It's used to toggle the Math Macro toolbar if the cursor moves
                into a Math Macro definition.
@@ -689,7 +819,7 @@ void LyXAction::init()
                { 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.
@@ -699,7 +829,7 @@ void LyXAction::init()
  * \li Origin: Vermeer, 23 Mar 2006
  */
                { 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.
@@ -709,7 +839,7 @@ void LyXAction::init()
  * \li Origin: Vermeer, 23 Mar 2006
  */
                { 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.
@@ -718,7 +848,7 @@ void LyXAction::init()
  * \li Origin: Vermeer, 23 Mar 2006
  */
                { 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.
@@ -767,9 +897,9 @@ void LyXAction::init()
                { 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 Action: Change paragraph settings.
  * \li Notion: Modifies the current paragraph, or currently selected paragraphs.
                This function only modifies, and does not override, existing settings.
                Note that the "leftindent" indent setting is deprecated.
@@ -781,21 +911,50 @@ void LyXAction::init()
  * \li Origin: rgh, Aug 15 2007
  */
                { 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
  */
                { 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
+               movement in the surrounding text. This action should be called
+               automatically by the cursor movement within the inset, when
+               movement within the inset has ceased (reached the end of the
+               last paragraph, for example), in order to move correctly
+               back into the surrounding text.
+ * \li Syntax: finished-forward
+ */
                { 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
+ */
                { 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
+ */
                { 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
+ */
                { LFUN_FINISHED_LEFT, "", ReadOnly, Hidden },
 
                { LFUN_LANGUAGE, "language", Noop, Edit },
@@ -804,9 +963,9 @@ 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 Action: Goto a bookmark.
  * \li Notion: Moves the cursor to the numbered bookmark, opening the file
                if necessary. Note that bookmarsk are saved per-session, not
                per file.
@@ -815,9 +974,9 @@ void LyXAction::init()
  * \li Origin: Dekel, 27 January 2001
  */
                { LFUN_BOOKMARK_GOTO, "bookmark-goto", NoBuffer, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BOOKMARK_SAVE
- * \li Action: Save a bookmark
+ * \li Action: Save a bookmark.
  * \li 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.
@@ -826,18 +985,18 @@ void LyXAction::init()
  * \li Origin: Dekel, 27 January 2001
  */
                { LFUN_BOOKMARK_SAVE, "bookmark-save", ReadOnly, Edit },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BOOKMARK_CLEAR
- * \li Action: Clears the list of saved bookmarks
+ * \li Action: Clears the list of saved bookmarks.
  * \li Syntax: bookmark-clear
  * \li Origin: bpeng, 31 October 2006
  */
                { 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 Action: Terminates the current LyX instance.
  * \li Notion: Terminates the current LyX instance, asking whether to save
                modified documents, etc.
  * \li Syntax: lyx-quit
@@ -882,9 +1041,9 @@ void LyXAction::init()
 
                { 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 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
@@ -894,21 +1053,54 @@ void LyXAction::init()
                { 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 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
  */
                { 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.\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.
+ * \li Origin: Lgb, 29 Jul 1997
+ */
                { LFUN_BUFFER_EXPORT, "buffer-export", ReadOnly, Buffer },
                { 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
+ */
                { 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
+ */
                { 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 Action: Creates a new buffer (that is, document).
  * \li Syntax: buffer-new
  */
                { LFUN_BUFFER_NEW, "buffer-new", NoBuffer, Buffer },
@@ -917,9 +1109,9 @@ void LyXAction::init()
                { LFUN_BUFFER_SWITCH, "buffer-switch", NoBuffer | ReadOnly, Buffer },
                { 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 Action: Displays current buffer in chosen format.
  * \li Notion: Displays the contents of the current buffer in the chosen
                format, for example, PDF or DVI. This runs the necessary
                converter, calls the defined viewer, and so forth.
@@ -929,16 +1121,16 @@ void LyXAction::init()
                          Tools>Preferences>File Formats dialog.
  */
                { LFUN_BUFFER_VIEW, "buffer-view", ReadOnly, Buffer },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_BUFFER_WRITE
- * \li Action: Saves the current buffer
+ * \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
  */
                { 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>
@@ -961,12 +1153,11 @@ void LyXAction::init()
                { LFUN_FILE_NEW, "file-new", NoBuffer, Buffer },
                { LFUN_FILE_OPEN, "file-open", NoBuffer, Buffer },
 
-               { LFUN_META_PREFIX, "meta-prefix", NoBuffer, System },
 
-/**
+/*!
  * \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).
@@ -980,28 +1171,62 @@ void LyXAction::init()
  * \li Origin: broider, 2 Oct 2007
  */
                { 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
+ */
+               { 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
+ */
                { 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
+ */
                { 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
+ */
                { 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
  */
                { 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
  */
                { 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.
+ */
                { LFUN_LYXRC_APPLY, "lyxrc-apply", NoBuffer, System },
-/**
+/*!
  * \var lyx::kb_action lyx::LFUN_TOGGLE_CURSOR_FOLLOWS_SCROLLBAR
  * \li Action: Determine whether keep cursor inside the editing window regardless
                the scrollbar movement.
@@ -1009,7 +1234,7 @@ void LyXAction::init()
  * \li Origin: ARRae, 2 Dec 1997
  */
                { LFUN_TOGGLE_CURSOR_FOLLOWS_SCROLLBAR, "toggle-cursor-follows-scrollbar", 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.
@@ -1018,7 +1243,7 @@ void LyXAction::init()
  * \li Origin: SLior, 11 Jun 2000
  */
                { 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.