model-writtenrun 3331 - may be wrong, links go to the source messages. Commit-by-commit LLM analysis is in the Commits dialog.
- Aleksander Alekseev reported that postgres recommended --config-file without explicitly listing it in help; Nathan Bossart explained the generic --NAME=VALUE syntax and supported clearer documentation, while David G. Johnston proposed mentioning the equivalent -c form in the diagnostic #1 #2 #3.
- Aleksander initially limited the patch to help and diagnostic wording, judging the postgres reference documentation adequate #4.
- David then expanded the patch to document both forms in the configuration and libpq sections and add cross-references in help and the postgres reference; Peter Eisentraut explained that long-option parsing converts hyphens to underscores and recommended hyphens in examples #5 #6 #7.
- After a three-month gap, Aleksander incorporated Peter's spelling advice and then corrected a libpq example typo reported off-list by Álvaro Herrera #8 #9.
- Michael Paquier and Peter questioned redundant cross-references, David suggested alternative diagnostic wording, and Jelte Fennema-Nio supported documenting the long form in PGOPTIONS because its existing use had exposed a PgBouncer regression #10 #11 #12 #13.
- Michael committed only the unchanged config.sgml and libpq.sgml portions of #9 as f01e3ba56f, explaining that these improvements stood independently of the disputed help and reference-page changes #14.
- Aleksander resubmitted his original two-line patch, but Michael still opposed help cross-references and David supplied an inline alternative describing the required configuration information without enumerating invocation methods #15 #16 #17.
- Álvaro proposed grouping -c and --NAME=VALUE in help and floated more readable configuration descriptions, while Robert Haas and Tom Lane argued that the existing diagnostic need not enumerate every solution and could reasonably remain unchanged #18 #19 #20.
- Aleksander closed the CommitFest entry and agreed to leave the help message unchanged, with Michael concurring; the documentation subset remained landed and the remaining wording proposals were dropped #21 #22.