diff options
Diffstat (limited to 'doc/10_Advanced.md')
-rw-r--r-- | doc/10_Advanced.md | 44 |
1 files changed, 17 insertions, 27 deletions
diff --git a/doc/10_Advanced.md b/doc/10_Advanced.md index adae9ad7..1009733e 100644 --- a/doc/10_Advanced.md +++ b/doc/10_Advanced.md @@ -4,17 +4,20 @@ Access to the Lua state is available through the command entry. Press `Ctrl+E` (`⌘E` on Mac OSX | `M-C` in ncurses) to access it. It is useful for debugging, -inspecting, and entering buffer or view commands. If you try to cause +inspecting, and entering `buffer` or `view` commands. If you try to cause instability in Textadept's Lua state, you might very well succeed so be careful. -For more information, see the [scripting][] 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()`][]. Use `_G.print()` for Lua's `print()`. +For available commands, see the [Lua API][]. Abbreviated commands for +[`buffer`][], [`view`][] and [`gui`][] are available: the command +`buffer:append_text('foo')` can be shortened to `append_text('foo')`. As a +result, use `_G.print()` for Lua's `print()` since [`gui.print()`][] is +shortened to `print()`. ![Command Entry](images/commandentry.png) -[scripting]: 11_Scripting.html +[Lua API]: api/index.html +[`buffer`]: api/buffer.html +[`view`]: api/view.html +[`gui`]: api/gui.html [`gui.print()`]: api/gui.html#print ### Tab Completion @@ -38,12 +41,15 @@ the implementation. If you did not disable the menu in your [preferences][], then pressing `Ctrl+Shift+E` (`⌘⇧E` on Mac OSX | `M-S-C` in ncurses) brings up the command -selection dialog. Typing part of any command filters the list with spaces being +selection dialog. Typing part of any command filters the list, with spaces being wildcards. This is an easy way to run commands without navigating the menus, -using the mouse, or remembering key commands. It is also useful for looking up -particular key commands quickly. +using the mouse, or remembering key bindings. It is also useful for looking up +particular key bindings quickly. Note: the key bindings in the dialog do not +look like those in the menu. This different notation is how bindings are +represented internally. You can learn more about this in the [keys LuaDoc]. -[preferences]: 9_Preferences.html#User.Init +[preferences]: 08_Preferences.html#User.Init +[keys LuaDoc]: api/keys.html ## Shell Commands and Filtering Text @@ -67,19 +73,3 @@ The standard input (stdin) for shell commands is determined as follows: * If no text is selected, the entire buffer is used. The input text is replaced with the standard output (stdout) of the command. - -## 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`][]. - -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. - -[`io.try_encodings`]: api/io.html#try_encodings |