unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* [C source] Inconsistent comments on preprocessor conditionals
@ 2022-07-08 12:47 Akib Azmain Turja
  2022-07-08 12:55 ` Eli Zaretskii
                   ` (2 more replies)
  0 siblings, 3 replies; 12+ messages in thread
From: Akib Azmain Turja @ 2022-07-08 12:47 UTC (permalink / raw)
  To: emacs-devel

[-- Attachment #1: Type: text/plain, Size: 926 bytes --]


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)?

-- 
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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 832 bytes --]

^ permalink raw reply	[flat|nested] 12+ messages in thread

end of thread, other threads:[~2022-07-11 12:42 UTC | newest]

Thread overview: 12+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2022-07-08 12:47 [C source] Inconsistent comments on preprocessor conditionals Akib Azmain Turja
2022-07-08 12:55 ` Eli Zaretskii
2022-07-08 13:33   ` Phil Sainty
2022-07-08 13:37     ` Eli Zaretskii
2022-07-08 13:55       ` Akib Azmain Turja
2022-07-08 14:01         ` Eli Zaretskii
2022-07-08 14:21         ` Phil Sainty
2022-07-08 16:28         ` Sergey Organov
2022-07-08 19:54     ` Stefan Monnier
2022-07-11 12:42       ` Akib Azmain Turja
2022-07-08 12:57 ` Po Lu
2022-07-08 13:47 ` Alan Mackenzie

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).