]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/LFUNs.lyx
Intro.lyx:
[lyx.git] / lib / doc / LFUNs.lyx
index 561da60374bc78f0386b850b58fdc388467083ac..262bdc308c5cc268e1ea6ca46aa71d26c086ecd6 100644 (file)
@@ -2,11 +2,18 @@
 \lyxformat 345
 \begin_document
 \begin_header
-\textclass amsart
+\textclass article
+\begin_preamble
+\renewcommand{\descriptionlabel}[1]{\hspace\labelsep\upshape\bfseries #1:}
+\renewenvironment{description}{\list{}{%
+  \setlength{\itemsep}{-2pt}
+  \advance\leftmargini6\p@ \itemindent-12\p@
+  \labelwidth\z@ \let\makelabel\descriptionlabel}%
+}{
+  \endlist
+}
+\end_preamble
 \use_default_options false
-\begin_modules
-theorems-ams
-\end_modules
 \language english
 \inputencoding auto
 \font_roman default
@@ -20,6 +27,7 @@ theorems-ams
 
 \graphics default
 \paperfontsize default
+\spacing single
 \use_hyperref false
 \papersize default
 \use_geometry true
@@ -49,7 +57,7 @@ theorems-ams
 \begin_body
 
 \begin_layout Section*
-LFUNs documentation automatically generated 2009-05-23
+LFUNs documentation automatically generated 2010-01-03
 \end_layout
 
 \begin_layout Standard
@@ -512,11 +520,41 @@ Notion Apart from lfun arguments you can use the following method:
 Syntax info-insert <TYPE> <ARG>
 \end_layout
 \begin_layout Description
-Params <TYPE>: shortcut|lyxrc|package|textclass|menu|buffer
+Params <TYPE>: shortcut[s]|lyxrc|package|textclass|menu|buffer
 \begin_inset Newline newline
 \end_inset
 
 <ARG>: argument for a given type. Look into InsetInfo.h for detailed description.
+\begin_inset Newline newline
+\end_inset
+
+                     shortcut[s]: name of lfun (e.g math-insert 
+\backslash
+alpha)
+\begin_inset Newline newline
+\end_inset
+
+                     lyxrc: name of rc_entry (e.g. bind_file)
+\begin_inset Newline newline
+\end_inset
+
+                     package: name of latex package (e.g. listings)
+\begin_inset Newline newline
+\end_inset
+
+                     textclass: name of textclass (e.g. article)
+\begin_inset Newline newline
+\end_inset
+
+                     menu: name of lfun used in menu 
+\begin_inset Newline newline
+\end_inset
+
+                     icon: name of lfun used in toolbar
+\begin_inset Newline newline
+\end_inset
+
+                     buffer: "name"|"path"|"class"
 \end_layout
 \begin_layout Description
 Sample command-sequence info-insert buffer path; info-insert buffer name
@@ -1186,11 +1224,11 @@ Action Replace a string in the document.
 Syntax word-replace [<DATA>]
 \end_layout
 \begin_layout Description
-Params <DATA>: data is of the form "<search>
+Params <DATA>: data is of the form "<replace>
 \begin_inset Newline newline
 \end_inset
 
-<replace>
+<search>
 \begin_inset Newline newline
 \end_inset
 
@@ -1457,6 +1495,19 @@ Syntax inset-end-select
 Origin lasgouttes, 16 Mar 2009
 \end_layout
 
+\begin_layout Subsection*
+LFUN_INSET_SELECT_ALL
+\end_layout
+\begin_layout Description
+Action Selects all contents of an inset.
+\end_layout
+\begin_layout Description
+Syntax inset-select-all
+\end_layout
+\begin_layout Description
+Origin vfr, 22 Aug 2009
+\end_layout
+
 \begin_layout Subsection*
 LFUN_LINE_BEGIN
 \end_layout
@@ -2169,6 +2220,15 @@ LFUN_MATH_INSERT
 Action Inserts math objects and symbols.
 \end_layout
 \begin_layout Description
+Notion When <ARG> is a _single_ math inset with more than one cell (such as "x_y^z" or "
+\backslash
+frac{x}{y}"), the content of cell(0) is replaced by the current selection (only works if the selection is in mathed). As an example, if "abc" is selected in mathed, "math-insert 
+\backslash
+frac{x}{y}" replaces "abc" with "
+\backslash
+frac{abc}{y}", and "math-insert x_y^z" replaces "abc" with "abc_y^z". If nothing is selected (or the selection is not in mathed), math-insert works as expected.
+\end_layout
+\begin_layout Description
 Syntax math-insert <ARG>
 \end_layout
 \begin_layout Description
@@ -2308,6 +2368,22 @@ Params <ALIGN>: Alignment is a word composed of the vertical alignment (b, c or
 Sample math-matrix 3 3 bccc
 \end_layout
 
+\begin_layout Subsection*
+LFUN_MATH_AMS_MATRIX
+\end_layout
+\begin_layout Description
+Action Inserts a matrix.
+\end_layout
+\begin_layout Description
+Syntax math-matrix <COLS> <ROWS> [<DECORATION>]
+\end_layout
+\begin_layout Description
+Params <DECORATION>: Decoration determines the LaTeX name of the matrix that should be created.
+\end_layout
+\begin_layout Description
+Sample math-ams-matrix 3 3 bmatrix
+\end_layout
+
 \begin_layout Subsection*
 LFUN_MATH_MODE
 \end_layout
@@ -2318,10 +2394,14 @@ Action In text mode enters math mode (i.e. puts math insets on the current curso
 Notion If there is some selected text, it puts the text inside created math box.
 \end_layout
 \begin_layout Description
-Syntax math-mode [<ARG>]
+Syntax math-mode [on|<ARG>]
 \end_layout
 \begin_layout Description
 Params <ARG>: eventual argument (LaTeX code) is passed to LFUN_MATH_INSERT .
+\begin_inset Newline newline
+\end_inset
+
+"on": allow only entering of math mode from text mode.
 \end_layout
 \begin_layout Description
 Origin Alejandro, 4 Jun 1996
@@ -2750,16 +2830,6 @@ Params <PAR_ID_NUMBER>:  paragraph id
 Origin Dekel, 26 Aug 2000
 \end_layout
 
-\begin_layout Subsection*
-LFUN_BREAK_PARAGRAPH
-\end_layout
-\begin_layout Description
-Action Breaks the current paragraph at the current location.
-\end_layout
-\begin_layout Description
-Syntax break-paragraph
-\end_layout
-
 \begin_layout Subsection*
 LFUN_BREAK_PARAGRAPH
 \end_layout
@@ -2803,7 +2873,7 @@ leftindent LENGTH
 
 <SPACING>: 
 \backslash
-paragraph_spacing default|single|onehalf|double|other
+paragraph_spacing default|single|onehalf|double|other SIZE
 \begin_inset Newline newline
 \end_inset
 
@@ -2919,6 +2989,29 @@ Syntax outline-out
 Origin Vermeer, 23 Mar 2006
 \end_layout
 
+\begin_layout Subsection*
+LFUN_OUTLINE_DRAGMOVE
+\end_layout
+\begin_layout Description
+Action Moves the document section associated with the specified heading to a specified location. Both the heading and the target paragraph are specified by the paragraph ID numbers.
+\end_layout
+\begin_layout Description
+Notion The heading is a paragraph with style Part/Chapter/Section/ etc. Id number of the paragraph is not the sequential number seen on the screen, but an internal number that is unique for all opened buffers (documents).
+\end_layout
+\begin_layout Description
+Syntax outline-dragmove <PAR_ID_SECTION> <PAR_ID_DROP_POSITION>
+\end_layout
+\begin_layout Description
+Params <PAR_ID_SECTION>: paragraph id of the section heading which is to be moved.
+\begin_inset Newline newline
+\end_inset
+
+<PAR_ID_DROP_POSITION>: the paragraph id where the section will be moved to.
+\end_layout
+\begin_layout Description
+Origin Rob Oakes, 22 June 2009
+\end_layout
+
 \begin_layout Subsection*
 LFUN_INSET_EDIT
 \end_layout
@@ -2968,7 +3061,7 @@ Notion Various math-environment features are handled here as well, e.g. add-vlin
 Syntax tabular-feature <FEATURE> [<ARG>]
 \end_layout
 \begin_layout Description
-Params <FEATURE>: append-row|append-column|delete-row|delete-column|copy-row|copy-column| toggle-line-top|toggle-line-bottom|toggle-line-left|toggle-line-right| align-left|align-right|align-center|align-block|valign-top|valign-bottom| valign-middle|m-align-left|m-align-right|m-align-center|m-valign-top| m-valign-bottom|m-valign-middle|multicolumn|set-all-lines|unset-all-lines| set-longtabular|unset-longtabular|set-pwidth|set-mpwidth| set-rotate-tabular|unset-rotate-tabular|toggle-rotate-tabular| set-rotate-cell|unset-rotate-cell|toggle-rotate-cell|set-usebox|set-lthead| unset-lthead|set-ltfirsthead|unset-ltfirsthead|set-ltfoot|unset-ltfoot| set-ltlastfoot|unset-ltlastfoot|set-ltnewpage|toggle-ltcaption| set-special-column|set-special-multi|set-booktabs|unset-booktabs| set-top-space|set-bottom-space|set-interline-space|set-border-lines| tabular-valign-top|tabular-valign-middle|tabular-valign-bottom
+Params <FEATURE>: append-row|append-column|delete-row|delete-column|copy-row|copy-column| toggle-line-top|toggle-line-bottom|toggle-line-left|toggle-line-right| align-left|align-right|align-center|align-block|valign-top|valign-bottom| valign-middle|longtabular-align-left|longtabular-align-center| longtabular-align-right|m-align-left|m-align-right|m-align-center| m-valign-top|m-valign-bottom|m-valign-middle|multicolumn|set-all-lines| unset-all-lines|set-longtabular|unset-longtabular|set-pwidth|set-mpwidth| set-rotate-tabular|unset-rotate-tabular|toggle-rotate-tabular| set-rotate-cell|unset-rotate-cell|toggle-rotate-cell|set-usebox|set-lthead| unset-lthead|set-ltfirsthead|unset-ltfirsthead|set-ltfoot|unset-ltfoot| set-ltlastfoot|unset-ltlastfoot|set-ltnewpage|toggle-ltcaption| set-special-column|set-special-multi|set-booktabs|unset-booktabs| set-top-space|set-bottom-space|set-interline-space|set-border-lines| tabular-valign-top|tabular-valign-middle|tabular-valign-bottom
 \begin_inset Newline newline
 \end_inset
 
@@ -3142,6 +3235,38 @@ Sample vc-command DR $$p "svn up"
 Origin sanda, 13 Jan 2009
 \end_layout
 
+\begin_layout Subsection*
+LFUN_VC_LOCKING_TOGGLE
+\end_layout
+\begin_layout Description
+Action Toggles the locking property of the edited file.
+\end_layout
+\begin_layout Description
+Notion This is currently implemented only for SVN.
+\end_layout
+\begin_layout Description
+Syntax vc-locking-toggle
+\end_layout
+\begin_layout Description
+Origin sanda, 25 Jun 2009
+\end_layout
+
+\begin_layout Subsection*
+LFUN_VC_REPO_UPDATE
+\end_layout
+\begin_layout Description
+Action Update the local archive directory in which resides the current document with the remote repository.
+\end_layout
+\begin_layout Description
+Notion This is currently implemented only for SVN.
+\end_layout
+\begin_layout Description
+Syntax vc-repo-update
+\end_layout
+\begin_layout Description
+Origin sanda, 16 Oct 2009
+\end_layout
+
 \begin_layout Subsection*
 LFUN_CHANGES_TRACK
 \end_layout
@@ -3462,6 +3587,19 @@ Params <STATE>: <toggle|open|close|assign> default: toggle
 Origin leeming, 30 Mar 2004
 \end_layout
 
+\begin_layout Subsection*
+LFUN_GRAPHICS_RELOAD
+\end_layout
+\begin_layout Description
+Action Reloads the image if necessary.
+\end_layout
+\begin_layout Description
+Syntax graphics-reload
+\end_layout
+\begin_layout Description
+Origin vfr, 10 Aug 2009
+\end_layout
+
 \begin_layout Subsection*
 LFUN_SET_GRAPHICS_GROUP
 \end_layout
@@ -3675,7 +3813,7 @@ LFUN_TOOLBAR_TOGGLE
 Action Toggles visibility of a given toolbar between on/off/auto.
 \end_layout
 \begin_layout Description
-Notion Skiping "auto" when allowauto is false.
+Notion Skipping "auto" when allowauto is false.
 \end_layout
 \begin_layout Description
 Syntax toolbar-toggle <NAME> [allowauto]
@@ -3817,11 +3955,11 @@ Params <NAME>: aboutlyx|bibitem|bibtex|box|branch|changes|character|citation|
 \begin_inset Newline newline
 \end_inset
 
-document|errorlist|ert|external|file|findreplace|findreplaceadv|float|graphics|
+compare|document|errorlist|ert|external|file|findreplace|findreplaceadv|float|
 \begin_inset Newline newline
 \end_inset
 
-href|include|index|index_print|info|label|listings|log|mathdelimiter|
+graphics|href|include|index|index_print|info|label|listings|log|mathdelimiter|
 \begin_inset Newline newline
 \end_inset
 
@@ -4085,11 +4223,11 @@ Notion This can be useful for DVI inverse-search or detection of the problematic
 Syntax server-goto-file-row <FILE[.ext]> <ROW_NUMBER>
 \end_layout
 \begin_layout Description
-Params <FILE>: the filename. Environment variables are expaned in the path. In case this LFUN does not work make sure you are giving correct path to the file.
+Params <FILE>: the filename. Environment variables are expanded in the path. In case this LFUN does not work make sure you are giving correct path to the file.
 \begin_inset Newline newline
 \end_inset
 
-If the file is located inside LyX temporary directory it will be mapped back into the appropriate opened buffer (e.g. for the case of generated .tex file). .ext: extensions will be automatically replaced by .lyx.
+If the file is located inside LyX temporary directory it will be mapped back into the appropriate opened buffer (e.g. for the case of generated .tex file). .ext: extensions will be automatically replaced by .lyx. <ROW_NUMBER> The row number of the LaTeX file to which to go.
 \end_layout
 \begin_layout Description
 Origin Edmar, 23 Dec 1998
@@ -4236,6 +4374,19 @@ Notion Closes the current buffer, asking whether to save it, etc, if the buffer
 Syntax buffer-close
 \end_layout
 
+\begin_layout Subsection*
+LFUN_BUFFER_CLOSE_ALL
+\end_layout
+\begin_layout Description
+Action Closes all buffers.
+\end_layout
+\begin_layout Description
+Notion Closes all buffers, asking whether to save it, etc, if a buffer has been modified.
+\end_layout
+\begin_layout Description
+Syntax buffer-close-all
+\end_layout
+
 \begin_layout Subsection*
 LFUN_BUFFER_EXPORT
 \end_layout
@@ -4393,11 +4544,7 @@ LFUN_BUFFER_TOGGLE_READ_ONLY
 Action Toggle editing mode of the current document between read/write and read-only.
 \end_layout
 \begin_layout Description
-Notion In the ->Readonly mode checks-in/commits the data if the file is under version control. In the Readonly-> mode checkouts the data from repository.
-\begin_inset Newline newline
-\end_inset
-
-If these operations fail, buffer won't be toggled.
+Notion This function is not allowed if the file is under version control, since read-only flag is often used in version control file locking.
 \end_layout
 \begin_layout Description
 Syntax buffer-toggle-read-only
@@ -4702,7 +4849,7 @@ Syntax cancel
 LFUN_COMMAND_EXECUTE
 \end_layout
 \begin_layout Description
-Action Opens the minibuffer toolbar so that the user can type in there.
+Action Switches the focus to the minibuffer so that the user can type in there. If necessary, it opens the minibuffer toolbar.
 \end_layout
 \begin_layout Description
 Notion Usually bound to M-x shortcut.
@@ -4784,6 +4931,22 @@ Syntax message <STRING>
 Origin Lgb, 8 Apr 2001
 \end_layout
 
+\begin_layout Subsection*
+LFUN_DEBUG_LEVEL_SET
+\end_layout
+\begin_layout Description
+Action Set debug output level.
+\end_layout
+\begin_layout Description
+Syntax debug-level-set <LEVEL>
+\end_layout
+\begin_layout Description
+Params <LEVEL>: comma separated list of levels or the correspondent number of their combination. 0 is equivalent to disabling all debug events. See lyx -dbg for the current list of debug levels and their numbers.
+\end_layout
+\begin_layout Description
+Origin sanda, 28 Dec 2009
+\end_layout
+
 \begin_layout Subsection*
 LFUN_PREFERENCES_SAVE
 \end_layout
@@ -4911,7 +5074,7 @@ Origin sts, Feb 19 2008
 LFUN_COMPLETION_CANCEL
 \end_layout
 \begin_layout Description
-Action Try to cancel completion, either the popup or the inline completion
+Action Try to cancel completion, either the popup or the inline completion.
 \end_layout
 \begin_layout Description
 Syntax completion-cancel
@@ -4933,11 +5096,27 @@ Syntax completion-accept
 Origin sanda, Sep 08 2008
 \end_layout
 
+\begin_layout Subsection*
+LFUN_BRANCH_ADD
+\end_layout
+\begin_layout Description
+Action Add a branch to the buffer's BranchList.
+\end_layout
+\begin_layout Description
+Syntax branch-add <BRANCH>
+\end_layout
+\begin_layout Description
+Params <BRANCH>: Name of the branch to add
+\end_layout
+\begin_layout Description
+Origin spitz, 7 Jul 2009
+\end_layout
+
 \begin_layout Subsection*
 LFUN_BRANCH_ACTIVATE
 \end_layout
 \begin_layout Description
-Action Activate the branch
+Action Activate the branch.
 \end_layout
 \begin_layout Description
 Syntax branch-activate <BRANCH>
@@ -4960,7 +5139,7 @@ Origin rgh, 27 May 2008
 LFUN_BRANCH_DEACTIVATE
 \end_layout
 \begin_layout Description
-Action De-activate the branch
+Action De-activate the branch.
 \end_layout
 \begin_layout Description
 Syntax branch-deactivate <BRANCH>
@@ -4972,6 +5151,38 @@ Params <BRANCH>: The branch to deactivate
 Origin rgh, 27 May 2008
 \end_layout
 
+\begin_layout Subsection*
+LFUN_BRANCHES_RENAME
+\end_layout
+\begin_layout Description
+Action Rename all branches of a given name in a document.
+\end_layout
+\begin_layout Description
+Syntax branches-rename <OLDNAME> <NEWNAME>
+\end_layout
+\begin_layout Description
+Params <OLDNAME>: Current name of the branch to be renamed <NEWNAME>: New name of the branch
+\end_layout
+\begin_layout Description
+Origin spitz, 9 Jul 2009
+\end_layout
+
+\begin_layout Subsection*
+LFUN_BRANCH_ADD_INSERT
+\end_layout
+\begin_layout Description
+Action Create new branch and directly put the branch inset into the document.
+\end_layout
+\begin_layout Description
+Syntax branch-add-insert [<NAME>]
+\end_layout
+\begin_layout Description
+Params <NAME>: Branch name. If it is not specified, you will be asked.
+\end_layout
+\begin_layout Description
+Origin sanda, 10 Jul 2009
+\end_layout
+
 \begin_layout Subsection*
 LFUN_LABEL_COPY_AS_REF
 \end_layout