aboutsummaryrefslogtreecommitdiff
path: root/core/._G.lua
diff options
context:
space:
mode:
Diffstat (limited to 'core/._G.lua')
-rw-r--r--core/._G.lua74
1 files changed, 74 insertions, 0 deletions
diff --git a/core/._G.lua b/core/._G.lua
new file mode 100644
index 00000000..2d78dc2e
--- /dev/null
+++ b/core/._G.lua
@@ -0,0 +1,74 @@
+-- Copyright 2007-2010 Mitchell mitchell<att>caladbolg.net. See LICENSE.
+-- This is a DUMMY FILE used for making LuaDoc for built-in functions in the
+-- _G table.
+
+--- Extends Lua's _G table to provide extra functions and fields.
+module('_G')
+
+-- Markdown:
+-- ## Fields
+--
+-- * `_HOME`: Path to the directory containing Textadept.
+-- * `_LEXERPATH`: Paths to lexers, formatted like
+-- [`package.path`][package_path].
+-- * `_RELEASE`: The Textadept release version.
+-- * `_THEME`: The [theme][theme] file to use.
+-- * `_USERHOME`: Path to the user's `~/.textadept/`.
+-- * `_CHARSET`: The character set encoding of the filesystem. This is used in
+-- [File I/O][file_io].
+-- * `RESETTING`: If [`reset()`][reset] has been called,
+-- this flag is `true` while the Lua state is being re-initialized.
+-- * `WIN32`: If Textadept is running on Windows, this flag is `true`.
+-- * `MAC`: If Textadept is running on Mac OSX, this flag is `true`.
+--
+-- [package_path]: http://www.lua.org/manual/5.1/manual.html#pdf-package.path
+-- [theme]: ../manual/6_Startup.html
+-- [file_io]: ../modules/io.html
+-- [reset]: ../modules/_G.html#reset
+
+---
+-- Command line parameters.
+-- @class table
+-- @name arg
+arg = {}
+
+
+---
+-- A numerically indexed table of open buffers in Textadept.
+-- @class table
+-- @name _BUFFERS
+_BUFFERS = {}
+
+---
+-- A numerically indexed table of views in Textadept.
+-- @class table
+-- @name _VIEWS
+_VIEWS = {}
+
+---
+-- Creates a new buffer.
+-- Activates the 'buffer_new' signal.
+-- @return the new buffer.
+function new_buffer() end
+
+---
+-- Resets the Lua state by reloading all init scripts.
+-- Language-specific modules for opened files are NOT reloaded. Re-opening the
+-- files that use them will reload those modules.
+-- This function is useful for modifying init scripts (such as key_commands.lua)
+-- on the fly without having to restart Textadept.
+-- A global RESETTING variable is set to true when re-initing the Lua State. Any
+-- scripts that need to differentiate between startup and reset can utilize this
+-- variable.
+function reset() end
+
+--- Quits Textadept.
+function quit() end
+
+---
+-- Calls 'dofile' on the given filename in the user's Textadept directory.
+-- This is typically used for loading user files like key commands or snippets.
+-- Errors are printed to the Textadept message buffer.
+-- @param filename The name of the file (not path).
+-- @return true if successful; false otherwise.
+function user_dofile(filename) end