Skip to content

Moving work into new branch for PR against v5_STABLE#406

Open
susan-pgedge wants to merge 15 commits intov5_STABLEfrom
doc_updates_4_2026
Open

Moving work into new branch for PR against v5_STABLE#406
susan-pgedge wants to merge 15 commits intov5_STABLEfrom
doc_updates_4_2026

Conversation

@susan-pgedge
Copy link
Copy Markdown
Member

@susan-pgedge susan-pgedge commented Apr 3, 2026

There is a draft version for review at: TEMP contains the draft version

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 3, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 496e62d6-8e16-4f48-8899-a1d9ab6dd033

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc_updates_4_2026

Comment @coderabbitai help to get the list of available commands and usage tips.

@codacy-production
Copy link
Copy Markdown

codacy-production bot commented Apr 3, 2026

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

TIP This summary will be updated as you push new changes. Give us feedback

Comment thread docs/managing/batch_inserts.md Outdated
Comment thread docs/managing/batch_inserts.md Outdated
the `postgresql.conf` file, setting:

* the `spock.batch_inserts` parameter to `true`.
* the `spock.conflict_resolution` parameter to `error`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If I read the code correctly, there is no such option as 'error':

static const struct config_enum_entry SpockConflictResolvers[] = {
	/*
	 * Disabled until we can clearly define their desired behavior. Jan Wieck
	 * 2024-08-12
	 *
	 * {"error", SPOCK_RESOLVE_ERROR, false}, {"apply_remote",
	 * SPOCK_RESOLVE_APPLY_REMOTE, false}, {"keep_local",
	 * SPOCK_RESOLVE_KEEP_LOCAL, false}, {"first_update_wins",
	 * SPOCK_RESOLVE_FIRST_UPDATE_WINS, false},
	 */
	{"last_update_wins", SPOCK_RESOLVE_LAST_UPDATE_WINS, false},
	{NULL, 0, false}
};

Comment thread docs/managing/read_only.md
Comment thread docs/managing/lolor.md
Comment thread docs/managing/snowflake.md
Comment thread docs/managing/spock_autoddl.md
Comment thread docs/managing/spock_autoddl.md
Comment thread docs/managing/spock_autoddl.md Outdated
Comment thread docs/monitoring/spock_info.md
Comment thread docs/monitoring/spock_sync_event.md
Comment thread docs/monitoring/spock_info.md
Comment thread docs/spock_functions/functions/spock_gen_slot_name.md
Comment thread docs/spock_functions/functions/spock_gen_slot_name.md
Comment thread docs/spock_functions/functions/spock_max_proto_version.md Outdated
Comment thread docs/spock_functions/functions/spock_node_add_interface.md
Optional country code or name associated with the node. The default is
NULL.

info
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This field might contain internal fields that affect the conflict-resolution logic. I'm not sure if it was documented somehow, maybe reference here?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll need a dev to provide that information @danolivo

@rasifr or @ibrarahmad , is there anything else we should include here?

Comment thread docs/spock_functions/functions/spock_node_create.md
Comment thread docs/spock_functions/functions/spock_node_drop_interface.md Outdated
### SYNOPSIS

`spock.node_info ()`
spock.node_info()
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This place looks like a good place to add all the 'spock_version' stuff described earlier.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rasifr @ibrarahmad Can you share any information missing from this doc page?

No functional changes. Pure formatting: every C function CREATE statement
in spock--5.0.0.sql, spock--5.0.0--5.0.1.sql, and spock--5.0.1--5.0.2.sql
is reformatted:

- One parameter per line, indented two spaces
- IN parameter names column-aligned within each function
- RETURNS clause on its own line
- AS 'MODULE_PATHNAME', 'symbol' on its own line
- LANGUAGE C [attributes] as the final line before the semicolon

This matches the convention used by PostgreSQL core contrib extensions
(pageinspect, amcheck, postgres_fdw, etc.) and makes signatures easier
to read and diff.
Copy link
Copy Markdown
Contributor

@danolivo danolivo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Almost all is good. Minor changes needed - see comments here and in Slack.

Susan Douglas and others added 4 commits April 9, 2026 08:34
- Rename spock_sub_sync.md → spock_sub_alter_sync.md (sub_sync → sub_alter_sync)
- Delete spock_seq_sync.md (content already in spock_sync_seq.md)
- Rename spock_xact_timestamp_origin.md → spock_xact_commit_timestamp_origin.md
- Remove redundant spock. prefix from spock_version, spock_version_num, spock_max_proto_version, spock_min_proto_version docs
- Update forward_origins default from {all} to {} with explanation in sub_mgmt.md and spock_sub_create.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- remote_insert_lsn reported more frequently, on each incoming WAL record,
not only on a COMMIT, as it was before.


Copy link
Copy Markdown
Member

@mason-sharp mason-sharp Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

^ We should remove this section (left over from when targeting main)

Comment thread docs/managing/repset_trigger.md Outdated
Comment thread docs/upgrading_spock.md Outdated
Comment thread docs/upgrading_spock.md
Comment thread docs/upgrading_spock.md Outdated
Comment thread docs/upgrading_spock.md
Comment thread docs/upgrading_spock.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants