From 678e58333cb1256b8a935b40acd45467e1533edd Mon Sep 17 00:00:00 2001 From: Leo Tenenbaum Date: Thu, 4 Mar 2021 11:17:57 -0500 Subject: v. 0.8 --- README.md | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index a2094f4..a3c421e 100644 --- a/README.md +++ b/README.md @@ -30,6 +30,48 @@ All the keybindings listed below are customizable! - Run any shell command (Ctrl+!) - Go to definition (Ctrl+click) - Go to line (Ctrl+G) +- Autocomplete (Ctrl+Space) + +## Getting started with ted + +After installing ted, you can just start using it like you would any other editor. The keyboard shortcuts +are mostly what you'd expect them to be (Ctrl+o for open, Ctrl+s for save, etc.). + +### Configuration + +At any time, you can check out all the keyboard shortcuts, and add your own, by opening your ted.cfg file. +To do this, press Ctrl+Shift+p +to open the command palette, and select "open-config". There are several sections to this config file: + +- `[core]` for core settings +- `[keyboard]` for keyboard shortcuts +- `[colors]` for colors +- `[extensions]` for which file extensions should be mapped to which programming languages + +Comments begin with `#`, and all other lines are of the form `key = value`. + +You need to restart ted when you make a change to ted.cfg. + +The `core` section's settings should be pretty familiar (font size, etc.) or should have comments on the previous line +explaining what they do. Keyboard shortcuts are of the form `key combo = action`, where `action` is an argument (number or string), +followed by a command. The commands match the things in the command palette (Ctrl+Shift+p), but `:` is added to the beginning to make +it clear it's a command. Colors are formatted like `#rgb`, `#rgba`, `#rrggbb` or `#rrggbbaa`, where r, g, b, and a are red, green, +blue, and alpha (transparency/opacity). You can use a [color picker](https://www.google.com/search?q=color+picker) to help you out. +The extensions section is fairly self-explanatory. + +### IDE-like features + +If you are working in a compiled language, like C, you can press F4 to compile your code. The default is to run `make` in +the current directory or one of its parents, depending on where `Makefile` is. On Windows, if `make.bat` exists, it will be run. +If a `Cargo.toml` file exists in this directory or one of its parents, F4 will run `cargo build`. You can set the default build command +in the `[core]` section of the config file. + +Jump to definition and autocompletion both depend on [ctags](https://github.com/universal-ctags/ctags). You can press Ctrl+T +at any time to generate tags for all files in the current directory. Once you have a tags file, you can Ctrl+Click on an identifier +to go to its definition. You can also press Ctrl+D to get a searchable list of all functions/types where you can select one to go to +its definition. Press Ctrl+space to autocomplete. If there is only one possible completion from the tags file, it will be selected automatically. +Otherwise, you'll get a popup showing all possible completions. You can press tab to select a completion (or click on it), and press +Ctrl+space/Ctrl+shift+space to cycle between suggestions. ## Building from source @@ -76,6 +118,7 @@ Then run `make.bat`. 0.5a Several bugfixes, go to line 2021 Feb 23 0.6 Split-screen 2021 Feb 28 0.7 Restore session, command selector, :shell, big bug fixes 2021 Mar 3 +0.8 Autocomplete 2021 Mar 4 ## License -- cgit v1.2.3