plsqlwks 0.2.3__tar.gz → 0.2.5__tar.gz

{plsqlwks-0.2.3 → plsqlwks-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plsqlwks
-Version: 0.2.3
+Version: 0.2.5
 Summary: An ncurses SQL and PL/SQL workspace for Oracle databases.
 Author: unu2000
 License-Expression: LicenseRef-plsqlwks-Donationware
@@ -19,6 +19,8 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: license.txt
 Requires-Dist: oracledb>=2.0
+Provides-Extra: er-diagram
+Requires-Dist: CairoSVG>=2.9.1; extra == "er-diagram"
 Provides-Extra: csv2oratab
 Requires-Dist: cryptography>=42; extra == "csv2oratab"
 Provides-Extra: xlsx
@@ -617,10 +619,10 @@ Use left Alt for application shortcuts; AltGr remains available for characters
 on international keyboards. Shortcut digits and symbols refer to the character
 on the active Windows layout: for example, Czech top-row digits need Shift,
 so Alt-1 is typed with Alt-Shift-1. Use the layout's `+` or `=` character for
-autocomplete refresh. Clipboard preferences choose application copy targets
-and paste sources; on a Linux SSH host the ordinary shortcuts default to the
-Linux clipboard. Ctrl-Shift-C copies internally and Ctrl-Shift-V defaults to
-internal paste. SSH does not expose the Windows clipboard to the host. Use
+autocomplete refresh. Ctrl-C/Ctrl-Alt-P copy/paste internally, Ctrl-Shift-C/Ctrl-Shift-P
+use the Windows system clipboard, and Alt-Shift-C/Alt-Shift-P use the Linux
+clipboard. Ctrl-V and Ctrl-Shift-V retain their configured paste sources;
+Ctrl-Shift-V defaults to internal paste. SSH does not expose the Windows clipboard to the host. Use
 PuTTY's native paste (`Shift-Insert` or
 right-click) to insert Windows clipboard text as bracketed paste, and PuTTY
 mouse selection to copy to Windows. Leave plsqlwks' Ctrl-letter shortcuts
@@ -688,30 +690,33 @@ also works from Command Prompt and continues to support PuTTY.
 
 ### Windows Terminal and WSL clipboard shortcuts
 
-There are two main sources in WSL: plsqlwks' internal clipboard and the Windows
-clipboard. Linux desktop access uses Wayland/X11; WSLg can bridge Linux and
-Windows contents, so these are not necessarily three independent clipboards.
+PLSQLWKS provides three clipboard methods: System (Windows), WSL/Linux
+(Wayland/X11), and Internal. WSLg can bridge Windows and Linux contents, so the
+two external methods may access shared contents.
 
