database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-05-01 01:04:50 +03:00
Code

doc: Minor wordsmithing to COPY docs

Browse Source 
Perform some minor wordsmithing on two sentences in the COPY documentation
to make them clearer.

While there, also ensure to wrap a few occurrences of CSV in <literal>
which were missing this.

Reported-by: Eric Mutta <eric.mutta@gmail.com>
Reviewed-by: Tom Lane <tgl@sss.pgh.pa.us>
Discussion: https://postgr.es/m/166104548566.654.11680826843612576896@wrigleys.postgresql.org
This commit is contained in:
Daniel Gustafsson 2022-08-22 15:08:45 +02:00
parent f0b013b0fc
commit e2fe0aedd0
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/src/sgml/ref/copy.sgml
View File

@ -157,10 +157,10 @@ COPY { <replaceable class="parameter">table_name</replaceable> [ ( <replaceable
</para> </para>
<para> <para>
Note that the command is invoked by the shell, so if you need to pass Note that the command is invoked by the shell, so if you need to pass
any arguments to shell command that come from an untrusted source, you any arguments that come from an untrusted source, you
must be careful to strip or escape any special characters that might must be careful to strip or escape any special characters that might
have a special meaning for the shell. For security reasons, it is best have a special meaning for the shell. For security reasons, it is best
to use a fixed command string, or at least avoid passing any user input to use a fixed command string, or at least avoid including any user input
in it. in it.
</para> </para>
</listitem> </listitem>
@ -227,7 +227,7 @@ COPY { <replaceable class="parameter">table_name</replaceable> [ ( <replaceable
<para> <para>
Note that all other sessions will immediately be able to see the data Note that all other sessions will immediately be able to see the data
once it has been successfully loaded. This violates the normal rules once it has been successfully loaded. This violates the normal rules
of MVCC visibility and users specifying should be aware of the of MVCC visibility and users should be aware of the
potential problems this might cause. potential problems this might cause.
</para> </para>
</listitem> </listitem>
@ -708,7 +708,7 @@ COPY <replaceable class="parameter">count</replaceable>
Separated Value (<literal>CSV</literal>) file format used by many other Separated Value (<literal>CSV</literal>) file format used by many other
programs, such as spreadsheets. Instead of the escaping rules used by programs, such as spreadsheets. Instead of the escaping rules used by
<productname>PostgreSQL</productname>'s standard text format, it <productname>PostgreSQL</productname>'s standard text format, it
produces and recognizes the common CSV escaping mechanism. produces and recognizes the common <literal>CSV</literal> escaping mechanism.
</para> </para>
<para> <para>
@ -766,7 +766,7 @@ COPY <replaceable class="parameter">count</replaceable>
<note> <note>
<para> <para>
CSV format will both recognize and produce CSV files with quoted <literal>CSV</literal> format will both recognize and produce <literal>CSV</literal> files with quoted
values containing embedded carriage returns and line feeds. Thus values containing embedded carriage returns and line feeds. Thus
the files are not strictly one line per table row like text-format the files are not strictly one line per table row like text-format
files. files.
@ -775,7 +775,7 @@ COPY <replaceable class="parameter">count</replaceable>
<note> <note>
<para> <para>
Many programs produce strange and occasionally perverse CSV files, Many programs produce strange and occasionally perverse <literal>CSV</literal> files,
so the file format is more a convention than a standard. Thus you so the file format is more a convention than a standard. Thus you
might encounter some files that cannot be imported using this might encounter some files that cannot be imported using this
mechanism, and <command>COPY</command> might produce files that other mechanism, and <command>COPY</command> might produce files that other