Contents

_G

Extends Lua’s _G table to provide extra functions and fields for Textadept.


Fields


CURSES (bool)

If Textadept is running in the terminal, this flag is true. Curses feature incompatibilities are listed in the Appendix.


OSX (bool)

If Textadept is running on Mac OSX, this flag is true.


RESETTING (bool)

If reset() has been called, this flag is true while the Lua state is being re-initialized.


WIN32 (bool)

If Textadept is running on Windows, this flag is true.


_CHARSET (string)

The character set encoding of the filesystem. This is used when working with files.


_HOME (string)

The path to the directory containing Textadept.


_LEXERPATH (string)

The paths to lexers, formatted like Lua’s package.path.


_RELEASE (string)

The Textadept release version string.


_USERHOME (string)

The path to the user’s ~/.textadept/ directory, where all preferences and user-data is stored. On Windows machines ~/ is the value of the “USERHOME” environment variable, typically C:\Users\username\ or C:\Documents and Settings\username\. On Linux, BSD, and Mac OSX machines ~/ is the value of “$HOME”, typically /home/username/ and /Users/username/ respectively.


Functions


quit()

Emits a QUIT event, and unless any handler returns false, quits Textadept.

See also:


reset()

Resets the Lua state by reloading all initialization scripts. Language-specific modules for opened files are NOT reloaded. Re-opening the files that use them will reload those modules instead. This function is useful for modifying user scripts (such as ~/.textadept/init.lua and ~/.textadept/modules/textadept/keys.lua) on the fly without having to restart Textadept. _G.RESETTING is set to true when re-initing the Lua State. Any scripts that need to differentiate between startup and reset can utilize this variable.

See also:


timeout(interval, f, …)

Calls the function f with the given arguments after interval seconds and then repeatedly while f returns true. A nil or false return value stops repetition.

Parameters:


Tables


_BUFFERS

Table of all open buffers in Textadept. Numeric keys have buffer values and buffer keys have their associated numeric keys.

Usage:

See also:


_VIEWS

Table of all views in Textadept. Numeric keys have view values and view keys have their associated numeric keys.

Usage:

See also:


arg

Table of command line parameters passed to Textadept.

See also:


buffer

The current buffer in the current view.


view

The currently focused view.