diff options
| author | Alex Leferry 2 <alexherbo2@gmail.com> | 2020-09-01 14:36:01 +0200 |
|---|---|---|
| committer | Alex Leferry 2 <alexherbo2@gmail.com> | 2020-09-01 14:36:01 +0200 |
| commit | ac672189ca809190b0c762db1ff337a74b37294d (patch) | |
| tree | 7012de115f2f1ebcefc8f3e7ca845c3c420f2b6e /docs | |
| parent | 04810ac05ec6751e76cf6ad31d97ada30857feb5 (diff) | |
Small reorganization in the documentation
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/recipes.md | 42 |
1 files changed, 21 insertions, 21 deletions
diff --git a/docs/recipes.md b/docs/recipes.md index ef46475..35909be 100644 --- a/docs/recipes.md +++ b/docs/recipes.md @@ -1,5 +1,16 @@ # Recipes +## Working with headless sessions with `kak-shell` + +`kak-shell :attach` lets you run a client connected to a session, just like the plain `kak -c <session-name>`. +But with `kak-shell :attach`, you have a list of all the active sessions and you can also create a new named session +which starts in headless mode, which is very useful for detaching and reattaching continually. + +Therefore, `kak-shell :attach` replaces `kak -c <session-name>` and `kak -d -s <session-name>` +and can serve to spawn a client in whatever situation you are. + +**Tip**: Alias `kak-shell` to `ks` and connect to a session with `ks a`. + ## Custom prompt You can modify your shell [prompt][Prompt customization] to notify you whenever you are connected to a session. @@ -16,16 +27,19 @@ See [`share/kak/connect/prompt`]. [`share/kak/connect/prompt`]: ../share/kak/connect/prompt -## Working with headless sessions with `kak-shell` +## Change directory -`kak-shell :attach` lets you run a client connected to a session, just like the plain `kak -c <session-name>`. -But with `kak-shell :attach`, you have a list of all the active sessions and you can also create a new named session -which starts in headless mode, which is very useful for detaching and reattaching continually. +In complement to `:cd!` which syncs the client to your current working directory, +you can do the opposite. -Therefore, `kak-shell :attach` replaces `kak -c <session-name>` and `kak -d -s <session-name>` -and can serve to spawn a client in whatever situation you are. +Add to your bashrc: -**Tip**: Alias `kak-shell` to `ks` and connect to a session with `ks a`. +``` bash +if [ "$IN_KAKOUNE_CONNECT" = 1 ]; then + alias :cd='cd `:pwd`' + alias :cd?='cd `:bwd`' +fi +``` ## Turn Kakoune into an IDE @@ -62,17 +76,3 @@ define-command ide -params 0..1 -docstring 'ide [session-name]: Turn Kakoune int > } ``` - -## Change directory - -In complement to `:cd!` which syncs the client to your current working directory, -you can do the opposite. - -Add to your bashrc: - -``` bash -if [ "$IN_KAKOUNE_CONNECT" = 1 ]; then - alias :cd='cd `:pwd`' - alias :cd?='cd `:bwd`' -fi -``` |