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