diff --git a/api/editor.html b/api/editor.html index 27c5de90..6ffe4369 100644 --- a/api/editor.html +++ b/api/editor.html @@ -390,8 +390,8 @@

Creates a new Editor object.

-

Arguments

rendererVirtualRenderer

Required. Associated VirtualRenderer that draws everything

-
sessionEditSession

Required. The EditSession to refer to

+

Arguments

rendererVirtualRenderer

Required. Associated VirtualRenderer that draws everything

+
sessionEditSession

Required. The EditSession to refer to

@@ -444,7 +444,7 @@

Emitted whenever the document is changed.

-

Arguments

eObject

Required. Contains a single property, data, which has the delta of changes

+

Arguments

eObject

Required. Contains a single property, data, which has the delta of changes

@@ -471,7 +471,7 @@

Emitted when the selection style changes, via Editor.setSelectionStyle().

-

Arguments

dataObject

Required. Contains one property, data, which indicates the new selection style

+

Arguments

dataObject

Required. Contains one property, data, which indicates the new selection style

@@ -498,7 +498,7 @@

Emitted whenever the EditSession changes.

-

Arguments

eObject

Required. An object with two properties, oldSession and session, that represent the old and new EditSessions.

+

Arguments

eObject

Required. An object with two properties, oldSession and session, that represent the old and new EditSessions.

@@ -525,7 +525,7 @@

Emitted when text is copied.

-

Arguments

textString

Required. The copied text

+

Arguments

textString

Required. The copied text

