aboutsummaryrefslogtreecommitdiff
path: root/modules/textadept/adeptsense.lua
diff options
context:
space:
mode:
authormitchell <70453897+667e-11@users.noreply.github.com>2012-10-29 20:45:58 -0400
committermitchell <70453897+667e-11@users.noreply.github.com>2012-10-29 20:45:58 -0400
commitfa38d2306fadc99bb1403433517ecf45a24062eb (patch)
tree19f286adb6be4cbd7a1b11fc1c880976a01ea9fd /modules/textadept/adeptsense.lua
parent6718de08a3f19f8c24c1c4167b05828a7ac0dfd7 (diff)
downloadtextadept-fa38d2306fadc99bb1403433517ecf45a24062eb.tar.gz
textadept-fa38d2306fadc99bb1403433517ecf45a24062eb.zip
Updated documentation formatting.
Pathnames and filenames are italic and be more consistent with constant width text.
Diffstat (limited to 'modules/textadept/adeptsense.lua')
-rw-r--r--modules/textadept/adeptsense.lua26
1 files changed, 13 insertions, 13 deletions
diff --git a/modules/textadept/adeptsense.lua b/modules/textadept/adeptsense.lua
index 245dc23f..0f8f15a3 100644
--- a/modules/textadept/adeptsense.lua
+++ b/modules/textadept/adeptsense.lua
@@ -82,7 +82,7 @@ local M = {}
-- #### `symbol_chars`
--
-- In addition to the usual `[%w_%.]` symbol characters, Lua also allows symbols
--- to contain a `:`.
+-- to contain a ':'.
--
-- sense.syntax.symbol_chars = '[%w_%.:]'
--
@@ -109,7 +109,7 @@ local M = {}
-- ['^([%w_%.]+)'] = '%1' -- foo = _M.textadept.adeptsense
-- }
--
--- Note the `^` in the pattern. The beginning of the right hand side of the
+-- Note the '^' in the pattern. The beginning of the right hand side of the
-- assignment should be matched, otherwise `local foo = bar('baz')` could infer
-- an incorrect type.
--
@@ -139,7 +139,7 @@ local M = {}
-- in your shell. Since Adeptsense only cares about classes, functions, and
-- fields, you need to let it know which kind of tag is which. Unfortunately,
-- Lua support in Ctags is not good at all. Instead, Textadept has a utility
--- (`modules/lua/adeptsensedoc.lua`) to generate a fake set of tags that is more
+-- (*modules/lua/adeptsensedoc.lua*) to generate a fake set of tags that is more
-- useful. Functions are tagged `'f'` and should be recognized as such; table
-- keys are tagged `'t'` and should be recognized as fields; module fields,
-- `'F'`, should be fields; and modules, `'m'`, should be classes:
@@ -170,8 +170,8 @@ local M = {}
-- ### Triggers
--
-- Triggers are characters or character sequences that trigger an autocompletion
--- list to be displayed. Lua has two characters that can do so: `.` and `:`. The
--- `.` should autocomplete both fields and functions while `:` should
+-- list to be displayed. Lua has two characters that can do so: '.' and ':'. The
+-- '.' should autocomplete both fields and functions while ':' should
-- autocomplete only functions. This is specified using
-- [`add_trigger()`](#add_trigger).
--
@@ -235,7 +235,7 @@ local M = {}
-- end
--
-- Note that there is no plus or minus prefix in the pattern. This is because
--- `+` or `-` characters are not a part of `syntax.symbol_chars` so a symbol
+-- '+' or '-' characters are not a part of `syntax.symbol_chars` so a symbol
-- will not contain either of them.
--
-- Like numbers, the syntax for constructing strings, arrays, hashes, and the
@@ -260,7 +260,7 @@ local M = {}
--
-- Since Adeptsense ignores any tags not mapped to `classes`, `functions`, or
-- `fields` in [`ctags_kinds`](#ctags_kinds), it passes an unknown tag to the
--- [`handle_ctag()`](#handle_ctag) function. In this case, package (`p`) tags
+-- [`handle_ctag()`](#handle_ctag) function. In this case, package ('p') tags
-- need to be handled.
--
-- function sense:handle_ctag(tag_name, file_name, ex_cmd, ext_fields)
@@ -275,7 +275,7 @@ local M = {}
-- end
--
-- Now that we have a list of import completions, it should be activated by the
--- normal trigger (`.`), but only on a line that contains an `import` statement.
+-- normal trigger ('.'), but only on a line that contains an `import` statement.
-- The [`get_completions`](#get_completions) function needs to be overridden to
-- use the `import` table's completions when necessary.
--
@@ -319,7 +319,7 @@ local M = {}
-- Adeptsense. For example, when editing CSS inside of an HTML file, the user
-- expects the CSS Adeptsense to be used. However, child language Adeptsenses
-- are not loaded automatically and must be loaded by the parent language
--- module. For the case of CSS in HTML, the HTML module's `init.lua` must
+-- module. For the case of CSS in HTML, the HTML module's *init.lua* must
-- contain:
--
-- -- Load CSS Adeptsense.
@@ -331,11 +331,11 @@ local M = {}
-- ### Generating Lua Adeptsense
--
-- You can generate Lua Adeptsense for your own modules using the Lua language
--- module's `adeptsensedoc.lua` module with [LuaDoc][]:
+-- module's *adeptsensedoc.lua* module with [LuaDoc][]:
--
-- luadoc -d . --doclet _HOME/modules/lua/adeptsensedoc [module(s)]
--
--- where `_HOME` is where Textadept is installed. The `tags` and `api` files are
+-- where `_HOME` is where Textadept is installed. The *tags* and *api* files are
-- output to the current directory and can be loaded via
-- [`load_ctags()`](#load_ctags) and [`api_files`](#api_files) respectively.
--
@@ -930,8 +930,8 @@ locations = {},
-- there may be many duplicate symbol names, it is recommended to put the full
-- symbol and arguments, if any, on the first line. (e.g. `Class.function(arg1,
-- arg2, ...)`). This allows the correct documentation to be shown based on the
--- current context. In the documentation, newlines are represented with `\n`. A
--- `\` before `\n` escapes the newline.
+-- current context. In the documentation, newlines are represented with "\n". A
+-- '\' before "\n" escapes the newline.
-- @class table
-- @name api_files
api_files = {},