Conversation
- zh/9.6 Makefile pins postgresql-9.6.24 archive (sha256 from en/SOURCES.json), reuses OpenSP deps and standalone html/pdf scripts; P0 verified: html 974 pages, PDF A4 2644 pages, US 2779 pages (English-content smoke build). - build_standalone_docsrc.sh: reroute html -> xslthtml-stamp for pre-PG10 doc makefiles (DSSSL-default era), no-op for PG10+. - Mechanical tasklist tmp/pg9x-tasklist-9.6.tsv (untracked, tmp/ convention): 370 rows (157 A-copy / 185 B-adapt / 8 C-new / 20 D-removed). - P1 A-copy: 157 files copied from zh/10 verbatim; EN byte-identity asserted, tag-multiset alignment 156/157 (ref/postgres-ref.sgml keeps zh/10 markup enrichment of bare -p as option); full-book html build gate passed.
postgres/legal/query/advanced/syntax/dml/queries/typeconv/indices/mvcc, all B-adapt from zh/10 mother with per-hunk EN-9.6.24 reconciliation: - 9.6-era wordings restored (window functions, aggregates, RECURSIVE note, SQL-standard isolation sentence); regular/normal aggregate = 普通聚合 - 9.6-specific content: dml remark new rendering, indices hash-index WAL caution new translation, guc-sql-inheritance xref (anchor verified) - PG10-only content dropped: FILTER tutorial examples, typeconv-select sect1, indexes-partial-ex4 example, bloom listing, CREATE STATISTICS/ COMMENT ON/CREATE COLLATION lock lists, pred-lock xref pair, lock-name parenthesized forms - verification: tag multiset vs en/9.6.24 equals mother-vs-en/10.23 deviation for all 10; full-book html build passed (974 pages), Chinese book title renders
perform/user-manag/recovery-config/wal/regress, B-adapt from zh/10 with 9.6 reconciliation: - drop PG10-only content: extended-statistics sect2 + single-column sect2 wrapper, 3 role-attribute entries, 4 default-role rows + trailing paragraphs, recovery_target_lsn entry, LSN indexterm/paragraph, TAP configure para, ICU collate test - 9.6-era naming: pg_xlog (5x in wal), pg_clog, OS X, pg_xlog_replay_resume - verification: tag-multiset deltas vs en/9.6.24 equal mother deltas; full-book html build passed (974 pages); pg_xlog renders in output
datatype (23 hunks): drop PG10-only macaddr8 (table rows + whole sect2), serial identity-column note, char length cap, xml-limits para, xmltable, unknown pseudo-type (indexterm + row); 9.6-era forms: IEEE MAC bit-reversed example value, datetime precision table (1微秒/14位), integer-vs-float storage note (new translation), CREATE SEQUENCE without AS integer, plain money entry, pg_lsn XLOG wording; net -134/+56 lines reconciled hunk by hunk. textsearch: section title back to GIN 和 GiST 索引类型, merged intro; new translation of 9.x-only textsearch-migration sect1 (pre-8.3 tsearch2, tsearch2 anchor verified, 分类词典/停用词 terms cross-checked). Verification: tag-multiset deltas vs en/9.6.24 equal mother deltas (checker now strips programlisting/screen/synopsis/literallayout/ computeroutput/CDATA blocks — datatype XML examples contain literal markup); full-book html build passed (974 pages).
…ility)
maintenance: drop partition-analyze paras/tip (PG10), pg_clog-only freeze
paragraph (pg_xact/pg_commit_ts gone in 9.6), drop log-sensitivity note
and merge voluminous sentence per 9.6 single-para structure.
backup: 9.6 renames (pg_xlog x14, pg_clog, pg_switch_xlog);
pg_stop_backup(false); wait_for_archive paragraphs collapsed to 9.6 form;
pg_dynshmem/pgsql_tmp omission paras dropped; transaction-log wording;
new hash-index WAL caveat listitem.
high-availability: secondary->slave, 事务日志运送 term + matrix column,
logical-replication varlistentry dropped, feature matrix 9->8 cols with
per-row cell audit, pg_current_xlog_location/pg_last_xlog_receive_location/
sent_location/xlog_position slot output, sync-standby kinds para dropped,
FIRST/ANY methods reverted to priority-only ('2 (s1, s2, s3)' example),
HA-planning paragraphs merged, hash-index hot-standby caveat added.
Verification: tag-multiset deltas equal mother deltas for all three
(one matrix cell miscount caught and fixed by the row-level audit);
full-book html build passed (974 pages); pg_xlog/事务日志运送 render.
charset (+18/-362): purge all ICU content (provider paragraphs, sect3/ sect4 flattening to 9.6 single flat sect2, ucs_basic para, inspect- locales para, locale-a/pg_import wording, whole collation-create sect3, multibyte ICU sentence); charset-table 7->6 cols via programmatic ICU-column drop with per-row audit; collation-managing id dropped (no inbound references, verified). monitoring (+58/-790): drop pg_stat_subscription (views-table row + whole view + para), backend_type row, query-truncation sentence, lag triple + lag-times paras/note, pg_stat_reset warning; LWLock -> LWLockNamed + LWLockTranche (wait_type list, example); wait-event table rebuilt from en/9.6.24 with all 72 row descriptions mapped from zh/10 mother translations; sent/write/flush/replay_lsn -> *_location with transaction log position wording; state/sync_state itemizedlists collapsed (no quorum in 9.6); macOS->OS X, xlog-insert/xlog-switch probes, six lwlock probe signatures gain tranche-offset arg. Verification: tag-multiset deviation vs en/9.6.24 is zero for both (three rebuild artifacts caught by the checks + osx gate: missing </row> closers, duplicated thead, duplicated header row); full-book html build passed (974 pages); LWLockNamed/管理排序规则 render.
Drop PG10-only features: libpq-multiple-hosts sect3, comma lists in host/hostaddr/port entries, connect_timeout per-host tail, target_session_attrs param + PGTARGETSESSIONATTRS env, passfile connection param, CONNECTION_CHECK_WRITABLE/CONSUME states, PQhost/PQport/PQpass multi-host paragraphs, SCRAM in PQencryptPasswordConn (merged back into PQencryptPassword). 9.6-era forms: URI synopsis collapsed to single bracket form, PQconnectStart paragraphs restructured with PQconnectStartParams note, PQreset 'reestablish to same server' wording, version numbering reverted to two-digit concatenation (PQserverVersion single para, PQlibVersion hex-bytea example), SSL version list gains SSLv2/SSLv3, compression probe wording, client-certificate section merged, verify-ca cell literal markup, PGPASSFILE/PGSERVICEFILE/.pgpass/ service-file defaults. Verification: tag-multiset deviation vs en/9.6.24 zero (six residual gaps caught and fixed by anchor-aligned audits: PQhost/PQpass/ target-session leftovers, port default sentence + productname, connect_timeout literals, pgpass database/.pgpass markup, verify-ca literal, missing URI sect3 closer caught by osx gate); full-book html build passed (974 pages).
runtime (31 hunks): systemd unit timeout form (TimeoutSec=0, no network-online deps), IPv4 socket log screens, IPC section restructure (System V IPC collective intro, pre-9.3 note relocated, hard-limit wording), sysvipc-parameters table cells (reasonable values header, SHMMAX/SHMALL/SEMMNI), SEMMSL paragraph inserted + POSIX semaphores para dropped, macOS->OS X x9, SCO OpenServer + UnixWare platform entries (new translation, 9.x-only), RemoveIPC semaphore/semctl form, /proc/sys/fs/file-max wording, socket-queue paragraph dropped, version numbering reverted to two-digit-group majors, dump back to 7.0, Password Storage Encryption 9.6 form + new Encrypting Passwords Across A Network entry, passphrase para collapsed, SSL files start-time-only check. install-windows (12 hunks): VS 2022->2019 family, Darwin, config.pl may-need-to-edit, MSBFLAGS + TAP external-command paras dropped, PL/TCL case, DocBook DSSSL 1.79 entry, whole install-windows-libpq sect1 restored from 9.6 (new translation: win32.mak/bcc32.mak, generated-files list, libpq.dll deployment guidance). Verification: tag-multiset deltas equal mother deltas for both (one unmarked-PostgreSQL in RemoveIPC caught by the audit); full-book html build passed (974 pages); install-windows-libpq page renders.
Requirements: Python distutils/2.3 + cdecimal note (9.6), Kerberos+ OpenSSL+OpenLDAP+PAM merged authentication/encryption item; drop --with-icu and --disable-strong-random configure options; libxml entry reverted to xml2-config detection form; add --disable-integer-datetimes (9.x-only, new translation); WAL segment size 1-64 MB; PERL/PYTHON/ TCLSH 'full path name' wording + PERL default dropped; supported CPU/ OS lists (OS X, UnixWare, M68K repositioned); AIX example reverted to createlang screens; HP-UX support URLs + GCC/binutils note; DTrace article link. New 9.x-only sections translated in full: SCO OpenServer and SCO UnixWare platform notes (Skunkware / GNU Make / Readline / UDK / man pages / C99 issues / threading, 153 lines) and Solaris OpenSSL problems subsection. Verification: tag-multiset deviation vs en/9.6.24 zero (residuals caught by ordered term-level audit: PERL default sentence, Skunkware quote/command markup; marked-section normalizer extended for semicolon-less '%standalone-include['); full-book html build passed (974 pages).
SSL file parameters: 'can only be set at server start' form with hard-coded-name parentheticals merged; password_encryption reverted to boolean/CREATE USER form; ssl_dh_params_file dropped. Memory/planner: shared_buffers Windows 64-512MB note added, flush_after family fsync unmarked, max_parallel_workers + enable_gathermerge + both max_pred_locks_per_* entries dropped, per-gather single-Gather wording with default 0, min_parallel_table/index_scan_size merged into min_parallel_relation_size. WAL/replication: wal_level default-minimal ordering, synchronous_standby_names reverted to priority-only syntax (no FIRST/ANY, num_sync leading), max_wal_senders/max_replication_slots defaults zero, Subscribers sect2 dropped, pg_wal->pg_xlog and pg_xact->pg_clog, hot_standby default off. Logging: current_logfiles index+paragraph dropped, log_directory pg_log, log_line_prefix empty default, %q tip and sensitive-data notes dropped, pg_stat_activity visibility narrowed. Misc: track_commit_timestamp/ssl_prefer_server_ ciphers type bool, preload-library comma paragraph added + three entries simplified, sql_inheritance entry restored (9.x-only), integer_datetimes disableable form, archive_timeout idle-checkpoint note, old_snapshot_threshold hash-index examples, colspec widths dropped, allow_in_place_tablespaces + wal_consistency_checking dropped. Verification: tag-multiset delta equals mother deviation (productname +1 inherited); full-book html build passed (974 pages); min_parallel_relation_size renders.
…write) Row-level security: permissive/restrictive policy mechanism removed (OR-combination sentence reverted, restrictive-policy example block dropped). Inheritance: sql_inheritance-linked star note, regclass pseudo-type, closing caveat reverted to future-release wording. Partitioning sect1 rebuilt per en/9.6.24 structure (six sect2s: overview / implementing / managing partitions / constraint exclusion / alternatives / caveats), replacing PG10 declarative partitioning (declarative sect2 + best practices + DETACH PARTITION wording + partitioned-table indexterm all dropped). Translations reused from zh/10's implementation-inheritance section (measurement example, CHECK constraint pitfalls, trigger functions, rules/COPY, maintenance, caveats); new translations for 'supports partitioning via table inheritance', master-table steps, syntax-vs-descriptive note, UNION ALL view alternative, managing-partitions intro, and constraint-exclusion intro trim. Verification: tag-multiset deviation zero on first check; full-book html build passed (974 pages); ddl-partitioning page renders 实现分区.
regex: regexp_match purged (table row, index term, prose merged back into regexp_matches 9.6 form with sub-select tip as plain para); greedy-matching screens switched to regexp_matches. Removed: macaddr8 section, JSON to_tsvector/ts_headline table rows, xmltable sect3 (xml processing flattened to xpath/xpath_exists 9.6 layout), JSON conversion-rules note (replaced with best-effort + FROM-clause note), pg_current_logfile / pg_safe_snapshot_blocking_pids / txid_status / txid_current_if_assigned / pg_statistics_obj_is_visible / pg_get_statisticsobjdef / collation-management functions / brin_summarize_range / brin_desummarize_range / pg_ls_logdir / pg_ls_waldir, jsonb - text[] row, cume_dist/percent_rank para. to_char family reverted to 9.6 forms (Q ignored by to_date, liberal input listitem, CC from-string conversion, SS:MS examples, HH/HH12 wording, weekday+ISO-week listitems merged). XML section intro merged, xmlexists simplified, BY REF 9.6 wording. Sequences: privilege paras replaced by nextval/setval important blocks, shared caution dropped, empty para shells cleaned. JSON notes restructured with json_agg cross-ref moved to section end. Aggregates/window wording and table cells (total rows), pg_xlog function family global renames (12 functions, *_location fields, location parameters, transaction-log wording), pg_stop_backup 9.6 split (primary waits / standby returns immediately), bigint_timestamps control-data row restored, replication slot temporary-parameter sentences dropped, replication-origin advance pos parameter, pg_get_serial_sequence identity-column form removed. Verification: tag-multiset delta equals mother deviation (residuals caught by per-sect2 audits: stop_backup para split, wait_for_archive signature, regexp split-note pair, empty para shells, missing bigint_timestamps row); full-book html build passed (974 pages).
SQL functions: tf1 examples return integer; select-list set-returning
functions reverted to deprecated 9.6 wording; four PG10 SRF semantics
paragraphs (LATERAL equivalence, lockstep, nesting, CASE) removed;
pre-10 note replaced with 9.6 'key problem' form. C functions: two
calling conventions restored; type table 9.6 layout (bigint row added,
real/double precision pass-by-reference forms, int2vector row,
numeric and timestamptz rows dropped, regproc C type renamed); whole
Version 0 Calling Conventions section translated anew (160 lines:
old-style examples, CREATE FUNCTION commands, DIRECTORY note, strict
discussion, portability drawbacks); Version 1 section cross-references
v0 ('same functions in version-1 style', CREATE FUNCTION same as v0,
macros hide detail + null handling improvements, portability sentence);
copytext/concat_text version-1 code reverted to VARSIZE/VARDATA forms;
c_overpaid split into version-0 and version-1 examples.
Verification: tag-multiset delta equals mother deviation (quote +1
inherited); full-book html build passed (974 pages); 版本 0 调用约定
renders.
xfunc (22 hunks): tf1 examples return integer; select-list SRFs deprecated 9.6 wording; four PG10 SRF semantics paragraphs removed; pre-10 note replaced with 9.6 'key problem' form; two calling conventions restored; type table 9.6 layout (bigint row added, real/double precision pass-by-reference, int2vector row, numeric and timestamptz rows dropped, regproc renamed); Version 0 Calling Conventions section translated anew (160 lines); Version 1 section cross-references v0; copytext/concat_text code reverted to VARSIZE/VARDATA; c_overpaid split into v0+v1 examples. gin (4 hunks): built-in opclasses table rebuilt to 9.6 form (34 per-type _xxx_ops rows verbatim from EN with zh header, array_ops/ jsonb summary rows dropped); compare method moved into the three required methods, sort-order block and btree-lookup fallback removed; examples intro rewritten to tsvector + one-dimensional arrays + partial-match wording; table title acronym restored. Verification: tag-multiset deltas equal mother deviations for both (five gin table-rebuild artifacts caught: stray EN header row in tbody, duplicated compare block, optional-intro para nesting, title acronym); full-book html build passed (974 pages); _abstime_ops and 版本 0 调用约定 render.
SPI_connect/SPI_finish: unconnected-behavior paragraphs added; two new refentries SPI_push and SPI_pop translated (push/pop SPI stack for recursive SPI usage, 80 lines); SPI_register_relation and SPI_unregister_relation (ENR) entries dropped. SPI_getvalue column count wording simplified. Memory-context discussion reverted to 9.6 form (unconnected palloc acts normal, connected+unconnected usability note, SPI_copytuple/SPI_returntuple/SPI_modifytuple/SPI_palloc exception list). Four connected-only paragraphs and the modifytuple SPI_ERROR_UNCONNECTED varlistentry removed; copytuple/returntuple/ modifytuple return values reverted to 'NULL only if parameter NULL' forms. execq example reverted to version-0 convention (int64 signature, no PG_FUNCTION_INFO_V1, version-0 note paragraph). Verification: tag-multiset deviation zero; full-book html build passed (974 pages); SPI_push page renders.
Documentation toolchain reverted to 9.6 DSSSL era: PDF or PostScript output forms, SGML-transition note removed, FreeBSD docproj URL restored; DocBook DTD requirement split (SGML variant + XML for man pages); DocBook DSSSL Stylesheets entry added, XSL entry reduced to 1.74.0 with man-pages purpose; OpenSP replaced by OpenJade (parser + DSSSL processor description); xsltproc cross-referenced to jade; FOP replaced by JadeTeX entry (TeX backend, RTF-quality comparison); --nonet download paragraph dropped. Package install commands reverted (yum/apt/port with openjade + docbook-style-dsssl, openjade1.3; macOS -> OS X; FreeBSD ports list + print ports note replacing pkg/gmake paras). OpenSP install section replaced by three-step OpenJade procedure (1.4devel segfault note, dsssl directory copy, catalog entry); new sect3s for DSSSL stylesheet and JadeTeX installation translated anew (88 lines, CTAN/TeX requirements, mktexlsr). configure detection output 9.6 form (openjade/collateindex.pl lines, JADE + DOCBOOKSTYLE variables, stylesheets lookup wording); draft and postgres.html HTML targets added; make man as programlisting; PDF section replaced by JadeTeX print output (DVI/PDF commands, texmf.cnf parameters) plus Overflow Text section and full RTF Applixware cleanup procedure translated anew (331 lines, fixrtf, ToC styles table). Verification: tag-multiset deviation zero (two markup gaps caught: missing DSSSL acronym in stylesheets phrase, existing DTD title already carried acronym); full-book html build passed (974 pages); Applixware/JadeTeX/超宽文本 render.
alter_aggregate/create_access_method/alter_system: programlisting close-tag line-break form. alter_collation: REFRESH VERSION purged (synopsis line, varlistentry, notes section with ICU version example). alter_database: tablespace transaction-block restriction dropped. alter_policy: description simplified. alter_materialized_view: SET TABLESPACE synopsis line dropped. alter_extension/alter_function/ alter_opfamily: function argument parentheses no longer optional brackets, name-uniqueness sentences dropped. alter_user/create_group/ create_user: ENCRYPTED|UNENCRYPTED restored. clusterdb: --table foo form. create_domain: default-collation wording. create_opclass: anyarray/anyelement STORAGE explanation dropped. create_table_as: IF NOT EXISTS cross-reference form. create_type: pseudotype spacing. create_view: string-literal example unknown-type wording. createdb: LATIN1 encoding example. drop_foreign_data_wrapper: [, ...] dropped. drop_foreign_table: header comment sggml typo preserved from source. drop_language: droplang cross-reference added. All 23 verified: tag-multiset deviation zero vs en/9.6.24 (mother deviation empty); full-book html build passed (974 pages).
Syntax-form reverts: FETCH/MOVE synopsis direction+[FROM|IN] bracket nesting with 'can be empty' wording; SET TIME ZONE synopsis timezone form, alias without quotes, time-zone-abbreviation sentence dropped; REVOKE/CREATE CAST/SECURITY LABEL function argument parentheses; CREATE DATABASE synopsis WITH bracket nesting. Drop-object synopsis [, ...] removals (drop_server, drop_aggregate, drop_operator) with multi-object example paragraphs dropped. PG10 feature purges: IF NOT EXISTS (create_server, create_user_mapping), REFRESH-adjacent CREATE DATABASE locale-names para, delete/truncate See Also sections, savepoint repeated-name example and name-entry detail, release_ savepoint progressive-release wording, prepare_transaction session temp-namespace clause, VACUUM partition/matview sentence, SET abbreviation note. 9.6-era naming: CHECKPOINT transaction-log wording, pg_rewind pg_xlog/pg_clog, pgtestfsync pg_xlog, SET TRANSACTION SNAPSHOT id 000003A1-1, vacuumdb/reindexdb short option forms, DROP POLICY/import_foreign_schema programlisting close-tag form, TRUNCATE ALTER SEQUENCE RESTART 'usual behavior' note, DELETE TRUNCATE-as-extension tip, CREATE CAST name-uniqueness drop, CREATE DATABASE example reverted to LATIN1/template0 form (with template1 note and LC_COLLATE sentence restored). All 27 verified: tag-multiset deviation zero (four mid-batch misalignments caught and fixed: create_database example trailing sentences, user-mapping varlistentry removal, delete/truncate See Also, savepoint repeated-name example); full-book html build passed (974 pages).
analyze: table_name description simplified, inheritance statistics 'gathered twice' wording, three PG10 partition-statistics paragraphs dropped (partitioned-table sampling, autovacuum non-processing, foreign-children) with the foreign-children-ignore para kept per EN 9.6 (mid-batch overshoot caught by para-sequence audit and restored). create_language: createlang wrapper paragraph + droplang suggestion translated anew, \dL listing replaced by createlang option, two See Also members added. load: library-name paragraph rewritten to cross-reference CREATE FUNCTION form. refresh_materialized_view: ORDER BY note reverted to retained-cluster-index wording. All 4 verified zero deviation; full-book html build passed (974 pages); ledger now 244/350.
- create_role: synopsis ENCRYPTED|UNENCRYPTED, PASSWORD entry split into ENCRYPTED/UNENCRYPTED varlistentry (9.6 wording, no SCRAM), PG10 note dropped - createuser: -E 9.6 wording restored, -N/--unencrypted entry added, example --unencrypted echo warning appended - drop_function: synopsis mandatory parens without multi-object list, uniqueness sentence / PG10 example paras dropped, 9.6 compatibility restored - explain: SUMMARY synopsis line + varlistentry removed - pg_dumpall: drop --no-publications/--no-role-passwords/ --no-subscriptions/--no-sync entries - update: [ ROW ] dropped, partition-update para removed, compatibility para reverted to parenthesized expression-list form All 6 files: zero structural deviation vs en/9.6.24 (tag-multiset check). Ledger 250/350 done. Full-book html gate: 974 pages.
- copy: FREEZE para drops partitioned-table sentence; Notes restores 9.6 plain-table/view paras; identity-columns para removed - alter_default_privileges: ON SCHEMAS GRANT/REVOKE synopsis blocks removed, schemas dropped from alterable list and IN SCHEMA nesting note - pg_recvlogical: app-pgreceivexlog linkends (x3), peek/get para and -E/--endpos entry removed - create_transform: synopsis/term mandatory parens, uniqueness sentences dropped - alter_role: synopsis ENCRYPTED|UNENCRYPTED, CURRENT_USER/SESSION_USER term unwrapping, PASSWORD/ENCRYPTED/UNENCRYPTED term split - create_policy: AS PERMISSIVE|RESTRICTIVE synopsis + entries + multi-policy para/programlisting reverted to 9.6 OR-combination form All zero structural deviation vs en/9.6.24. Ledger 256/350.
- comment: FUNCTION synopsis mandatory parens; PUBLICATION/STATISTICS/ SUBSCRIPTION synopsis lines, lock para, statistics mentions removed - allfiles: 199 entities, set identical to en/9.6.24 (xlog-era names, createlang/droplang restored, pub/sub/statistics dropped) - pg_restore: --list wording, -n namespace param, -N entry and --no-publications/--no-subscriptions entries removed - pgtesttiming: ns->nsec / us->usec output units (68 ns kept per EN) - initdb: --auth merged para, --nosync/--noclean, -T CFG, --xlogdir + transaction-log wording - alter_type: RENAME VALUE dropped (synopsis/desc/param/example), CASCADE/RESTRICT moved to description varlist - create_index: method list without bloom, BRIN singular param, autosummarize dropped, 9.6 psql \d layout, hash-index caution restored All zero structural deviation vs en/9.6.24. Ledger 263/350. Build: 974 pages.
- create_foreign_table: all PARTITION OF support dropped (synopsis blocks, desc para, param entry, routing note, example) - create_function: SECURITY DEFINER owner->creator (x2), obj_file 9.6 wording without SQL-LOAD xref, See Also +app-createlang - create_collation: IF NOT EXISTS/PROVIDER/VERSION dropped, encoding-applicable rule appended to lc_collate/lc_ctype, Notes single collation link, ICU example dropped - pg_dump: -B/--no-blobs entry dropped, sync-snapshot 9.6 wording, lock_timeout 7.3 wording, --no-publications/--no-subscriptions/--no-sync dropped, 7.0 support note, subscription-dump notes para removed - create_sequence: AS data_type dropped (synopsis/param) with compatibility listitem, min/max defaults spelled out, nextval=2 literal All zero structural deviation vs en/9.6.24. Ledger 268/350.
…e/insert 9h) - alter_domain: eight description terms lose literal wrapper (RENAME kept) - alter_sequence: AS data_type dropped (synopsis + entry), min/max defaults spelled out, RESTART similar->equivalent + transactional para dropped, Notes no-rollback para restored, blocking para dropped, compat AS dropped - insert: OVERRIDING fully dropped (synopsis, 2 entries, DEFAULT VALUES note, compat para), [ ROW ] dropped, blocking sentences dropped, alias entry 9.6 wording (plain excluded), Notes partition sect1 dropped, arbiter emphasis restored (zh/10 baseline lacked it) All zero structural deviation vs en/9.6.24. Ledger 271/350. Build: 974 pages.
…backup 12h) - pgbench: --log time-taken wording, --aggregate-interval + Windows note replacing --log-prefix, meta-command continuation dropped, log section rewritten to 9.6 pgbench_log naming, aggregated field names (latency_sum etc.), per-script closing note - pgupgrade: datadir params (synopsis + -d/-D entries), 8.4/9.0 era examples, alpha releases, pg_xlog naming, replication-slot sentence dropped, psql pre-10 option syntax - pg_basebackup: single-session desc, archive-availability limitation, temp-replication-slot/--no-slot dropped, --xlogdir/-x/--xlog-method with transaction-log wording, none method dropped, tar gzip-suffix and no-clean/no-sync entries dropped, 9.6 notes files para All zero structural deviation vs en/9.6.24. Ledger 274/350. Build: 974 pages.
- create_trigger: transition-table feature fully removed (indexterm, REFERENCING synopsis/para/entries/examples, FK/ON CONFLICT notes, partition para), ON CONFLICT statement-trigger note restored to FOR EACH STATEMENT para, 9.6 event/column-list/compat listitems - grant: FUNCTION synopsis mandatory parens, 14 privilege terms unwrapped, REFERENCES/CREATE/USAGE 9.6 wordings All zero structural deviation vs en/9.6.24. Ledger 276/350. Build: 974 pages.
- ATTACH/DETACH PARTITION fully dropped (synopsis, 2 entries, params, examples, ownership/combined-lists mentions) - identity column forms dropped (synopsis, 2 entries, recursion note, compatibility list) - DROP COLUMN multivariate-stats sentence, NOT NULL partition para, planner storage-params sentence, lock para simplified - REPLICA IDENTITY variablelist collapsed to running text with 9.6 logging-condition sentence - parent/descendant Notes paras reverted to 9.6 forms - zh/10 duplicate large-table-rebuild para removed (EN has it once, inside the add-column para) Zero structural deviation vs en/9.6.24. Ledger 277/350. Build: 974 pages.
- declarative partitioning fully dropped (PARTITION BY/PARTITION OF
synopsis blocks + phrase, SQL-CREATETABLE-PARTITION and PARTITION BY
entries, 7 example paras, 2 compatibility refsect2s, ON COMMIT and
storage-param partition sentences)
- identity columns fully dropped (constraint-phrase line, GENERATED
entry, INHERITS/LIKE identity paras, Multiple Identity refsect2,
OID-note -> SERIAL, example -> DEFAULT nextval('serial'))
- WITH OPTIONS mandatory in OF form, like_option 9.6 order without
IDENTITY/STATISTICS, INCLUDING ALL 9.6 expansion, REFERENCES
permission sentence dropped
Zero structural deviation vs en/9.6.24. Ledger 278/350. Build: 974 pages.
- synopsis div transplanted from en/9.6.24 verbatim (pure markup): option reorder, promote/kill simplification, -w/-W/-e/-D placements - restart/promote/status/register 9.6 wordings (config-file sentence, exit-recovery, process exit codes, plain-text start/restart in -W) - --core-file/--pgdata/--log/--mode space forms, -o/--options= and -t/--wait/--no-wait long-option terms dropped with 9.6 paras, irrelevant-option note removed - Windows options 9.6 wordings, env section merged, postmaster.pid note, start/-w stop -m fast/-w restart examples restored Zero structural deviation vs en/9.6.24. Ledger 279/350. Build: 974 pages.
- PG10-only features dropped: \dRp/\dRs, \gx, \if/\elif/\else/\endif block (with example), SERVER_VERSION_NAME/NUM and VERSION/VERSION_NAME/ NUM variables, 'most recently executed query' re-execution sentences, per-meta-command variable-interpolation notes, conditional-branch prompt status, HISTFILE PSQL_HISTORY fallback - 9.6 wordings restored: \pset equivalences removed from -A/-t/-x/-Fz/ -Rz/-T options and \f/\x, \e/\ef/\ev re-parse paras, \g filename/ command form, \o/\w rewrites, \! single para, ECHO/HIST*/IGNOREEOF/ ON_ERROR_ROLLBACK unset-semantics, FETCH_COUNT >0, control-variables paras dropped, prompt 9.6 \d output layout Zero structural deviation vs en/9.6.24 (tag multiset identical). All 30 >3-hunk ref files now done; ledger 280/350. Build: 974 pages.
- pure deletions: acronyms LSN entry, citext regexp_match, pgrowlocks/ pgvisibility/pgfreespacemap permission paras, custom-scan ReInitializeDSM and ShutdownCustomScan callbacks - naming regressions: pgstandby xlogfilepath, test-decoding location column, sslinfo SSLv2/SSLv3/TLSv1, uuid-ossp NetBSD + OS X, btree-gin without macaddr8, lobj copyright 2016 - 9.6 wordings: notation Tcl question marks, sepgsql Fedora-era URLs, xplang createlang restored, datetime 2:30AM fall-back example, rules GROUP/ORDER BY example, adminpack plain boolean All zero structural deviation vs en/9.6.24. Ledger 301/350. Build: 974 pages.
- big section deletions: planstats multivariate examples sect1, features XML limits sect1 (+SQL:2006 drop, plain-text Core), postgres-fdw partition-import para, information_schema 7 identity rows -> canonical unsupported-feature text - contrib entity list (&amcheck out, &tsearch2 in), release.sgml 9.6 markup-regex table and &release-9.6; - era regressions: external-projects language table rebuilt to 9.6 set, xml2 xml_is_well_formed row, dfunc OS X + UnixWare entry, btree-gist without macaddr8/uuid + 9.6 authors, plperl createlang line, plhandler version-0 mention - sequences data_type row gains always-bigint note All zero structural deviation vs en/9.6.24. Ledger 313/350. Build: 974 pages.
- brin: heap->index pages wording, summarize sentence reverted to 9.6 (brin_summarize_new_values only), autosummarize para and macaddr8 op row dropped - pgstattuple: permission para and pgstathashindex entry dropped - pgcrypto: 9.6 note-numbering table cells, OpenSSL 3 para dropped, notes list restored to 3 items (SHA2/AES built-in notes) - bloom: 24 programlisting output lines transplanted from en/9.6 (9.6-era timings, lowercase Planning/Execution time) - ecpg: prepared-transaction commands dropped, autocommit term 9.6 form, bytea row dropped, descriptor-scope comment -> remark, host-language firstterm restored - bgworker: bgw_main field/paras restored (core-function pointer, main_arg either-form wording, bgw_main signal note) All zero structural deviation vs en/9.6.24. Ledger 319/350. Build: 974 pages.
- storage: current_logfiles row dropped, pg_clog row restored, pg_wal/ pg_xact -> pg_xlog, ALTER TABLE SET STORAGE unlinked, pd_lsn xlog wording - pgstatstatements: non-superuser security wording, ? placeholder form, hidden-parameter-symbol para dropped, example output ? forms - fdwhandler: parallel section 9.6 wordings (callback terms, should-only- once), EstimateDSM optional-sentence dropped, ReInitializeDSM and ShutdownForeignScan paras removed, worker para literal tag - extend: temp-objects para, dissociate sentence, update-scripts-install sect2 and NO_INSTALLCHECK entry dropped; CREATE OR REPLACE security para restored All zero structural deviation vs en/9.6.24. Ledger 323/350. Build: 974 pages.
- event-trigger: 9 publication/statistics/subscription table rows dropped - reference: entity list identical to en/9.6.24 (200 entities, xlog-era names, createlang/droplang restored, pgResetxlog in server list) - spgist: inet_ops row dropped, spgSplitTuple struct reverted to nodeLabel form with 9.6 three-call explanation, In-struct field order, NULL-label and fixed-node paras 9.6 forms - plpgsql: format wording, audit example RETURN statements, transition- tables example section dropped, PL/PgSQL casing, callout spacing - pageinspect: single Functions section (5 sect2 boundaries merged), page_checksum entry and hash section dropped, bt bytea variant dropped, fsm_page_contents kept per en/9.6, checksum example 1 All zero structural deviation vs en/9.6.24. Ledger 328/350. Build: 974 pages.
- plpython: createlang install line, sequence/array wording with tuple example, multidimensional-array paras and composite-array para dropped, make_pair list-first example, Python bug #1483133 warning restored, plan.execute method para and plan.cursor method mentions dropped - trigger: partitioned-table qualifiers dropped, ON CONFLICT BEFORE note in overview + plain-text TRUNCATE foreign-table sentence, view-level statement/row rules, 9.6 firing-order para, transition tables fully removed (overview para, indexterm, TriggerData/Trigger struct fields, two entries, SPI para), fmgr.h include dropped All zero structural deviation vs en/9.6.24. Ledger 330/350. Build: 974 pages.
- logicaldecoding: lsn->location/xlog_position example outputs transplanted line-by-line (30+ programlisting lines incl. repeated peek headers), protocol-create-slot xref and NOEXPORT_SNAPSHOT para dropped, DROP_REPLICATION_SLOT WAIT option dropped - indexam: amcanparallel/parallel-scan interface and section fully dropped (struct fields, aminsert indexInfo param, ii_AmCache para, amcostestimate indexPages output + listitem + leaf-pages para, index-only-scan HeapTuple alternative form) All zero structural deviation vs en/9.6.24. Ledger 332/350. Build: 974 pages.
- file-fdw: program option fully dropped (intro, entry, shell-safety para, EXPLAIN wording), filename Required + file's-format wordings, COPY OIDS/HEADER note, file-level null wording, 9.1 example path - keywords: ATTACH/DETACH/PUBLICATION/SCHEMAS/SUBSCRIPTION rows dropped, PG-column status cleared for COLUMNS/GENERATED/NEW/OLD/OVERRIDING/ REFERENCING/XMLNAMESPACES/XMLTABLE All zero structural deviation vs en/9.6.24. Ledger 334/350. Build: 974 pages.
- SCRAM-SHA-256 fully removed (method entry, auth section variablelist -> two-para 9.6 form, indexterm, password-encryption/upgrade paras, example rows) - hostssl warning sentence, physical-replication qualifier, hostname note -> sidebar, method-case sentence dropped - Windows reload note + pg_hba_file_rules para dropped, \password mention dropped, macOS -> OS X - RADIUS: singular options (radiusserver/secret/port/identifier), multi-server para and comma/whitespace example dropped Zero structural deviation vs en/9.6.24. Ledger 335/350. Build: 974 pages.
- pgbuffercache: revoked-access wording, lock-copy 9.6 consistency para - filelist: entity set aligned to en/9.6.24 (sql/tsearch2 in, amcheck/ hash/logical-replication/obsolete stubs out, release-9.6), plus include-index/include-xslt-index guards and bookindex entity for the standalone build (verified: html 974 pages) Zero structural deviation vs en/9.6.24. Ledger 337/350.
- install via createlang, $1..$n argument form - composite/set return section replaced by unsupported note + domain-types hazard para - data values all-strings 9.6 form, Tcl question-mark sentence dropped - subtransaction command entry + explicit-subtransactions sect1 dropped, error-handling database-error wordings - PG10 pltcl-config sect1 (start_proc GUCs) replaced by newly translated pltcl-unknown Modules and the unknown Command section Zero structural deviation vs en/9.6.24. Ledger 338/350. Build: 974 pages.
- Gather Merge fully removed (firstterm/paras/mentions in aggregation, restricted, WHERE-scan wordings) - max_parallel_workers GUC references and parallel-query-workers listitem dropped; per-gather xref form restored - parallel scans: bitmap/index scan listitems collapsed to 9.6 sequential-scan-only running text - joins: nested-loop/hash only with 9.6 wording, InitPlan/SubPlan uncorrelated, PL/pgsql casing Zero structural deviation vs en/9.6.24. Ledger 339/350. Build: 974 pages.
Rebuilt from en/9.6.24 base (bibliographic data is language-neutral): titleabbrev additions, pubdate-before-publisher placement, copyright holders, 9.6 entry set per en/9.6; zh fragments (titles, intro paras, FONG abstract, confdates) carried over from zh/10. Zero structural deviation vs en/9.6.24. Ledger 340/350. Build: 974 pages.
- SASL/SCRAM fully removed: auth-flow SASL mentions, SASL Authentication sect1 with SCRAM subsections, AuthenticationSASL/ SASLContinue/SASLFinal entries and message-format counterparts, SASLInitialResponse/SASLResponse messages, replication startup parameter - GSSAPI/SSPI responses via PasswordMessage (9.6 design-error note), GSSResponse message dropped - Pipelining sect2 and Logical Streaming Replication Protocol sect1 + Logical Replication Message Formats sect1 (701 lines) dropped - SHOW command, CREATE_REPLICATION_SLOT attrs/TEMPORARY/EXPORT_SNAPSHOT options/result-set, DROP_REPLICATION_SLOT WAIT, standby-feedback catalog_xmin/epoch fields, 9.6 excluded-files list (pg_replslot as empty dir) restored; pg_wal->pg_xlog, xlog flush/position wordings, pgreceivexlog xref, void pseudotype, temp-files simplified Zero structural deviation vs en/9.6.24 (tag multiset identical). Ledger 341/350. Build: 974 pages.
- PG10 catalogs fully removed: pg_partitioned_table, pg_publication, pg_publication_rel, pg_sequence, pg_statistic_ext, pg_subscription, pg_subscription_rel (index rows + sect1s) - PG10 columns dropped: attidentity, relispartition, relpartbound, collprovider, collversion, tgoldtable/tgnewtable, polpermissive, pg_replication_slots temporary - 9.6 forms restored: rolpassword inline md5-format description (SCRAM paras dropped), relkind ordering without p, deptype without n, indcollation without zero case, pg_xact->pg_clog (x2), pg_settings sourcefile/sourceline non-superuser wording, pg_class intro without pg_sequence - views dropped: pg_hba_file_rules, pg_publication_tables, pg_sequences (index rows + sect1s) Zero structural deviation vs en/9.6.24 (tag multiset identical). Ledger 342/350. Build: 974 pages.
…pps) Fresh translations of the deprecated language-install/remove wrappers, reusing zh/9.6 createuser connection-option/env/diagnostics wordings (same-English-same-Chinese). Both identical tag multiset vs en/9.6.24. Ledger 344/350. Build: 974 pages.
Fresh translations: pg_xlogdump WAL-rendering utility options and notes; tsearch2 backwards-compatibility module (portability issues, pre-8.3 conversion procedure). Both identical tag multiset vs en/9.6.24. Ledger 346/350. Build: 974 pages.
Fresh translations of the 9.6-era xlog utility pages: pg_resetxlog WAL-reset options with safe-value determination recipes (pg_xact quirk in -u preserved per en/9.6.24), pg_receivexlog streaming receiver with --synchronous/slot guidance. Both identical tag multiset vs en/9.6.24. Ledger 348/350. Build: 974 pages.
Fresh translation of the 2148-line relational-theory chapter: SQL history, relational data model formalities (Cartesian product, relation schemes, domains vs data types), relational algebra (8 operators with worked JOIN/DIVIDE examples), relational calculus, SELECT/JOIN/ aggregate/GROUP BY/HAVING/subquery/UNION tutorials, data definition (CREATE TABLE/INDEX/VIEW, DROP), data manipulation, system catalogs, embedded SQL. Identical tag multiset vs en/9.6.24; no residual-English paragraphs. Ledger 349/350. Build: 974 pages.
…ial)
P4 kickoff: all recurring boilerplate translated across all 25 minor
releases (titles, release-date labels, migration/changes headers,
variety-of-fixes intro, dump/restore notes, also-upgrading pointers,
PostgreSQL-Project-thanks credits with CVE tags, new-features pointers);
9.6.24 changelog entries 1-11 translated (SSL/GSS handshake rejection,
WAL partial-record recovery, CIC prepared-txn wait, concurrent-index
race, NaN hash uniformity, tablespace crash recovery, numeric power,
regexp {0}/backreference fixes, same-type cast). Global para progress
76/1927; per-minor-release tracking in ledger.
Build: 974 pages.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
内容（50 个提交）
从零引导并完成 zh/9.6 中文文档树：
2dab5ee）：构建适配（Makefile/XSL 走 pg10-13-from-14 先例）+ P1 A-copy 批 157 文件65c8e98）：release-9.6.sgml 翻译程序启动（样板 + 9.6.24 部分）验证
make html全绿（974 页）说明
本 PR 为 5 个堆叠 PR 的最后一环；五链最终树已验证与本地 main 逐字节一致。