@@ -564,7 +564,7 @@
    • -
    • Editor.on("paste", function(String text))
    • +
    • Editor.on("paste", function(Object e))
    @@ -577,7 +577,7 @@

    Emitted when text is pasted.

    -

    Arguments

    textString

    Required. The pasted text

    +

    Arguments

    eObject

    Required. An object which contains one property, text, that represents the text to be pasted. Editing this property will alter the text that is pasted.

    @@ -610,7 +610,7 @@

    Adds the selection and cursor.

    -

    Arguments

    orientedRangeRange

    Required. A range containing a cursor

    +

    Arguments

    orientedRangeRange

    Required. A range containing a cursor

    @@ -920,9 +920,9 @@

    Attempts to find needle within the document. For more information on options, see Search.

    -

    Arguments

    needleString

    Required. The text to search for (optional)

    -
    optionsObject

    Required. An object defining various search properties

    -
    animateBoolean

    Required. If true animate scrolling

    +

    Arguments

    needleString

    Required. The text to search for (optional)

    +
    optionsObject

    Required. An object defining various search properties

    +
    animateBoolean

    Required. If true animate scrolling

    @@ -954,9 +954,9 @@

    Finds and selects all the occurences of needle.

    -

    Arguments

    TheString

    Required. text to find

    -
    TheObject

    Required. search options

    -
    keepsBoolean

    Required.

    +

    Arguments

    TheString

    Required. text to find

    +
    TheObject

    Required. search options

    +
    keepsBoolean

    Required.

    @@ -983,8 +983,8 @@

    Performs another search for needle in the document. For more information on options, see Search.

    -

    Arguments

    optionsObject

    Required. search options

    -
    animateBoolean

    Required. If true animate scrolling

    +

    Arguments

    optionsObject

    Required. search options

    +
    animateBoolean

    Required. If true animate scrolling

    @@ -1011,8 +1011,8 @@

    Performs a search for needle backwards. For more information on options, see Search.

    -

    Arguments

    optionsObject

    Required. search options

    -
    animateBoolean

    Required. If true animate scrolling

    +

    Arguments

    optionsObject

    Required. search options

    +
    animateBoolean

    Required. If true animate scrolling

    @@ -1064,8 +1064,8 @@

    Executes a command for each selection range.

    -

    Arguments

    cmdString

    Required. The command to execute

    -
    argsString

    Required. Any arguments for the command

    +

    Arguments

    cmdString

    Required. The command to execute

    +
    argsString

    Required. Any arguments for the command

    @@ -1523,8 +1523,8 @@

    Works like EditSession.getTokenAt(), except it returns a number.

    -

    Arguments

    rowObject

    Required.

    -
    columnObject

    Required.

    +

    Arguments

    rowObject

    Required.

    +
    columnObject

    Required.

    @@ -1966,9 +1966,9 @@

    Moves the cursor to the specified line number, and also into the indiciated column.

    -

    Arguments

    lineNumberNumber

    Required. The line number to go to

    -
    columnNumber

    Required. A column number to go to

    -
    animateBoolean

    Required. If true animates scolling

    +

    Arguments

    lineNumberNumber

    Required. The line number to go to

    +
    columnNumber

    Required. A column number to go to

    +
    animateBoolean

    Required. If true animates scolling

    @@ -2070,7 +2070,7 @@

    Inserts text into wherever the cursor is pointing.

    -

    Arguments

    textString

    Required. The new text to add

    +

    Arguments

    textString

    Required. The new text to add

    @@ -2132,7 +2132,7 @@

    Indicates if the entire row is currently visible on the screen.

    -

    Arguments

    rowNumber

    Required. The row to check

    +

    Arguments

    rowNumber

    Required. The row to check

    @@ -2164,7 +2164,7 @@

    Indicates if the row is currently visible on the screen.

    -

    Arguments

    rowNumber

    Required. The row to check

    +

    Arguments

    rowNumber

    Required. The row to check

    @@ -2191,7 +2191,7 @@

    Moves the cursor's row and column to the next matching bracket.

    -

    Arguments

    selectObject

    Required.

    +

    Arguments

    selectObject

    Required.

    @@ -2218,7 +2218,7 @@

    If the character before the cursor is a number, this functions changes its value by amount.

    -

    Arguments

    amountNumber

    Required. The value to change the numeral by (can be negative to decrease value)

    +

    Arguments

    amountNumber

    Required. The value to change the numeral by (can be negative to decrease value)

    @@ -2245,8 +2245,8 @@

    Moves the cursor to the specified row and column. Note that this does not de-select the current selection.

    -

    Arguments

    rowNumber

    Required. The new row number

    -
    columnNumber

    Required. The new column number

    +

    Arguments

    rowNumber

    Required. The new row number

    +
    columnNumber

    Required. The new column number

    @@ -2273,7 +2273,7 @@

    Moves the cursor to the position indicated by pos.row and pos.column.

    -

    Arguments

    posObject

    Required. An object with two properties, row and column

    +

    Arguments

    posObject

    Required. An object with two properties, row and column

    @@ -2384,7 +2384,7 @@

    Moves the cursor down in the document the specified number of times. Note that this does de-select the current selection.

    -

    Arguments

    timesNumber

    Required. The number of times to change navigation

    +

    Arguments

    timesNumber

    Required. The number of times to change navigation

    @@ -2461,7 +2461,7 @@

    Moves the cursor left in the document the specified number of times. Note that this does de-select the current selection.

    -

    Arguments

    timesNumber

    Required. The number of times to change navigation

    +

    Arguments

    timesNumber

    Required. The number of times to change navigation

    @@ -2538,7 +2538,7 @@

    Moves the cursor right in the document the specified number of times. Note that this does de-select the current selection.

    -

    Arguments

    timesNumber

    Required. The number of times to change navigation

    +

    Arguments

    timesNumber

    Required. The number of times to change navigation

    @@ -2565,8 +2565,8 @@

    Moves the cursor to the specified row and column. Note that this does de-select the current selection.

    -

    Arguments

    rowNumber

    Required. The new row number

    -
    columnNumber

    Required. The new column number

    +

    Arguments

    rowNumber

    Required. The new row number

    +
    columnNumber

    Required. The new column number

    @@ -2593,7 +2593,7 @@

    Moves the cursor up in the document the specified number of times. Note that this does de-select the current selection.

    -

    Arguments

    timesNumber

    Required. The number of times to change navigation

    +

    Arguments

    timesNumber

    Required. The number of times to change navigation

    @@ -3105,7 +3105,7 @@

    Called whenever a text "paste" happens.

    -

    Arguments

    textString

    Required. The pasted text

    +

    Arguments

    textString

    Required. The pasted text

    @@ -3277,7 +3277,7 @@

    Removes words of text from the editor. A "word" is defined as a string of characters bookended by whitespace.

    -

    Arguments

    dirString

    Required. The direction of the deletion to occur, either "left" or "right"

    +

    Arguments

    dirString

    Required. The direction of the deletion to occur, either "left" or "right"

    @@ -3329,7 +3329,7 @@

    Removes the selection marker.

    -

    Arguments

    TheRange

    Required. selection range added with addSelectionMarker().

    +

    Arguments

    TheRange

    Required. selection range added with addSelectionMarker().

    @@ -3456,8 +3456,8 @@

    Replaces the first occurance of options.needle with the value in replacement.

    -

    Arguments

    replacementString

    Required. The text to replace with

    -
    optionsObject

    Required. The Search options to use

    +

    Arguments

    replacementString

    Required. The text to replace with

    +
    optionsObject

    Required. The Search options to use

    @@ -3484,8 +3484,8 @@

    Replaces all occurances of options.needle with the value in replacement.

    -

    Arguments

    replacementString

    Required. The text to replace with

    -
    optionsObject

    Required. The Search options to use

    +

    Arguments

    replacementString

    Required. The text to replace with

    +
    optionsObject

    Required. The Search options to use

    @@ -3512,7 +3512,7 @@

    Triggers a resize of the editor.

    -

    Arguments

    forceBoolean

    Required. If true, recomputes the size, even if the height and width haven't changed

    +

    Arguments

    forceBoolean

    Required. If true, recomputes the size, even if the height and width haven't changed

    @@ -3613,10 +3613,10 @@

    Scrolls to a line. If center is true, it puts the line in middle of screen (or attempts to).

    -

    Arguments

    lineNumber

    Required. The line to scroll to

    -
    centerBoolean

    Required. If true

    -
    animateBoolean

    Required. If true animates scrolling

    -
    callbackFunction

    Required. Function to be called when the animation has finished

    +

    Arguments

    lineNumber

    Required. The line to scroll to

    +
    centerBoolean

    Required. If true

    +
    animateBoolean

    Required. If true animates scrolling

    +
    callbackFunction

    Required. Function to be called when the animation has finished

    @@ -3643,7 +3643,7 @@

    Moves the editor to the specified row.

    -

    Arguments

    rowObject

    Required.

    +

    Arguments

    rowObject

    Required.

    @@ -3695,8 +3695,8 @@

    Finds the next occurence of text in an active selection and adds it to the selections.

    -

    Arguments

    dirNumber

    Required. The direction of lines to select: -1 for up, 1 for down

    -
    skipBoolean

    Required. If true, removes the active selection range

    +

    Arguments

    dirNumber

    Required. The direction of lines to select: -1 for up, 1 for down

    +
    skipBoolean

    Required. If true, removes the active selection range

    @@ -3723,8 +3723,8 @@

    Adds a cursor above or below the active cursor.

    -

    Arguments

    dirNumber

    Required. The direction of lines to select: -1 for up, 1 for down

    -
    skipBoolean

    Required. If true, removes the active selection range

    +

    Arguments

    dirNumber

    Required. The direction of lines to select: -1 for up, 1 for down

    +
    skipBoolean

    Required. If true, removes the active selection range

    @@ -3825,7 +3825,7 @@

    Specifies whether to use behaviors or not. "Behaviors" in this case is the auto-pairing of special characters, like quotation marks, parenthesis, or brackets.

    -

    Arguments

    enabledBoolean

    Required. Enables or disables behaviors

    +

    Arguments

    enabledBoolean

    Required. Enables or disables behaviors

    @@ -3876,7 +3876,7 @@

    Sets the delay (in milliseconds) of the mouse drag.

    -

    Arguments

    dragDelayNumber

    Required. A value indicating the new delay

    +

    Arguments

    dragDelayNumber

    Required. A value indicating the new delay

    @@ -3927,7 +3927,7 @@

    Set a new font size (in pixels) for the editor text.

    -

    Arguments

    sizeNumber

    Required. A font size

    +

    Arguments

    sizeNumber

    Required. A font size

    @@ -3954,7 +3954,7 @@

    Determines whether or not the current line should be highlighted.

    -

    Arguments

    shouldHighlightBoolean

    Required. Set to true to highlight the current line

    +

    Arguments

    shouldHighlightBoolean

    Required. Set to true to highlight the current line

    @@ -4005,7 +4005,7 @@

    Determines if the currently selected word should be highlighted.

    -

    Arguments

    shouldHighlightBoolean

    Required. Set to true to highlight the currently selected word

    +

    Arguments

    shouldHighlightBoolean

    Required. Set to true to highlight the currently selected word

    @@ -4032,7 +4032,7 @@

    Sets a new key handler, such as "vim" or "windows".

    -

    Arguments

    keyboardHandlerString

    Required. The new key handler

    +

    Arguments

    keyboardHandlerString

    Required. The new key handler

    @@ -4059,7 +4059,7 @@

    Pass in true to enable overwrites in your session, or false to disable. If overwrites is enabled, any text you enter will type over any text after it. If the value of overwrite changes, this function also emites the changeOverwrite event.

    -

    Arguments

    overwriteBoolean

    Required. Defines wheter or not to set overwrites

    +

    Arguments

    overwriteBoolean

    Required. Defines wheter or not to set overwrites

    @@ -4086,7 +4086,7 @@

    Sets the column defining where the print margin should be.

    -

    Arguments

    showPrintMarginNumber

    Required. Specifies the new print margin

    +

    Arguments

    showPrintMarginNumber

    Required. Specifies the new print margin

    @@ -4113,7 +4113,7 @@

    If readOnly is true, then the editor is set to read-only mode, and none of the content can change.

    -

    Arguments

    readOnlyBoolean

    Required. Specifies whether the editor can be modified or not

    +

    Arguments

    readOnlyBoolean

    Required. Specifies whether the editor can be modified or not

    @@ -4140,7 +4140,7 @@

    Sets how fast the mouse scrolling should do.

    -

    Arguments

    speedNumber

    Required. A value indicating the new speed (in milliseconds)

    +

    Arguments

    speedNumber

    Required. A value indicating the new speed (in milliseconds)

    @@ -4170,7 +4170,7 @@ although this code change in the future.

    This function also emits the 'changeSelectionStyle' event.

    -

    Arguments

    styleString

    Required. The new selection style

    +

    Arguments

    styleString

    Required. The new selection style

    @@ -4197,7 +4197,7 @@ although this code change in the future.

    Sets a new editsession to use. This method also emits the 'changeSession' event.

    -

    Arguments

    sessionEditSession

    Required. The new session to use

    +

    Arguments

    sessionEditSession

    Required. The new session to use

    @@ -4224,7 +4224,7 @@ although this code change in the future.

    Indicates whether the fold widgets are shown or not.

    -

    Arguments

    showBoolean

    Required. Specifies whether the fold widgets are shown

    +

    Arguments

    showBoolean

    Required. Specifies whether the fold widgets are shown

    @@ -4251,7 +4251,7 @@ although this code change in the future.

    If showInvisibles is set to true, invisible characters—like spaces or new lines—are show in the editor.

    -

    Arguments

    showInvisiblesBoolean

    Required. Specifies whether or not to show invisible characters

    +

    Arguments

    showInvisiblesBoolean

    Required. Specifies whether or not to show invisible characters

    @@ -4278,7 +4278,7 @@ although this code change in the future.

    If showPrintMargin is set to true, the print margin is shown in the editor.

    -

    Arguments

    showPrintMarginBoolean

    Required. Specifies whether or not to show the print margin

    +

    Arguments

    showPrintMarginBoolean

    Required. Specifies whether or not to show the print margin

    @@ -4305,7 +4305,7 @@ although this code change in the future.

    Adds a new class, style, to the editor.

    -

    Arguments

    styleString

    Required. A class name

    +

    Arguments

    styleString

    Required. A class name

    @@ -4332,7 +4332,7 @@ although this code change in the future.

    Sets a new theme for the editor. theme should exist, and be a directory path, like ace/theme/textmate.

    -

    Arguments

    themeString

    Required. The path to a theme

    +

    Arguments

    themeString

    Required. The path to a theme

    @@ -4364,8 +4364,8 @@ although this code change in the future.

    Sets the current document to val.

    -

    Arguments

    valString

    Required. The new value to set for the document

    -
    cursorPosNumber

    Required. Where to set the new value. undefined or 0 is selectAll, -1 is at the document start, and 1 is at the end

    +

    Arguments

    valString

    Required. The new value to set for the document

    +
    cursorPosNumber

    Required. Where to set the new value. undefined or 0 is selectAll, -1 is at the document start, and 1 is at the end

    @@ -4394,7 +4394,7 @@ when such a character is typed in.

    Specifies whether to use wrapping behaviors or not, i.e. automatically wrapping the selection with characters such as brackets when such a character is typed in.

    -

    Arguments

    enabledBoolean

    Required. Enables or disables wrapping behaviors

    +

    Arguments

    enabledBoolean

    Required. Enables or disables wrapping behaviors

    @@ -4595,7 +4595,7 @@ when such a character is typed in.

    Transposes the selected ranges.

    -

    Arguments

    dirNumber

    Required. The direction to rotate selections

    +

    Arguments

    dirNumber

    Required. The direction to rotate selections

    @@ -4647,7 +4647,7 @@ when such a character is typed in.

    Removes the class style from the editor.

    -

    Arguments

    styleObject

    Required.

    +

    Arguments

    styleObject

    Required.

    diff --git a/lib/ace/editor.js b/lib/ace/editor.js index 20a04987..9d911410 100644 --- a/lib/ace/editor.js +++ b/lib/ace/editor.js @@ -888,7 +888,7 @@ var Editor = function(renderer, session) { /** * Emitted when text is pasted. * @event paste - * @param {String} text The pasted text + * @param {Object} an object which contains one property, `text`, that represents the text to be pasted. Editing this property will alter the text that is pasted. * * **/