Only one nextval tag is different

Started by Noboru Saitoover 3 years ago4 messagesdocs
Jump to latest
#1Noboru Saito
noborusai@gmail.com

Hello, I am a member of the PostgreSQL documentation Japanese translation team.

I noticed that the nextval tag in ref/create_sequence.sgml is different.
Is this just a mistake?

diff --git a/doc/src/sgml/ref/create_sequence.sgml
b/doc/src/sgml/ref/create_sequence.sgml
index a84aa5bf56..34e9084b5c 100644
--- a/doc/src/sgml/ref/create_sequence.sgml
+++ b/doc/src/sgml/ref/create_sequence.sgml
@@ -303,21 +303,21 @@ SELECT * FROM <replaceable>name</replaceable>;
   </para>
   <para>
    Furthermore, although multiple sessions are guaranteed to allocate
    distinct sequence values, the values might be generated out of
    sequence when all the sessions are considered.  For example, with
    a <replaceable class="parameter">cache</replaceable> setting of 10,
    session A might reserve values 1..10 and return
    <function>nextval</function>=1, then session B might reserve values
    11..20 and return <function>nextval</function>=11 before session A
-   has generated <literal>nextval</literal>=2.  Thus, with a
+   has generated <function>nextval</function>=2.  Thus, with a
    <replaceable class="parameter">cache</replaceable> setting of one
    it is safe to assume that <function>nextval</function> values are generated
    sequentially; with a <replaceable
    class="parameter">cache</replaceable> setting greater than one you
    should only assume that the <function>nextval</function> values are all
    distinct, not that they are generated purely sequentially.  Also,
    <literal>last_value</literal> will reflect the latest value reserved by
    any session, whether or not it has yet been returned by
    <function>nextval</function>.
   </para>

Attachments:

create_sequence.difftext/x-patch; charset=US-ASCII; name=create_sequence.diffDownload+1-1
#2Tatsuo Ishii
t-ishii@sra.co.jp
In reply to: Noboru Saito (#1)
Re: Only one nextval tag is different

Yes, it seems using <literal> tag for nextval is plain wrong because
nextval is a function name. Moreover in other places <function> tags
are used and using <literal> tag here looks inconsistent.

Best reagards,
--
Tatsuo Ishii
SRA OSS LLC
English: http://www.sraoss.co.jp/index_en.php
Japanese:http://www.sraoss.co.jp

Show quoted text

Hello, I am a member of the PostgreSQL documentation Japanese translation team.

I noticed that the nextval tag in ref/create_sequence.sgml is different.
Is this just a mistake?

diff --git a/doc/src/sgml/ref/create_sequence.sgml
b/doc/src/sgml/ref/create_sequence.sgml
index a84aa5bf56..34e9084b5c 100644
--- a/doc/src/sgml/ref/create_sequence.sgml
+++ b/doc/src/sgml/ref/create_sequence.sgml
@@ -303,21 +303,21 @@ SELECT * FROM <replaceable>name</replaceable>;
</para>
<para>
Furthermore, although multiple sessions are guaranteed to allocate
distinct sequence values, the values might be generated out of
sequence when all the sessions are considered.  For example, with
a <replaceable class="parameter">cache</replaceable> setting of 10,
session A might reserve values 1..10 and return
<function>nextval</function>=1, then session B might reserve values
11..20 and return <function>nextval</function>=11 before session A
-   has generated <literal>nextval</literal>=2.  Thus, with a
+   has generated <function>nextval</function>=2.  Thus, with a
<replaceable class="parameter">cache</replaceable> setting of one
it is safe to assume that <function>nextval</function> values are generated
sequentially; with a <replaceable
class="parameter">cache</replaceable> setting greater than one you
should only assume that the <function>nextval</function> values are all
distinct, not that they are generated purely sequentially.  Also,
<literal>last_value</literal> will reflect the latest value reserved by
any session, whether or not it has yet been returned by
<function>nextval</function>.
</para>
#3Tatsuo Ishii
t-ishii@sra.co.jp
In reply to: Tatsuo Ishii (#2)
Re: Only one nextval tag is different

Hello, I am a member of the PostgreSQL documentation Japanese translation team.

I noticed that the nextval tag in ref/create_sequence.sgml is different.
Is this just a mistake?

Patch pushed to all supported branches.
Thanks!
--
Tatsuo Ishii
SRA OSS LLC
English: http://www.sraoss.co.jp/index_en.php
Japanese:http://www.sraoss.co.jp

#4Noboru Saito
noborusai@gmail.com
In reply to: Tatsuo Ishii (#3)
Re: Only one nextval tag is different

Thank you!

2022年8月16日(火) 9:40 Tatsuo Ishii <ishii@sraoss.co.jp>:

Show quoted text

Hello, I am a member of the PostgreSQL documentation Japanese

translation team.

I noticed that the nextval tag in ref/create_sequence.sgml is different.
Is this just a mistake?

Patch pushed to all supported branches.
Thanks!
--
Tatsuo Ishii
SRA OSS LLC
English: http://www.sraoss.co.jp/index_en.php
Japanese:http://www.sraoss.co.jp