Contents

_M.textadept.editing

Editing commands for the textadept module.


Fields


AUTOINDENT (bool)

Match the indentation level of the previous line when pressing the Enter key. The default value is true.


AUTOPAIR (bool)

Opening (, [, [, ", or ' characters are automatically closed. The default value is true.


HIGHLIGHT_BRACES (bool)

Highlight matching ()[]{} characters. The default value is true.


INDIC_HIGHLIGHT_ALPHA (number)

The alpha transparency value between 0 (transparent) and 255 (opaque) used for an indicator for a highlighted word. The default value is 100.


INDIC_HIGHLIGHT_BACK (number)

The color used for an indicator for a highlighted word in 0xBBGGRR format.


MARK_HIGHLIGHT_BACK (number)

The background color used for a line containing a highlighted word in 0xBBGGRR format.


STRIP_WHITESPACE_ON_SAVE (bool)

Strip trailing whitespace on file save. The default value is true.


Functions


autocomplete_word (word_chars, default_words)

Pops up an autocompletion list for the current word based on other words in the document.

Parameters:

Return:


block_comment (comment)

Block comments or uncomments code with a given comment string. If none is specified, uses the comment_string table.

Parameters:

See also:


convert_indentation ()

Converts indentation between tabs and spaces.


enclose (left, right)

Encloses text within a given pair of strings. If text is selected, it is enclosed. Otherwise, the previous word is enclosed.

Parameters:


goto_line (line)

Goes to the requested line.

Parameters:


grow_selection (amount)

Grows the selection by a character amount on either end.

Parameters:


highlight_word ()

Highlights all occurances of the word under the caret and adds markers to the lines they are on.


join_lines ()

Joins the currently selected lines. If no lines are selected, joins the current line with the line below.


match_brace (select)

Goes to a matching brace position, selecting the text inside if specified to.

Parameters:


prepare_for_save ()

Prepares the buffer for saving to a file. Strips trailing whitespace off of every line if STRIP_WHITESPACE_ON_SAVE is true, ensures an ending newline, and converts non-consistent EOLs.

See also:


select_enclosed (left, right)

Selects text between a given pair of strings.

Parameters:


select_indented_block ()

Selects indented blocks intelligently. If no block of text is selected, all text with the current level of indentation is selected. If a block of text is selected and the lines to the top and bottom of it are one indentation level lower, they are added to the selection. In all other cases, the behavior is the same as if no text is selected.


select_line ()

Selects the current line.


select_paragraph ()

Selects the current paragraph. Paragraphs are delimited by two or more consecutive newlines.


select_word ()

Selects the current word under the caret.


transpose_chars ()

Transposes characters intelligently. If the caret is at the end of a line, the two characters before the caret are transposed. Otherwise, the characters to the left and right are.


Tables


braces

Highlighted brace characters. Keys are lexer language names and values are tables of characters that count as brace characters. This table can be populated by language-specific modules. The defaults are ‘(’, ‘)’, ‘[’, ‘]’, ‘{’, and ‘}’.

Usage:

See also:


char_matches

Auto-matched characters. Used for auto-matching parentheses, brackets, braces, quotes, etc. Keys are lexer language names and values are tables of character match pairs. This table can be populated by language-specific modules. The defaults are ‘()’, ‘[]’, ‘{}’, ‘’‘’, and ‘“”’.

Usage:

See also:


comment_string

Comment strings for various lexer languages. Used by the block_comment() function. Keys are lexer language names and values are the line comment delimiters for the language. This table is typically populated by language-specific modules.

See also: