Docs: Standardize "cannot" usage in SGML source

Started by Chao Li5 months ago3 messageshackers
Jump to latest
#1Chao Li
li.evan.chao@gmail.com

Hi Hacker,

While reviewing a patch, I happened to notice the PG docs prefer “cannot”
than “can not”.

Under doc/src/sgml, if we count:
```
sgml % grep -r "cannot" . | wc -l
818
```

“Cannot” has 818 occurrences, but “can not” has only 3:
```
sgml % grep -rE "can\s+not" .
./ecpg.sgml: some SQL statement is declared, "database" can not be used
as a cursor
./func/func-aggregate.sgml: The <parameter>key</parameter> can not
be null. If the
./func/func-aggregate.sgml: The <parameter>key</parameter> can not
be null. If the
```

So, maybe we should fix these 3 and keep a consistent usage of “cannot”.

Best regards,
--
Chao Li (Evan)
HighGo Software Co., Ltd.
https://www.highgo.com/

Attachments:

v1-0001-Docs-Standardize-cannot-usage-in-SGML-source.patchapplication/octet-stream; name=v1-0001-Docs-Standardize-cannot-usage-in-SGML-source.patchDownload+3-4
#2Bruce Momjian
bruce@momjian.us
In reply to: Chao Li (#1)
Re: Docs: Standardize "cannot" usage in SGML source

On Thu, Dec 11, 2025 at 06:00:20PM +0800, Chao Li wrote:

Hi Hacker,

While reviewing a patch, I happened to notice the PG docs prefer “cannot” than
“can not”.

Under doc/src/sgml, if we count:
```
sgml % grep -r "cannot" . | wc -l
     818
```

“Cannot” has 818 occurrences, but “can not” has only 3:

Looks good, patch applied.

--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EDB https://enterprisedb.com

Do not let urgent matters crowd out time for investment in the future.

#3Chao Li
li.evan.chao@gmail.com
In reply to: Bruce Momjian (#2)
Re: Docs: Standardize "cannot" usage in SGML source

On Dec 25, 2025, at 04:12, Bruce Momjian <bruce@momjian.us> wrote:

On Thu, Dec 11, 2025 at 06:00:20PM +0800, Chao Li wrote:

Hi Hacker,

While reviewing a patch, I happened to notice the PG docs prefer “cannot” than
“can not”.

Under doc/src/sgml, if we count:
```
sgml % grep -r "cannot" . | wc -l
818
```

“Cannot” has 818 occurrences, but “can not” has only 3:

Looks good, patch applied.

Thanks a lot for pushing.

Best regards,
--
Chao Li (Evan)
HighGo Software Co., Ltd.
https://www.highgo.com/