From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: [C source] Inconsistent comments on preprocessor conditionals Date: Fri, 8 Jul 2022 13:47:30 +0000 Message-ID: References: <87sfnb3h5m.fsf@disroot.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26667"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Akib Azmain Turja Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Jul 08 15:50:03 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1o9oMt-0006jr-BA for ged-emacs-devel@m.gmane-mx.org; Fri, 08 Jul 2022 15:50:03 +0200 Original-Received: from localhost ([::1]:35558 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o9oMr-00074V-U2 for ged-emacs-devel@m.gmane-mx.org; Fri, 08 Jul 2022 09:50:01 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:41854) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o9oKW-0004Lw-VZ for emacs-devel@gnu.org; Fri, 08 Jul 2022 09:47:36 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:51750 helo=mail.muc.de) by eggs.gnu.org with smtp (Exim 4.90_1) (envelope-from ) id 1o9oKU-0001N7-S7 for emacs-devel@gnu.org; Fri, 08 Jul 2022 09:47:36 -0400 Original-Received: (qmail 62401 invoked by uid 3782); 8 Jul 2022 13:47:31 -0000 Original-Received: from acm.muc.de (p4fe15b6e.dip0.t-ipconnect.de [79.225.91.110]) (using STARTTLS) by colin.muc.de (tmda-ofmipd) with ESMTP; Fri, 08 Jul 2022 15:47:30 +0200 Original-Received: (qmail 6470 invoked by uid 1000); 8 Jul 2022 13:47:30 -0000 Content-Disposition: inline In-Reply-To: <87sfnb3h5m.fsf@disroot.org> X-Submission-Agent: TMDA/1.3.x (Ph3nix) X-Primary-Address: acm@muc.de Received-SPF: pass client-ip=193.149.48.1; envelope-from=acm@muc.de; helo=mail.muc.de X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:291966 Archived-At: 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).