update diff viewer docs

Author: idursun

src/content/docs/customization/lua-scripting.mdx

@@ -429,15 +429,17 @@ Also available as a top-level global — `ui.cancel()` and `jjui.ui.cancel()` ar
 
 Also available as a top-level global — `diff.show(content)` and `jjui.diff.show(content)` are the same.
 
-| Function |
-|----------|
-| `jjui.diff.scroll_up()` / `jjui.diff.scroll_down()` |
-| `jjui.diff.page_up()` / `jjui.diff.page_down()` |
-| `jjui.diff.half_page_up()` / `jjui.diff.half_page_down()` |
-| `jjui.diff.move_top()` / `jjui.diff.move_bottom()` |
-| `jjui.diff.left()` / `jjui.diff.right()` |
+| Function | Notes |
+|----------|-------|
+| `jjui.diff.scroll_up()` / `jjui.diff.scroll_down()` | |
+| `jjui.diff.page_up()` / `jjui.diff.page_down()` | |
+| `jjui.diff.half_page_up()` / `jjui.diff.half_page_down()` | |
+| `jjui.diff.move_top()` / `jjui.diff.move_bottom()` | |
+| `jjui.diff.left()` / `jjui.diff.right()` | |
 | `jjui.diff.show(content)` | Required string (positional) — display content in the diff view |
-| `jjui.diff.toggle_wrap()` |
+| `jjui.diff.toggle_wrap()` | |
+| `jjui.diff.target_picker()` | Choose a changed file when the diff retains its command arguments |
+| `jjui.diff.prev_file()` / `jjui.diff.next_file()` | Move between changed files when the diff retains its command arguments |
 
 ### jjui.undo.* / jjui.redo.*
 

src/content/docs/diff-viewer.mdx

@@ -39,5 +39,9 @@ While choosing the range:
 | `G` | Jump to bottom |
 | `h` / `l` or left / right | Scroll horizontally |
 | `w` | Toggle line wrapping |
+| `ctrl+t` | Choose one changed file, or `(all files)` to restore the full diff |
+| `[` / `]` | Show the previous / next changed file |
 
 When line wrapping is enabled, long lines wrap within the viewport and horizontal scrolling is disabled.
+
+The `[` and `]` shortcuts wrap at either end of the changed-file list. File selection and navigation are available for revision, Details, Diff Range, and Evolog diffs. Oplog diffs and static content opened through `diff.show()` do not retain the command arguments needed to load individual files.

src/content/docs/git.mdx

@@ -27,11 +27,14 @@ Commands shown vary based on the selected remote and any highlighted/selected re
 | `p` | `git push --remote <remote>` — push tracking bookmarks in the current revset |
 | `a` | `git push --all --deleted --remote <remote>` |
 | `c` | `git push --change <change_id> --remote <remote>` |
+| `b` | `git push --bookmark <bookmark>... --remote <remote>` — push eligible bookmarks on the selected revisions |
 | `d` | `git push --deleted --remote <remote>` |
 | `t` | `git push --tracked --remote <remote>` |
 
 Per-bookmark push commands are also generated automatically for each bookmark on the selected revisions.
 
+To push bookmarks from multiple revisions in one command, select the revisions, open the Git menu with `g`, press `p` to filter push commands, then press `b`. Eligible bookmarks are non-conflicted local bookmarks that are either new or tracked on the selected remote. Duplicate names are collapsed; remote-only bookmarks, bookmarks tracked on another remote, and bookmarks present on the selected remote but not tracked there are skipped.
+
 ## Fetch commands
 
 | Key | Command |

src/content/docs/revisions/index.mdx

@@ -20,6 +20,7 @@ The highlighted revision is the default source for all operations. `space` selec
 
 - Select multiple revisions then press `r` → all selected become the rebase source.
 - Select multiple revisions then press `a` → abandon applies to all of them.
+- Select revisions with bookmarks then press `g`, `p`, `b` → push only their eligible bookmarks.
 - `esc` clears the current selection.
 
 ### Mouse selection