diff --git a/doc/pending.txt b/doc/pending.txt index 0b4b249..9ec9b34 100644 --- a/doc/pending.txt +++ b/doc/pending.txt @@ -839,7 +839,7 @@ Fields: ~ The view to use when the buffer is opened for the first time in a session. - {eol_format} (string, default: '%l %c %r %d') + {eol_format} (string, default: '%c %r %d') Format string for end-of-line virtual text. Specifiers: `%l` forge link label (`PendingForge`) @@ -1480,13 +1480,15 @@ Example: > Fix login bug gh:user/repo#42 due:friday < -On `:w`, the forge reference is stripped from the description, stored in the -task's `_extra._forge_ref` field, and rendered as right-aligned virtual text -alongside the due date and other metadata. +On `:w`, the forge reference stays in the description and is also stored in +the task's `_extra._forge_ref` field. The raw token is visually replaced +inline with a formatted label using overlay extmarks (same technique as +checkbox icons). Multiple forge references in one line are each overlaid +independently. -Only one forge reference per task. The `%l` specifier in `eol_format` -controls where the link label appears in the virtual text line. The default -`eol_format` is `'%l %c %r %d'` (link first). +The `%l` specifier in `eol_format` is still supported for users who prefer +the link label in EOL virtual text, but it is no longer in the default +format (`'%c %r %d'`). Format string: ~ *pending-forge-format* @@ -1530,7 +1532,7 @@ Fields (per forge): ~ Falls back to CLI: `gh auth token` (GitHub), `glab auth token` (GitLab). Codeberg uses token only. {icon} (string) Nerd font icon used in virtual text. - {issue_format} (string) Format string for the EOL label. + {issue_format} (string) Format string for the inline overlay label. {instances} (string[]) Additional hostnames for self-hosted instances (e.g. `{ 'github.company.com' }`).