Re: On /*----- comments - Mailing list pgsql-hackers

From Tom Lane
Subject Re: On /*----- comments
Date
Msg-id 1760635.1688138535@sss.pgh.pa.us
Whole thread Raw
In response to On /*----- comments  (Heikki Linnakangas <hlinnaka@iki.fi>)
Responses Re: On /*----- comments
List pgsql-hackers
Heikki Linnakangas <hlinnaka@iki.fi> writes:
> Except for the translator comments, I think those others forgot about 
> the end-guards by accident. But they look just as nice to me. It's 
> probably not worth the code churn to remove them from existing comments, 
> but how about we stop requiring them in new code, and update the 
> pgindent README accordingly?

Seems reasonable; the trailing dashes eat a line without adding much.

Should we also provide specific guidance about how many leading dashes
to use for this?  I vaguely recall that pgindent might only need one,
but I think using somewhere around 5 to 10 looks better.

            regards, tom lane



pgsql-hackers by date:

Previous
From: Heikki Linnakangas
Date:
Subject: On /*----- comments
Next
From: Matthias van de Meent
Date:
Subject: Re: XLog size reductions: Reduced XLog record header size for PG17