doc: Avoid writing in first-person form

This rewrites the few places where first-person form was used, and
replaces with wording more in line with the rest of the documentation.

While there, the section on editing PO files is split between what
to edit with, and how to edit, as well as add a missing colon.

Author: Daniel Gustafsson <daniel@yesql.se>
Reported-by: wolakk@gmail.com
Discussion: https://postgr.es/m/166692508416.630.9910522387468316027@wrigleys.postgresql.org
This commit is contained in:
Daniel Gustafsson 2022-12-02 13:49:54 +01:00
parent c76da690ba
commit 66456da150
3 changed files with 13 additions and 10 deletions

View File

@ -537,7 +537,7 @@ SELECT c FROM test ORDER BY c ~&gt; 3 DESC LIMIT 5;
<title>Defaults</title> <title>Defaults</title>
<para> <para>
I believe this union: This union:
</para> </para>
<programlisting> <programlisting>
select cube_union('(0,5,2),(2,3,1)', '0'); select cube_union('(0,5,2),(2,3,1)', '0');
@ -548,7 +548,7 @@ cube_union
</programlisting> </programlisting>
<para> <para>
does not contradict common sense, neither does the intersection does not contradict common sense, neither does the intersection:
</para> </para>
<programlisting> <programlisting>
@ -560,8 +560,8 @@ cube_inter
</programlisting> </programlisting>
<para> <para>
In all binary operations on differently-dimensioned cubes, I assume the In all binary operations on differently-dimensioned cubes,
lower-dimensional one to be a Cartesian projection, i. e., having zeroes the lower-dimensional one is assumed to be a Cartesian projection, i. e., having zeroes
in place of coordinates omitted in the string representation. The above in place of coordinates omitted in the string representation. The above
examples are equivalent to: examples are equivalent to:
</para> </para>

View File

@ -205,13 +205,16 @@ make update-po
<para> <para>
The PO files can be edited with a regular text editor. There are also The PO files can be edited with a regular text editor. There are also
several specialized editors for PO files which can help the process with several specialized editors for PO files which can help the process with
translation specific features. The translation specific features.
translator should only change the area between the quotes after There is (unsurprisingly) a PO mode for Emacs, which can be quite
the msgstr directive, add comments, and alter the fuzzy flag.
There is (unsurprisingly) a PO mode for Emacs, which I find quite
useful. useful.
</para> </para>
<para>
The translator should only change the area between the quotes after
the msgstr directive, add comments, and alter the fuzzy flag.
</para>
<para> <para>
The PO files need not be completely filled in. The software will The PO files need not be completely filled in. The software will
automatically fall back to the original string if no translation automatically fall back to the original string if no translation

View File

@ -415,8 +415,8 @@ gen_salt(type text [, iter_count integer ]) returns text
<listitem> <listitem>
<para> <para>
<literal>crypt-bf</literal> numbers are taken using a simple program that <literal>crypt-bf</literal> numbers are taken using a simple program that
loops over 1000 8-character passwords. That way I can show the speed loops over 1000 8-character passwords. That way the speed
with different numbers of iterations. For reference: <literal>john with different numbers of iterations can be shown. For reference: <literal>john
-test</literal> shows 13506 loops/sec for <literal>crypt-bf/5</literal>. -test</literal> shows 13506 loops/sec for <literal>crypt-bf/5</literal>.
(The very small (The very small
difference in results is in accordance with the fact that the difference in results is in accordance with the fact that the