Do not use C++ style comments (// comments). Strict ANSI C compilers do not accept them.

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: andast(at)kth(dot)se
Subject: Do not use C++ style comments (// comments). Strict ANSI C compilers do not accept them.
Date: 2019-09-23 14:39:06
Message-ID: 156924954640.1117.6309209869705522549@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/11/source-format.html
Description:

This sentence in the style guide feels outdated. // style comments have been
in the ANSI C standard for almost 20 years now (C99 was accepted as ANSI
standard in may 2000). I suggest rewording this to "Do not use C99 style
comments (// comments). Strict C89 compilers do not accept them." or come up
with some other reason for /**/ style being preferred to // style since I'm
not entierly convinced postgres compiles on C89 anyways.

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2019-09-23 14:42:32 Re: fix tags in v12 Release Notes
Previous Message Tom Lane 2019-09-23 14:32:46 Re: Fix contributor name-related inconsistencies in release-12.sgml