| From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
|---|---|
| To: | Dan Colish <dan(at)unencrypted(dot)org> |
| Cc: | PGSQL-HACKERS <pgsql-hackers(at)postgresql(dot)org>, Bruce Momjian <bruce(at)momjian(dot)us> |
| Subject: | Re: one line comment style |
| Date: | 2009-10-08 16:26:12 |
| Message-ID: | 25653.1255019172@sss.pgh.pa.us |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
Dan Colish <dan(at)unencrypted(dot)org> writes:
> I'm going through a few files and trying to clean them up for style mostly and a
> bit of refactoring. I am curious about the preferred style for a one line
> comment. I see them in both of these forms and I would like to keep it
> consistent.
> /* a one line comment */
> or
> /*
> * a one line comment
> */
I think either one can be reasonable depending on how important the
comment is, or whether you want more of a visual separation between
separate blocks of code as opposed to an in-line note.
One thing that would be worth checking before you expend too much
manual effort on that is whether pg_indent will convert one style
to the other. Offhand I don't recall that it does, but if it did
then it'd undo your work ...
regards, tom lane
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Alvaro Herrera | 2009-10-08 16:29:22 | Re: one line comment style |
| Previous Message | Tom Lane | 2009-10-08 16:21:00 | Re: COPY enhancements |