docs: bring all docs up to date after the split/rename
- docs/radials.example.json: the config comments and the launcher-door action names were still Ollie-era — 'Copy to .../olliepalette/radials.json' -> 'deft/radials.json', and ollie_goto_file/ollie_goto_symbol/ollie_command_palette -> deft_goto_file/deft_goto_symbol/deft_command_palette (the objectNames the radial plugin actually resolves; verified against radialconfig.cpp). - docs/PLUMBING.md: replaced the dead 'See PLAN.md' pointer with the real implementation location (src/plumb/, plumb_lib + plumbplugin). - README: link docs/radials.example.json from the radial Configure note. - AGENTS.md: drop the environment-specific LSP-bridge remark (not universal contributor guidance); keep the plain 'read before you edit' rule. PERF.md and SAM.md were already accurate and are unchanged.
This commit is contained in:
parent
812ab782f8
commit
33790043d8
|
|
@ -56,9 +56,7 @@ cmake --install build # installs the 6 .so to ~/.local/.../qt6/plu
|
|||
- **Match the existing style.** No pointless indirection; file-local helpers
|
||||
duplicated across plugins are preferred over a shared lib for a few trivial
|
||||
functions.
|
||||
- **Never read a file you haven't read, then rewrite from memory.** Use targeted
|
||||
edits. The LSP bridge in this environment is unreliable; prefer the Tree-sitter
|
||||
(`code_*`) and `file_*` tools.
|
||||
- **Never rewrite a file from memory.** Read it first, then make targeted edits.
|
||||
|
||||
## Two load-bearing design decisions
|
||||
|
||||
|
|
|
|||
|
|
@ -201,7 +201,8 @@ comment, case changes…), so the mouse stays at the text.
|
|||
- Slices can trigger any action by name, including `palette`/`switch` doors.
|
||||
- **Configure:** drop a `radials.json` at `~/.config/deft/radials.json` to
|
||||
replace the built-in tree; when it is absent, empty, or invalid, the built-in
|
||||
default is used.
|
||||
default is used. See [docs/radials.example.json](docs/radials.example.json)
|
||||
for the format.
|
||||
|
||||
### `[deft:nineify] acme` — acme editing gestures
|
||||
|
||||
|
|
|
|||
|
|
@ -6,8 +6,9 @@ line, or a directory as a folder). The *routing* — what a plumbed string means
|
|||
lives in the plumber's rules, not in Kate. This document covers the user-side
|
||||
rules in `~/lib/plumbing` that make files and directories open in Kate.
|
||||
|
||||
See `PLAN.md` → "Plumbing" for the implementation (the native 9P client, the
|
||||
edit-port reader, and the in-process handler).
|
||||
The implementation (the native 9P client, the edit-port reader, and the
|
||||
in-process handler) lives in `src/plumb/` — `plumb_lib` is the pure codec/9P
|
||||
client and `plumbplugin.{h,cpp}` is the Kate glue.
|
||||
|
||||
## How plumbing reaches Kate
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
{
|
||||
"//": "Ollie radial-menu config. Copy to $XDG_CONFIG_HOME/olliepalette/radials.json",
|
||||
"//": "Deft radial-menu config. Copy to $XDG_CONFIG_HOME/deft/radials.json",
|
||||
"//trigger": "Each radial may have a key 'trigger' (e.g. \"Alt+R\") and/or a mouse 'button' (\"RightButton\" | \"MiddleButton\").",
|
||||
"//slices": "A slice is a leaf { \"label\", \"action\": <Kate objectName> } or a branch { \"label\", \"slices\": [ ... ] }. The special action \"ollie_command_palette\" opens the M-x palette.",
|
||||
"//slices": "A slice is a leaf { \"label\", \"action\": <Kate objectName> } or a branch { \"label\", \"slices\": [ ... ] }. The special action \"deft_command_palette\" opens the M-x palette.",
|
||||
"radials": [
|
||||
{
|
||||
"name": "edit",
|
||||
|
|
@ -19,9 +19,9 @@
|
|||
{ "label": "Align", "action": "tools_align" },
|
||||
{ "label": "UPPER", "action": "tools_uppercase" },
|
||||
{ "label": "lower", "action": "tools_lowercase" },
|
||||
{ "label": "File…", "action": "ollie_goto_file" },
|
||||
{ "label": "Sym…", "action": "ollie_goto_symbol" },
|
||||
{ "label": "M-x", "action": "ollie_command_palette" }
|
||||
{ "label": "File…", "action": "deft_goto_file" },
|
||||
{ "label": "Sym…", "action": "deft_goto_symbol" },
|
||||
{ "label": "M-x", "action": "deft_command_palette" }
|
||||
]
|
||||
}
|
||||
]
|
||||
|
|
|
|||
Loading…
Reference in New Issue