Re: Avoid too prominent use of "backup" on pg_dump man page

2024-05-29 Thread Daniel Gustafsson
> On 30 May 2024, at 01:11, Peter Eisentraut wrote: > Suggestions for word-smithing welcome. No objections to using export over backup, but it does make the use of "restore" feel awkward as that's generally an operation on a backup and not an export. -least one schema/table in the backu

Avoid too prominent use of "backup" on pg_dump man page

2024-05-29 Thread Peter Eisentraut
In Karen Jex's presentation today at pgconf.dev [0] one of the examples given was that users inadvertently rely on pg_dump as their primary backup tool, when better solutions exist. The pg_dump man page is arguably misleading in that it starts with "pg_dump is a utility for backing up a Postg

Re: 17beta1 source download does not include docs & manpages

2024-05-29 Thread Tom Lane
Marcel Hofstetter writes: >> What DocBook XSL stylesheet version do you have installed? The docs say >> that 1.77.0 is required: > Looks like we are a bit to low on Solaris > -bash-5.1$ pkg list docbook-style-xsl > NAME (PUBLISHER) VERSIONIFO > data/docbook/do

Re: Ambiguous description on new columns

2024-05-29 Thread vignesh C
On Wed, 22 May 2024 at 08:18, Peter Smith wrote: > > On Tue, May 21, 2024 at 8:40 PM PG Doc comments form > wrote: > > > > The following documentation comment has been logged on the website: > > > > Page: https://www.postgresql.org/docs/16/logical-replication-col-lists.html > > Description: > > >