Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit e2fe0ae

Browse files
doc: Minor wordsmithing to COPY docs
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
1 parent f0b013b commit e2fe0ae

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

doc/src/sgml/ref/copy.sgml

+6-6
Original file line numberDiff line numberDiff line change
@@ -157,10 +157,10 @@ COPY { <replaceable class="parameter">table_name</replaceable> [ ( <replaceable
157157
</para>
158158
<para>
159159
Note that the command is invoked by the shell, so if you need to pass
160-
any arguments to shell command that come from an untrusted source, you
160+
any arguments that come from an untrusted source, you
161161
must be careful to strip or escape any special characters that might
162162
have a special meaning for the shell. For security reasons, it is best
163-
to use a fixed command string, or at least avoid passing any user input
163+
to use a fixed command string, or at least avoid including any user input
164164
in it.
165165
</para>
166166
</listitem>
@@ -227,7 +227,7 @@ COPY { <replaceable class="parameter">table_name</replaceable> [ ( <replaceable
227227
<para>
228228
Note that all other sessions will immediately be able to see the data
229229
once it has been successfully loaded. This violates the normal rules
230-
of MVCC visibility and users specifying should be aware of the
230+
of MVCC visibility and users should be aware of the
231231
potential problems this might cause.
232232
</para>
233233
</listitem>
@@ -708,7 +708,7 @@ COPY <replaceable class="parameter">count</replaceable>
708708
Separated Value (<literal>CSV</literal>) file format used by many other
709709
programs, such as spreadsheets. Instead of the escaping rules used by
710710
<productname>PostgreSQL</productname>'s standard text format, it
711-
produces and recognizes the common CSV escaping mechanism.
711+
produces and recognizes the common <literal>CSV</literal> escaping mechanism.
712712
</para>
713713

714714
<para>
@@ -766,7 +766,7 @@ COPY <replaceable class="parameter">count</replaceable>
766766

767767
<note>
768768
<para>
769-
CSV format will both recognize and produce CSV files with quoted
769+
<literal>CSV</literal> format will both recognize and produce <literal>CSV</literal> files with quoted
770770
values containing embedded carriage returns and line feeds. Thus
771771
the files are not strictly one line per table row like text-format
772772
files.
@@ -775,7 +775,7 @@ COPY <replaceable class="parameter">count</replaceable>
775775

776776
<note>
777777
<para>
778-
Many programs produce strange and occasionally perverse CSV files,
778+
Many programs produce strange and occasionally perverse <literal>CSV</literal> files,
779779
so the file format is more a convention than a standard. Thus you
780780
might encounter some files that cannot be imported using this
781781
mechanism, and <command>COPY</command> might produce files that other

0 commit comments

Comments
 (0)