Re: Only one nextval tag is different
Tatsuo Ishii <ishii@sraoss.co.jp>
From: Tatsuo Ishii <ishii@sraoss.co.jp>
To: noborusai@gmail.com
Cc: pgsql-docs@lists.postgresql.org
Date: 2022-08-14T21:54:20Z
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>
Commits
-
doc: fix wrong tag used in create sequence manual.
- 64f0bc002265 10.23 landed
- 9d4c9c35bae4 11.18 landed
- d0e5dc7d30aa 12.13 landed
- dc9ed21a4f4f 13.9 landed
- a1a5e6d95cc9 14.6 landed
- 16c68567b58e 15.0 landed
- f4c32cdd1cc3 16.0 landed