-Open **Alt-O → Preferences → Clipboard** to choose external copy destinations
-and the source of each paste shortcut. Save persists the choices in your
-workspace's `config.ini`; Cancel discards changes. Internal copy is always
-enabled. Capabilities / latest failure shows available readers/writers and the
-latest backend error without displaying clipboard contents.
-
-| Shortcut | Default on WSL/Windows |
-| --- | --- |
-| `Ctrl-C` | Copy internally and to Windows |
-| `Ctrl-Shift-C` | Copy internally only |
-| `Ctrl-V` | Paste from Windows |
-| `Ctrl-Shift-V` | Paste internally |
-
-`Ctrl-X` cuts using the ordinary copy destinations and remains one immediate
-Undo edit. `Ctrl-C` interrupts a running database operation first. These copy
-shortcuts work for editor selections, result cells/ranges, DBMS_OUTPUT
-selections and schema-browser object names. Existing paste-enabled prompts and
-cell editors honor both paste-source preferences. New workspaces without
-Windows tools default ordinary copy/paste to Linux; explicit settings always
-win, even if the selected backend is unavailable.
+| Clipboard | Copy | Paste |
+| --- | --- | --- |
+| System (Windows) | `Ctrl-Shift-C` | `Ctrl-Shift-P` |
+| WSL/Linux | `Alt-Shift-C` | `Alt-Shift-P` |
+| Internal | `Ctrl-C` | `Ctrl-Alt-P` |
+
+Each fixed shortcut uses only its assigned target. Copying externally leaves
+the internal clipboard unchanged. `Ctrl-C` interrupts a running database
+operation first; otherwise it copies internally. `Ctrl-Alt-C` still commits or
+applies the active insert draft, and `Ctrl-Alt-R` rolls back. `Ctrl-P` finds the
+previous occurrence of the last search string, retaining case sensitivity and
+wrapping at the start of the worksheet.
+The copy shortcuts work for editor selections, result cells/ranges,
+DBMS_OUTPUT selections and schema-browser object names. Paste works in the
+worksheet, paste-enabled prompts and editable cell text dialogs.
+
+Open **Alt-O → Preferences → Clipboard** to inspect the fixed shortcuts and
+backend capabilities, configure legacy copy/cut destinations and choose the
+sources for `Ctrl-V` and `Ctrl-Shift-V`. Save persists settings in your workspace
+`config.ini`; Cancel discards changes. The new C/P shortcuts ignore these
+settings. `Ctrl-X` and legacy copy commands retain configured destinations and
+an internal copy; cut remains one immediate Undo edit. New workspaces without
+Windows tools default legacy copy/paste to Linux.
 
 ```ini
 [clipboard]
@@ -724,20 +729,26 @@ ctrl_shift_v_source = internal
 Paste sources are `windows`, `internal`, or `linux`. Windows paste reads Windows
 exclusively: failure or empty contents causes no insertion and explicit
 feedback. Internal paste performs no OS access and cancels a pending paste for
-that target. Copy updates internal text immediately, then attempts every enabled
-external destination in a background worker. Windows copy tries PowerShell,
+that target. The fixed copy shortcuts update only their selected clipboard;
+legacy copy/cut updates internal text immediately and then attempts configured
+external destinations in a background worker. Windows copy tries PowerShell,
 then `clip.exe` on failure, and verifies contents by readback when a reader is
 available. Copy-only Windows access is labelled unverified. Each Linux provider
 is attempted when Linux copying is enabled. A Linux success does not conceal a
 Windows failure.
 
-Windows Terminal normally consumes all four shortcuts for its own copy/paste.
-To let plsqlwks receive them, open **Settings → Open JSON file** and add these
+If Windows Terminal consumes a shortcut, forward it to PLSQLWKS.
+To configure explicit forwarding, open **Settings → Open JSON file** and add these
 entries to `actions`, keeping the other actions:
 
 ```json
-{ "command": { "action": "sendInput", "input": "\u0003" }, "id": "User.PlsqlwksCopy" },
-{ "command": { "action": "sendInput", "input": "\u001b[99;6u" }, "id": "User.PlsqlwksInternalCopy" },
+{ "command": { "action": "sendInput", "input": "\u0003" }, "id": "User.PlsqlwksInternalCopy" },
+{ "command": { "action": "sendInput", "input": "\u001b[112;7u" }, "id": "User.PlsqlwksInternalPaste" },
+{ "command": { "action": "sendInput", "input": "\u0010" }, "id": "User.PlsqlwksPreviousMatch" },
+{ "command": { "action": "sendInput", "input": "\u001b[99;6u" }, "id": "User.PlsqlwksSystemCopy" },
+{ "command": { "action": "sendInput", "input": "\u001b[112;6u" }, "id": "User.PlsqlwksSystemPaste" },
+{ "command": { "action": "sendInput", "input": "\u001b[99;4u" }, "id": "User.PlsqlwksWslCopy" },
+{ "command": { "action": "sendInput", "input": "\u001b[112;4u" }, "id": "User.PlsqlwksWslPaste" },
 { "command": { "action": "sendInput", "input": "\u0016" }, "id": "User.PlsqlwksPaste" },
 { "command": { "action": "sendInput", "input": "\u001b[118;6u" }, "id": "User.PlsqlwksAlternatePaste" }
 ```
@@ -746,8 +757,13 @@ Replace the existing copy/paste entries in `keybindings` with
 the entries below, keeping the other keybindings:
 
 ```json
