Re: Document NULL

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: jian he <jian(dot)universality(at)gmail(dot)com>
Cc: Jeff Davis <pgsql(at)j-davis(dot)com>, Yugo NAGATA <nagata(at)sraoss(dot)co(dot)jp>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Peter Eisentraut <peter(at)eisentraut(dot)org>, David Rowley <dgrowleyml(at)gmail(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>, Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>
Subject: Re: Document NULL
Date: 2025-01-16 22:41:06
Message-ID: CAKFQuwZY28qeYB0s_gU0eOg0_GAerLpbB=Wtc27_PTZGwKyFgw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

In reply to Marcos:

> The word below is commonly used on DOCs, but I didn't find it as a link.
Wouldn't it be better to write what you are linking to, instead of the word
below ?

I've changed many of these links into simple xref elements for now. I may
add alternate text but since the majority of the docs seem fine with bare
xref I'm just going with that here as well.

On Sat, Dec 28, 2024 at 8:30 PM jian he <jian(dot)universality(at)gmail(dot)com> wrote:

> hi.
>
> "SQL specification" should be "SQL standard"?
>
> + another null vale and unequal to all other values.
> typo. should be "another null value"
>
> other places using subsection, many places in doc/src/sgml/nullvalues.sgml
> using "sub-section".
>

Fixed all of these.

> + Notice two important behaviors: first, even though we passed in a
> null value to
> + to the <literal>set_config</literal> function, the
> <literal>current_setting</literal>
> there is two "to to".
>
> gmail has grammar checks, chatgpt can also help find typos.
> you can give it a try.
>

Yeah, I did spell check but not a grammar check. These weren't spelling
errors though. Anyway, good point running the resultant web page through
chatgpt or grammar-aware program.

I still need to put together the example changes in these last couple of
suggestions. The attached v6 omits those and the indenting - and I've
consolidated it back into a single patch.

David J.

Attachment Content-Type Size
v6-0001-Document-NULL.patch text/x-patch 71.7 KB

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Melanie Plageman 2025-01-16 22:50:14 Re: Trigger more frequent autovacuums of heavy insert tables
Previous Message Hannu Krosing 2025-01-16 22:29:05 Re: Purpose of wal_init_zero