diff options
Diffstat (limited to 'doc/manual/10_Advanced.md')
| -rw-r--r-- | doc/manual/10_Advanced.md | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/doc/manual/10_Advanced.md b/doc/manual/10_Advanced.md new file mode 100644 index 00000000..86387fca --- /dev/null +++ b/doc/manual/10_Advanced.md @@ -0,0 +1,46 @@ +# Advanced + +## Command Entry + +Access to the Lua state is available through the command entry. Press `F2` to +access it. It is useful for debugging, inspecting, and entering buffer or view +commands. If you try cause instability in Textadept's Lua state, you might very +well succeed so be careful. For more information, see the +[scripting](11_Scripting.html) page. + +Abbreviated commands for the `buffer`, `view` and `gui` are available. So +`buffer:append_text('foo')` can be shortened to `append_text('foo')`. `print()` +redirects to [`gui.print()`](../modules/gui.html#print). Use `_G.print()` for +Lua's `print()`. + + + +#### Tab Completion + +Tab-completion for functions, variables, tables, etc. is available. Press the +`Tab` key to display a list of available completions. Use the arrow keys to make +a selection and press `Enter` to insert it. + + + +#### Extending + +You can extend the command entry to do more than enter Lua commands. An +example of this is [incremental +search](../modules/gui.find.html#find_incremental). See +`modules/textadept/find.lua` for the implementation. + +## File Encoding + +Textadept represents all characters and strings internally as UTF-8. You will +not notice any difference for working with files containing ASCII text since +UTF-8 is compatible with it. Textadept can also detect ISO-8859-1 and MacRoman, +the primary encodings used on Windows and Mac OSX respectively. Files with more +exotic encodings may not be detected properly, if at all. You can change the +list of encodings Textadept tries to detect via +[`io.try_encodings`](../modules/io.html#try_encodings). + +It is recommended to use UTF-8 encoded files because UTF-8 is very well +supported by other text editors and operating systems. You can change the file's +encoding via the `Buffer -> Encoding` menu. Textadept saves new files as UTF-8 +by default. |