Re: [PATCH] pg_bsd_indent: improve formatting of multiline comments

From: Aleksander Alekseev <aleksander(at)tigerdata(dot)com>
To: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Cc: Nathan Bossart <nathandbossart(at)gmail(dot)com>, Chao Li <li(dot)evan(dot)chao(at)gmail(dot)com>, Arseniy Mukhin <arseniy(dot)mukhin(dot)dev(at)gmail(dot)com>, Bruce Momjian <bruce(at)momjian(dot)us>, Michael Paquier <michael(at)paquier(dot)xyz>
Subject: Re: [PATCH] pg_bsd_indent: improve formatting of multiline comments
Date: 2025-12-12 11:32:13
Message-ID: CAJ7c6TN2+DiExF=H4rKJ1-hz=QEibGXQ2QNtaaptR+7uZEeuMg@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Hi Nathan,

> [...]
> I think we should also figure out what we want to do for things like this:
>
> ******************************************************************************
> - This file contains routines that can be bound to a Postgres backend and
> - called by the backend in the process of processing queries. The calling
> - format for these routines is dictated by Postgres architecture.
> + * This file contains routines that can be bound to a Postgres backend and
> + * called by the backend in the process of processing queries. The calling
> + * format for these routines is dictated by Postgres architecture.
> ******************************************************************************/
>
> Could we modify the patch to leave these kinds of comments alone?

I see 3 files that have this comment:

- src/tutorial/complex.c
- contrib/seg/seg.c
- contrib/cube/cube.c

Note that cube.c is not affected by the new version of pgindent,
because the comment starts with `/****`. Such comments are kept as is.

seg.c and cube.c use a mixed format. The comments start with `/*`
followed by ` *` lines but several lines below don't have ` *` in the
beginning. I don't instantly see a way to process this situation in
pgindent. We can either let it modify these comments, or alternatively
change the first lines of the comments from `/*` to `/**`.

--
Best regards,
Aleksander Alekseev

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Daniel Gustafsson 2025-12-12 11:41:36 Re: Serverside SNI support in libpq
Previous Message Zsolt Parragi 2025-12-12 11:05:15 Re: Make PGOAUTHCAFILE in libpq-oauth work out of debug mode