Re: Only one nextval tag is different

From: Tatsuo Ishii <ishii(at)sraoss(dot)co(dot)jp>
To: noborusai(at)gmail(dot)com
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Only one nextval tag is different
Date: 2022-08-14 21:54:20
Message-ID: 20220815.065420.49084139082374063.t-ishii@sranhm.sraoss.co.jp
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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>

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Masahiko Sawada 2022-08-15 02:23:02 Re: 52.88. pg_shmem_allocations, missing units
Previous Message Noboru Saito 2022-08-14 19:05:09 Only one nextval tag is different