-{ "id": "User.PlsqlwksCopy", "keys": "ctrl+c" },
-{ "id": "User.PlsqlwksInternalCopy", "keys": "ctrl+shift+c" },
+{ "id": "User.PlsqlwksInternalCopy", "keys": "ctrl+c" },
+{ "id": "User.PlsqlwksInternalPaste", "keys": "ctrl+alt+p" },
+{ "id": "User.PlsqlwksPreviousMatch", "keys": "ctrl+p" },
+{ "id": "User.PlsqlwksSystemCopy", "keys": "ctrl+shift+c" },
+{ "id": "User.PlsqlwksSystemPaste", "keys": "ctrl+shift+p" },
+{ "id": "User.PlsqlwksWslCopy", "keys": "alt+shift+c" },
+{ "id": "User.PlsqlwksWslPaste", "keys": "alt+shift+p" },
 { "id": "User.PlsqlwksPaste", "keys": "ctrl+v" },
 { "id": "User.PlsqlwksAlternatePaste", "keys": "ctrl+shift+v" }
 ```
@@ -755,7 +771,7 @@ the entries below, keeping the other keybindings:
 This setting applies to every Windows Terminal profile and tab. Restart
 plsqlwks after upgrading and reopen Windows Terminal if it retains old bindings.
 The command menu offers equivalents when a terminal intercepts the shortcuts.
-The optional `tools/putty_keys.ps1` helper also forwards all four shortcuts when
+The optional `tools/putty_keys.ps1` helper also forwards these shortcuts when
 enabled for the active Windows terminal window.
 
 Keyboard navigation, resizing and dialogs remain available while clipboard
@@ -781,11 +797,14 @@ See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/te
 | Key | Action |
 | --- | --- |
 | `Alt-O` | Open the top-left commands menu |
+| `Alt-I` | Show connection information for the active tab |
 | `F1` | Help |
 | `F6` | Switch between DBMS_OUTPUT and normal results |
 | `F7` | Cycle fullscreen grid, fullscreen editor, and 2/3 editor + 1/3 grid |
 | `F8` | Toggle result grid / row-detail output |
 | `F9` | Show/focus/hide schema browser |
+| `Shift-F9` | Toggle Schema Browser between normal and half-screen width |
+| `Shift-Alt-F9` | Toggle Schema Browser between full-screen and its previous width |
 | `F12` | Choose autocommit or manual transaction mode |
 | `Ctrl-Up` / `Ctrl-Down` | Scroll the focused pane or visible DBMS_OUTPUT by one line |
 | `Ctrl-W` | Close current file tab |
@@ -796,6 +815,25 @@ See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/te
 | `Ctrl-Alt-C` | Insert the active result-grid draft, or commit when no draft is active |
 | `Ctrl-Alt-R` | Roll back the current transaction |
 
+### Connection information
+
+Press `Alt-I`, or choose **Alt-O → Database → Connection information**, from the
+editor, results or schema browser. A centered dialog shows the connected user,
+current schema, service, database and unique database name, container, instance,
+server host, session SID, server timestamp with fractional seconds and timezone,
+database/session time zones, Oracle version, driver version and Thin/Thick mode,
+autocommit and read-only mode. The information is refreshed from the active tab's
+existing session without changing worksheet results, transactions or unread
+DBMS_OUTPUT. A busy active session uses the existing operation-running feedback;
+a disconnected session shows `Not connected` without reconnecting.
+
+The dialog keeps **[ OK ]** visible. Press Enter or Space to accept, or Esc/Ctrl-Q
+to close. Use Up/Down, PageUp/PageDown or Home/End to scroll long details; resize
+the terminal to change the layout. Requests cancelled or completed after switching
+away from their tab do not open a late dialog. The Windows keyboard helper forwards
+Alt-I; a Windows Terminal profile that consumes it can forward `\u001bi` with a
+`sendInput` action bound to `alt+i`.
+
 ### Editor
 
 | Key | Action |
@@ -832,11 +870,13 @@ See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/te
 | `Ctrl-F` | Open literal Find/Replace with the `Find next` action |
 | `Alt-O` -> **Editor** -> **Replace text** | Open Find/Replace at the replacement field |
 | `Ctrl-G` | Go to line |
-| `Ctrl-N` / `Ctrl-P` | Move to the next / previous search occurrence |
+| `Ctrl-N` | Move to the next search occurrence |
+| `Ctrl-P` / `Alt-O → Editor → Previous search match` | Move to the previous search occurrence |
 | `Ctrl-U` | Uppercase selected SQL code |
 | `Ctrl-L` | Lowercase selected SQL code |
-| `Ctrl-C` | Copy selected text |
-| `Ctrl-Shift-C` | Copy selected text internally only |
+| `Ctrl-C` / `Ctrl-Alt-P` | Copy/paste internally |
+| `Ctrl-Shift-C` / `Ctrl-Shift-P` | Copy/paste the System (Windows) clipboard |
+| `Alt-Shift-C` / `Alt-Shift-P` | Copy/paste the WSL/Linux clipboard |
 | `Ctrl-X` | Cut selected text |
 | `Ctrl-V` | Paste clipboard text, expanding each tab to two spaces |
 | `Ctrl-Shift-V` | Paste the alternate source (internal by default) |
@@ -875,11 +915,12 @@ The dialog provides `Find next`, `Replace`, `Replace all`, and `Cancel` actions.
 and lowercase letters. `Replace` changes the selected matching occurrence, or
 the next match from the cursor, and then selects the following match. `Replace
 all` changes every match in the current buffer. Either replacement operation is
-recorded as one undoable edit. `Ctrl-N` and `Ctrl-P` repeat the last search with
-its case setting, forward or backward with wraparound.
+recorded as one undoable edit. `Ctrl-N` repeats the last search forward and
+`Ctrl-P` repeats it backward. Both retain the case setting and wrap around.
+**Alt-O → Editor → Previous search match** provides the same backward search.
 
 Editor paste expands every tab character to two spaces and keeps multiline
-text in one undoable edit. This applies to both configured paste shortcuts and
+text in one undoable edit. This applies to all fixed and configured paste shortcuts and
 to native terminal paste while the editor is focused;
 clipboard contents themselves are not changed. Native paste requires a
 terminal that supports the standard bracketed-paste protocol, with `Ctrl-V`
@@ -926,8 +967,9 @@ Read-only mode is a client-side guardrail that rejects statements which the SQL
 | `Home` / `End` | Move to the first/last result-grid column |
 | `Ctrl-Home` / `Ctrl-End` | Move to the first/last result-grid row |
 | `F8` | Toggle result grid / row-detail output |
-| `Ctrl-C` | Copy one result cell immediately, or choose header handling for a rectangular selection |
-| `Ctrl-Shift-C` | Copy the same cell/range internally only |
+| `Ctrl-C` | Copy a cell/range internally; ranges offer header handling |
+| `Ctrl-Shift-C` | Copy the same cell/range to System (Windows) |
+| `Alt-Shift-C` | Copy the same cell/range to WSL/Linux |
 | `F10` | View or edit a mapped text cell in a ROWID-backed result |
 | `Enter` | Edit the selected ROWID-backed result cell when available |
 | `INS` | Prepare a draft insert row for ROWID-backed results |
@@ -1016,8 +1058,9 @@ move within a displayed line; Ctrl+Home/End move to the output boundaries.
 
 Copying preserves the stored text, whitespace, blank lines, and statement
 headings, without screen wrapping or padding. The existing system clipboard
-providers are used when available, with the internal clipboard as a fallback
-(including remote PuTTY sessions). Ctrl+C still cancels a running operation
+backends are reused: Ctrl+C copies internally, Ctrl+Shift+C copies to Windows,
+and Alt+Shift+C copies to WSL/Linux. Fixed external shortcuts do not fall back
+to another clipboard. Ctrl+C still cancels a running operation
 before performing a copy. Selection belongs to its file tab, survives appended
 output and resizing, and resets when execution replaces the output.
 
@@ -1195,9 +1238,72 @@ validate this opt-in mode with the applications in use.
 
 ### Schema Browser
 
-The `F9` schema browser groups tables, views, procedures, functions, packages, triggers, sequences, indexes, and private synonyms from the current schema. Type while the browser is focused to filter object names with a case-insensitive substring match; groups without matches are hidden and matching groups expand automatically without changing their saved expansion state. Exact quoted and mixed-case names are preserved when columns or definitions are loaded, with Oracle-safe quoting applied to metadata requests.
-
-Press `Enter` on a table or view to choose `Insert SELECT` (the default), `Load DDL`, or `Copy object name`. `Insert SELECT` adds a `select *` statement for the SQL-safe, unqualified object name to the current buffer and focuses the editor; it does not execute the query. `Copy object name` places that SQL-ready, unqualified identifier on the clipboard. For other object types, `Enter` offers `Load DDL` (the default) and `Copy object name`.
+Press `F9` to open or focus Schema Browser. While it is focused, `F9` closes it
+and returns to the SQL buffer. Press `Tab` to keep the browser open and focus
+the SQL buffer, so you can edit SQL beside the tree; press `F9` to return to it.
+Filters, selected objects, expanded branches and cached metadata are retained.
+
+`Shift-F9` opens/focuses the browser and toggles its normal width with a left
+half-screen pane; the SQL buffer and results stay on the right. `Shift-Alt-F9`
+opens/focuses a full-screen browser with its filter header and status line, and
+pressing it again restores the previous normal or half-screen width. From a
+full-screen browser, Tab, returning to the editor with Esc, or loading/inserting
+SQL also restores that previous width. Shift-F9 switches a full-screen browser
+to half-screen. Closing it with F9 retains the side-by-side width for reopening.
+Browser sizes last for the current application session.
+
+Opening/focusing the browser exits an incompatible F7 editor/grid fullscreen
+view, restoring the saved SQL/results split or the two-thirds-editor layout.
+F7 retains its existing editor/grid layout cycle. A terminal that consumes the
+new shortcuts can forward `\u001b[20;2~` for Shift-F9 and `\u001b[20;4~` for
+Shift-Alt-F9 with Windows Terminal `sendInput` actions. The Windows keyboard
+helper forwards both shortcuts while preserving AltGr combinations.
+
+The `F9` schema browser groups tables, views, procedures, functions, package specifications, package bodies, types, type bodies, triggers, sequences, indexes, and private synonyms from the current schema. Type while the browser is focused to filter object names with a case-insensitive substring match; groups without matches are hidden and matching groups expand automatically without changing their saved expansion state. Exact quoted and mixed-case names are preserved when columns, routines or definitions are loaded, with Oracle-safe quoting applied to metadata requests.
+
+Press `Enter` on a table or view to choose `Insert SELECT` (the default), `Load DDL`, or `Copy object name`. `Insert SELECT` adds a `select *` statement for the SQL-safe, unqualified object name to the current buffer and focuses the editor; it does not execute the query. `Copy object name` places that SQL-ready, unqualified identifier on the clipboard. For standalone procedures, functions and other object types, `Enter` offers `Load DDL` (the default) and `Copy object name`.
+
+Package specifications and bodies show their own compilation status immediately
+before the package name: `C` means compiled, `I` means invalid compilation and
+`?` means status unavailable. A compiled specification can have an invalid body.
+Press `Enter` on either part to load the specification, body or both, or copy
+the package name. The selected part is the default; unavailable parts are
+omitted. Each loading mode has its own tab, and loading both puts the
+specification before the body in one SQL buffer.
+
+Press `Space` on either package part to expand its public procedures and
+functions, including while filtering. The browser loads signatures in the
+background and shares the cache between the two package sections. `P` marks a
+procedure and `F` a function; overloads have separate signature rows. Private
+body routines are excluded because a worksheet cannot call them.
+Press `Enter` on a routine to insert a default PL/SQL call block at the current
+cursor, replacing selected text as one undoable edit, and focus the editor.
+The block declares typed variables for every parameter, including parameters
+with defaults and OUT/IN OUT parameters, and a result variable for functions.
+Edit the input values before running it. Insertion does not execute or compile
+the call. Unsupported or incomplete signatures report a reason and leave the
+buffer unchanged.
+
+Press `Space` on a standalone procedure or function to expand its callable
+signature with parameter directions, types and the function return type. Press
+`Enter` on the signature to insert the same owner-qualified call template as for
+package routines. The parent object's Enter menu still offers Load DDL and Copy
+object name. Signatures load asynchronously and are cached until refresh.
+
+The **Types** group includes object and collection types; **Type bodies** lists
+their implementations separately. Enter offers Load DDL or Copy object name.
+Loading a type fetches its specification only; loading a type body fetches its
+body only, with owner-qualified DDL and a single slash terminator. Type attributes
+and methods do not expand into child rows.
+
+Press `Space` on a table or view to expand or collapse its column subtree,
+including while filtering. Column names appear in database order and are loaded
+in the background on first expansion, then cached. Columns are informational
+leaf rows; object actions apply to their parent table or view. `Ctrl-F` opens an
+object-name filter prompt that accepts spaces. Filtering matches object names
+and shows all children beneath expanded matching objects. `Ctrl-R` refreshes
+objects and package statuses, clears cached columns and routines, and collapses
+object branches, retaining the filter and group expansion state.
 
 | Key | Action |
 | --- | --- |
@@ -1206,9 +1312,14 @@ Press `Enter` on a table or view to choose `Insert SELECT` (the default), `Load
 | `Esc` | Clear a nonempty filter, or return to the editor when the filter is empty |
 | `Up` / `Down` | Move through browser entries |
 | `PageUp` / `PageDown` | Move through browser entries by page |
-| `Enter` | Expand a group or choose an action for an object |
-| `Space` | Expand/collapse a group when the filter is empty, or add a space to the active filter |
-| `Ctrl-R` | Refresh database objects |
+| `Tab` | Focus the SQL buffer, keeping the browser open |
+| `F9` | Close the browser and focus the SQL buffer |
+| `Shift-F9` | Toggle normal/half-screen width and focus the browser |
+| `Shift-Alt-F9` | Toggle full-screen/previous width and focus the browser |
+| `Enter` | Expand a group, choose an object action, or insert a routine call |
+| `Space` | Expand/collapse table/view columns, package routines or standalone signatures; on groups, expand/collapse with an empty filter or add a space to an active filter |
+| `Ctrl-F` | Edit the object-name filter, including spaces |
+| `Ctrl-R` | Refresh database objects/statuses and clear column/routine subtrees and caches |
 
 ### Cell Viewer
 
@@ -1220,7 +1331,7 @@ Press `Enter` on a table or view to choose `Insert SELECT` (the default), `Load
 | `PageUp` / `PageDown` | Scroll cell text by page |
 | `Home` / `End` | Move to the first/last cell-viewer line |
 | `Ctrl-S` (editor) | Save the multiline edit |
-| `Ctrl-V` / `Ctrl-Shift-V` / terminal paste (editor) | Paste exact clipboard text as one undoable edit |
+| `Ctrl-Alt-P` / `Ctrl-Shift-P` / `Alt-Shift-P` / configured V keys / terminal paste (editor) | Paste exact clipboard text as one undoable edit |
 | `Enter` (editor) | Insert a newline |
 | `F10` / `Esc` / `Ctrl-Q` (editor) | Cancel the multiline edit |
 
@@ -1287,6 +1398,34 @@ for the exact manifest, source layout, validation, replacement, and trust rules.
 
 ### Table DDL Export
 
+### Schema Compare
+
+Install `plugins/packages/schema-compare-0.1.0.plwgn` and restart the updated
+host. **Alt-O -> Database -> Compare schema objects** chooses two schemas on
+the current connection and compares visible object names/types and logical
+definitions. Browse changed, one-sided, equal and unavailable objects; filter
+by name/type/status, open unified differences with Enter, and cycle original
+definitions with Tab. **Ctrl-E** exports all or filtered differences to CSV,
+HTML or XLSX, including summaries, line numbers and visibility notes. CSV/HTML
+need no extra; XLSX uses `plsqlwks[xlsx]`. The comparison preserves transactions,
+sequence state and the original editor/results. See the
+[catalog guide](doc/PLUGIN_CATALOG.md#schema-compare) for rules and limits.
+
+### E-R Diagram
+
+Install `plugins/packages/er-diagram-0.1.3.plwgn` with `plsqlwks plugin install`
+and restart the updated host. **Alt-O -> Database -> Export E-R Diagram (SVG/PNG/PDF)**
+opens a **Bright / Dark** theme picker followed by an **SVG / PNG / PDF** format
+picker. Use arrow keys and Enter; defaults are Bright and SVG. Then filter and
+check current-schema tables and views and export their columns, keys and
+foreign-key relationships. Connectors show numbered foreign-key names matching
+the detailed relationship notes. Relative destinations use the results directory.
+SVG uses the standard library; PNG/PDF require the optional `er-diagram` extra
+and the Cairo library. See the catalog for installation instructions.
+See the [catalog guide](doc/PLUGIN_CATALOG.md#e-r-diagram) for controls and limits.
+
+### Table DDL Export
+
 Install `plugins/packages/table-ddl-export-0.1.1.plwgn` with
 `plsqlwks plugin install` and restart. **Alt-O -> Database -> Export table DDL**
 lets you choose a schema, filter table names as you type, select tables, and