Re: [Minor] Conflicting sentence in "2.4. Populating a Table With Rows" - Mailing list pgsql-docs

From Laurenz Albe
Subject Re: [Minor] Conflicting sentence in "2.4. Populating a Table With Rows"
Date
Msg-id 62b2bf013e17f856186efb2989c16ff97befc309.camel@cybertec.at
Whole thread
In response to Re: [Minor] Conflicting sentence in "2.4. Populating a Table With Rows"  (Matemática A3K <matematica.a3k@gmail.com>)
Responses Re: [Minor] Conflicting sentence in "2.4. Populating a Table With Rows"
List pgsql-docs
On Tue, 2026-09-29 at 15:00 -0300, Matemática A3K wrote:
> > > Yeah, that last part could use some cleanup.  I’d probably rewrite it using csv though instead of tab-delimited
soas to remove the need for a parenthetical. 
> > >
> > > David J.
>  
> I'm attaching the patch although without the format that Laurenz used (not sure if it is needed though).
>
> It fixes the problem and removes the parenthetical, do you think is OK?

No issue with the format of the patch, but with the content.

The COPY statement uses the default tab-separated TEXT format, so your CSV data
wouldn't work with it.

The wording in the documentation is confusing, because it does not indicate
that the file below belongs to the COPY statement above.

I think this should read:

  You could also have used COPY to load large amounts of data from flat-text files. [...]
  An example would be:

     COPY weather FROM '/home/user/weather.txt';

  where the file name for the source file must be available on the machine running the
  backend process, not the client, since the backend process reads the file directly.
  The file used in the <command>COPY</command> statement above could look as follows
  (the values are separated by a tab character):

     San Francisco    46    50    0.25    1994-11-27
     San Francisco    43    57    0.0    1994-11-29
     Hayward    37    54    \N    1994-11-29

Yours,
Laurenz Albe



pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: Improve "3.5. Window Functions" tutorial
Next
From: Matemática A3K
Date:
Subject: Re: [Minor] Conflicting sentence in "2.4. Populating a Table With Rows"