docs(printing): document print anything and Ctrl+P

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
james.maesandClaude Fable 5.1 committed 2026-11-01 06:53:46 -06:00
1 parent 555c4346be
commit 3ccb9731b2
2 files changed
+16 -2

No files matched your search

+10
View File
@@ -30,6 +30,16 @@ candidate's, plus the changes since it listed first.
attachments: the Object Storage QBit is not installed." (UI and CLI; any server failure naming a missing
QBit gets one such line), and the UI then shows the upload row dimmed with that reason.
- Print anything (printing 2.1): in the UI **Ctrl+P prints what you see on every screen** (also `p` on
records and grids, F8 where the screen has no Delete, `:print [printer]`, a and F9, and the Print Screen
key when the terminal passes it on). A record view prints its record sheet; a grid prints a table list
with the columns, widths, filter and sort shown, choosing all rows (the default when filtered or up to
2,000 rows; the server prints up to 10,000 and says when it stops), this page, or the selection as a list
or as record sheets; any other screen prints its text as a monospace PDF. Without printing, Ctrl+P saves
instead (the grid's export, else the screen text). Ctrl+P no longer steps to the previous record (PgUp
and `[` still do). The CLI adds `qqq print list <table>` (criteria, order, columns, `--page`, paper and
orientation) and `qqq print text [file|-]`; the kernel adds `printTableList`, `printText`,
`tableListValues` and `listScopeChoices`.
- Printing (the printing extension, qbit-printing 2.x). The CLI: `qqq print <table> <id...>` renders each
record as a record sheet through the table's Print process, queues one job per record and follows them
until they have printed (`--printer`, `--copies`, `--no-wait`, `--timeout`; exit 1 when a job failed, 4
+6 -2
View File
@@ -159,7 +159,7 @@ eval "$(qqq completion zsh)" # also bash, f
| `home`, `find`, `apps`, `search`, `tail`, `whoami` | the landing page, the command palette, app homes (`--widgets`), global search, the live event stream, who you are |
| `report`, `saved-report`, `saved-view`, `share`, `bulk-profile`, `audit`, `widget`, `script`, `job`, `prefs`, `help-search` | reports and saved reports (pivots, schedules), saved views, sharing, saved bulk-load mappings, audit history, dashboard widgets as text, associated scripts, jobs, preferences, help |
| `api <operationId>` | any UI API operation by id: the escape hatch |
| `print`, `printer` | print records (`print person 1 2`), follow and cancel print jobs (`print job list\|status\|cancel`), printers and print agents (`printer list\|use\|show\|forget\|devices`); needs the printing extension |
| `print`, `printer` | print records (`print person 1 2`), table lists (`print list person -w ...`), text (`print text`), follow and cancel print jobs (`print job list\|status\|cancel`), printers and print agents (`printer list\|use\|show\|forget\|devices`); needs the printing extension |
| `extensions`, and one noun per extension | `esb`, `collab`, `health`, `alerts`, `assistant`, `sql-workbench`, ..., offered when the server has the extension installed |
| `login`, `logout`, `config`, `cache`, `completion`, `doctor`, `ui` | sign-in, profiles and settings, the metadata cache, shell completion, the environment check, the terminal UI |
@@ -187,7 +187,11 @@ the agents and their health, and `qqq print person 1 2 --printer "Virtual PDF pr
record as a record sheet, queues one job per record and follows them until they have printed (`--no-wait`
returns at once; `qqq print job status <id> --watch` follows later; `qqq print job cancel <id>` cancels a
job still queued). The printer given with `--printer` (or `qqq printer use`) is remembered per profile.
Tables print only where the server enabled Print for them. For local testing without hardware,
`qqq print list person -w "lastName = Odd" --order -id --columns id,firstName,lastName` prints a table list
of the whole result (up to 10,000 rows; `--page 2` for one page), and `some-command | qqq print text --title Log`
prints text. In `qqq ui`, **Ctrl+P prints what you see** on every screen: a record sheet, a table list of
the grid (all rows or this page), or the screen as text. Tables print only where the server enabled Print
for them (qbit-printing 2.1 `registerAll` enables every table). For local testing without hardware,
`scripts/print-agent.sh` runs qqq-print-agent's virtual file printer, which writes each job to a directory.
[TRY-IT.md](TRY-IT.md) walks through every command against the sample server.