diff options
Diffstat (limited to 'doc/06_AdeptEditing.md')
| -rw-r--r-- | doc/06_AdeptEditing.md | 90 |
1 files changed, 52 insertions, 38 deletions
diff --git a/doc/06_AdeptEditing.md b/doc/06_AdeptEditing.md index 30deac58..b8a5789a 100644 --- a/doc/06_AdeptEditing.md +++ b/doc/06_AdeptEditing.md @@ -22,9 +22,10 @@ to disable this. ## Word Completion Textadept provides buffer-based word completion. Start typing a word, press -`Ctrl+Return` (`^⎋` on Mac OSX), and a list of suggested completions based on -words in the current document is provided. Continuing to type changes the -suggestion. Press `Return` (`↩`) to complete the selected word. +`Ctrl+Return` (`^⎋` on Mac OSX | `M-Enter` in ncurses), and a list of suggested +completions based on words in the current document is provided. Continuing to +type changes the suggestion. Press `Enter` (`↩` | `Enter`) to complete the +selected word.  @@ -33,8 +34,8 @@ suggestion. Press `Return` (`↩`) to complete the selected word. Textadept has the capability to autocomplete symbols for programming languages and display API documentation. Lua is of course supported extremely well and other languages have basic support with the help of [ctags][]. Symbol completion -is available by pressing `Ctrl+Space` (`⌥⎋` on Mac OSX). Documentation for -symbols is available with `Ctrl+H` (`^H`). +is available by pressing `Ctrl+Space` (`⌥⎋` on Mac OSX | `^Space` in ncurses). +Documentation for symbols is available with `Ctrl+H` (`^H` | `M-H` or `M-S-H`).  @@ -50,38 +51,45 @@ the [LuaDoc][]. ## Find and Replace -`Ctrl+F` (`⌘F` on Mac OSX) brings up the Find/Replace dialog. In addition to -offering the usual find and replace, Textadept allows you to find with [Lua -patterns][] and replace with Lua captures and even Lua code! For example: -replacing all `(%w+)` with `%(string.upper('%1'))` capitalizes all words in the -buffer. Lua captures (`%n`) are only available from a Lua pattern search, but -embedded Lua code enclosed in `%()` is always allowed. +`Ctrl+F` (`⌘F` on Mac OSX | `M-F` or `M-S-F` in ncurses) brings up the +Find/Replace dialog. In addition to offering the usual find and replace, +Textadept allows you to find with [Lua patterns][] and replace with Lua captures +and even Lua code! For example: replacing all `(%w+)` with +`%(string.upper('%1'))` capitalizes all words in the buffer. Lua captures (`%n`) +are only available from a Lua pattern search, but embedded Lua code enclosed in +`%()` is always allowed. Note the `Ctrl+G`, `Ctrl+Shift+G`, `Ctrl+Alt+R`, `Ctrl+Alt+Shift+R` key commands for find next, find previous, replace, and replace all (`⌘G`, `⌘⇧G`, `^R`, `^⇧R` -respectively on Mac OSX) only work when the Find/Replace dialog is hidden. When -it is visible, use the button mnemonics: `Alt+N`, `Alt+P`, `Alt+R`, and `Alt+A` -(`⌘N`, `⌘P`, `⌘R`, `⌘A`) for English locale. +respectively on Mac OSX | `M-G`, `M-S-G`, `M-R`, `M-S-R` in ncurses) only work +when the Find/Replace dialog is hidden. When it is visible in the GUI version, +use the button mnemonics: `Alt+N`, `Alt+P`, `Alt+R`, and `Alt+A` (`⌘N`, `⌘P`, +`⌘R`, `⌘A` | N/A) for English locale. + +In the ncurses version, use `Tab` and `S-Tab` to toggle between the find next, +find previous, replace, and replace all buttons; `Up` and `Down` arrows switch +between the find and replace text fields; `^P` and `^N` cycles through history; +and `F1-F4` toggles find options. [Lua patterns]: 14_Appendix.html#Lua.Patterns ### Find in Files -`Ctrl+Shift+F` brings up Find in Files (`⌘⇧F` on Mac OSX) and will prompt for a -directory to search. The results are displayed in a new buffer. Double-clicking -a search result jumps to it in the file. You can also use the `Ctrl+Alt+G` and -`Ctrl+Alt+Shift+G` (`^⌘G` and `^⌘⇧G` on Mac OSX) key commands. Replace in Files -is not supported. You will have to `Find in Files` first, and then `Replace All` -for each file a result is found in. The `Match Case`, `Whole Word`, and -`Lua pattern` flags still apply. +`Ctrl+Shift+F` brings up Find in Files (`⌘⇧F` on Mac OSX | none in ncurses) and +will prompt for a directory to search. The results are displayed in a new +buffer. Double-clicking a search result jumps to it in the file. You can also +use the `Ctrl+Alt+G` and `Ctrl+Alt+Shift+G` (`^⌘G` and `^⌘⇧G` on Mac OSX | none +in ncurses) key commands. Replace in Files is not supported. You will have to +`Find in Files` first, and then `Replace All` for each file a result is found +in. The `Match Case`, `Whole Word`, and `Lua pattern` flags still apply.  ### Find Incremental -You can start an incremental search by pressing `Ctrl+Alt+F` (`^⌘F` on Mac OSX). -Incremental search searches the buffer as you type. Only the `Match Case` option -is recognized. Pressing `Esc` (`⎋`) stops it. +You can start an incremental search by pressing `Ctrl+Alt+F` (`^⌘F` on Mac OSX | +`M-^F` in ncurses). Incremental search searches the buffer as you type. Only the +`Match Case` option is recognized. Pressing `Esc` (`⎋` | `Esc`) stops it. ### Replace in Selection @@ -94,8 +102,9 @@ then `Replace All`. ### Change Indent Level The amount of indentation for a selected set of lines is increased by pressing -`Tab` (`⇥`) and decreased by pressing `Shift+Tab` (`⇧⇥`). Using these key -sequences when no selection is present does not have the same effect. +`Tab` (`⇥` | `Tab`) and decreased by pressing `Shift+Tab` (`⇧⇥` | `S-Tab`). +Using these key sequences when no selection is present does not have the same +effect. ### Change Indent Size @@ -111,8 +120,9 @@ Textadept shows what it is using for indentation in the document statusbar. ### Using Tabs You can use tabs instead of the default spaces by pressing `Ctrl+Alt+Shift+T` -(`^⇧T` on Mac OSX) or using the `Buffer -> Toggle Use Tabs` menu. Textadept -shows what it is using for indentation in the document statusbar. +(`^⇧T` on Mac OSX | `M-T` or `M-S-T` in ncurses) or using the `Buffer -> Toggle +Use Tabs` menu. Textadept shows what it is using for indentation in the document +statusbar. The default option is usually set by a [language-specific module][] or the [theme][]. @@ -130,8 +140,9 @@ all tabs are converted to spaces. ### Rectangular Selection -Holding `Alt+Shift` (`⌥⇧` on Mac OSX) and pressing the arrow keys enables -rectangular selections to be made. Start typing to type on each line. +Holding `Alt+Shift` (`⌥⇧` on Mac OSX | `M-S` in ncurses) and pressing the arrow +keys enables rectangular selections to be made. Start typing to type on each +line.  @@ -143,14 +154,15 @@ Clicking the mouse at a point in the buffer while holding `Control` places an additional caret at that point. Clicking and dragging while holding `Control` creates multiple selections. Start typing to enter text at each selection. -This is currently unavailable on Mac OSX. +This is currently unavailable on Mac OSX and in ncurses. ### Selecting Entities Textadept allows you to select many different entities from the caret. For -example, `Ctrl+"` (`^"` on Mac OSX) selects all characters in a `""` sequence. -Typing `Ctrl++` (`^+`) as a follow-up selects the double-quotes too. See the -`Edit -> Select In...` menu for available entities and their key commands. +example, `Ctrl+"` (`^"` on Mac OSX | `M-"` in ncurses) selects all characters in +a `""` sequence. Typing `Ctrl++` (`^+` | `M-+`) as a follow-up selects the +double-quotes too. See the `Edit -> Select In...` menu for available entities +and their key commands. ## Enclosing Text @@ -163,8 +175,10 @@ If no text is selected, the word to the left of the caret is enclosed. ## Word Highlight All occurrences of a given word are highlighted by putting the caret over the -word and pressing `Ctrl+Alt+Shift+H` (`⌘⇧H` on Mac OSX). This is useful to show -occurrences of a variable name in source code. +word and pressing `Ctrl+Alt+Shift+H` (`⌘⇧H` on Mac OSX | N/A in ncurses). This +is useful to show occurrences of a variable name in source code. + +This is not supported in ncurses.  @@ -173,8 +187,8 @@ occurrences of a variable name in source code. ### Virtual Space Virtual space (freehand) mode is enabled and disabled with `Ctrl+Alt+Shift+V` -(`^⇧V` in Mac OSX). When enabled, caret movement is not restricted by line -endings. +(`^⇧V` in Mac OSX | none in ncurses). When enabled, caret movement is not +restricted by line endings. ### Overwrite |