Thread: Only one nextval tag is different

Only one nextval tag is different

From
Noboru Saito
Date:
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>

Attachment

Re: Only one nextval tag is different

From
Tatsuo Ishii
Date:
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

> 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>



Re: Only one nextval tag is different

From
Tatsuo Ishii
Date:
>> 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



Re: Only one nextval tag is different

From
Noboru Saito
Date:
Thank you! 

2022年8月16日(火) 9:40 Tatsuo Ishii <ishii@sraoss.co.jp>:
>> 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