[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [GNUnet-developers] clang-format and comments
From: |
ng0 |
Subject: |
Re: [GNUnet-developers] clang-format and comments |
Date: |
Mon, 29 Apr 2019 13:24:16 +0000 |
address@hidden transcribed 746 bytes:
> Hi,
>
> I see clang-format at the moment is messing up our comments.
> If we set ReflowComments to false, this would be much easier
> for documentation parsing.
>
> I have to consider the cases where not all of a doxygen command
> is on one line, but for now and for general style purposes we
> should not reflow the comments.
> We do have some very long lines, but in my opinion comment
> length should not matter.
>
> This would also allow us to specify a doxygen style - we already
> have one, but it is not documented.
>
> I'd push this change if you agree on this.
Done after Offlist.
> Otherwise I'll deal with the changes.
I'll have to have a structure to work around this in a generic way
anyway, but having more freedom on comments is a good property
unless someone has good reasons why we should break this.