Re: [C source] Inconsistent comments on preprocessor conditionals

[Alan Mackenzie <acm@muc.de>]

Hello, Akib

On Fri, Jul 08, 2022 at 18:47:33 +0600, Akib Azmain Turja wrote:

> In some parts of the C source, preprocessor conditionals are commented
> like the following:

> --8<---------------cut here---------------start------------->8---
> #ifdef FOO
> ...
> #else /* not FOO */
> ...
> #endif /* FOO */
> --8<---------------cut here---------------end--------------->8---

> I became confused at the first glance.  But after seeing like the
> following in some other part:

> --8<---------------cut here---------------start------------->8---
> #ifdef FOO
> ...
> #else /* not FOO */
> ...
> #endif /* not FOO */
> --8<---------------cut here---------------end--------------->8---

> I became even more confused.  Why it's inconsistent?  And what should I
> do when adding new conditional blocks?  Should I follow the GNU coding
> standards (the second one)?

Just as an aside, be aware (if you're not already) that you can navigate
the preprocessor commands with the key sequences C-c C-n, C-c C-p, and
C-c C-u.

> -- 
> Akib Azmain Turja

> This message is signed by me with my GnuPG key.  It's fingerprint is:

>     7001 8CE5 819F 17A3 BBA6  66AF E74F 0EFA 922A E7F5

-- 
Alan Mackenzie (Nuremberg, Germany).