From unknown Sun Aug 10 16:46:28 2025 X-Loop: don@donarmstrong.com Subject: bug#1368: Confusing documentation for c-tab-always-indent Reply-To: Reuben Thomas , 1368@debbugs.gnu.org Resent-From: Reuben Thomas Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Tue, 18 Nov 2008 11:55:03 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 1368 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12270089121404 (code B ref -1); Tue, 18 Nov 2008 11:55:03 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-8.0 required=4.0 tests=BAYES_00,RCVD_IN_DNSWL_MED autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at submit) by emacsbugs.donarmstrong.com; 18 Nov 2008 11:48:32 +0000 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAIBmT8L001398 for ; Tue, 18 Nov 2008 03:48:30 -0800 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L2P4G-0007OF-5K for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 06:48:28 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L2P4E-0007NI-Hb for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 06:48:27 -0500 Received: from [199.232.76.173] (port=50596 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L2P4E-0007ND-Ev for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 06:48:26 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:43067) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1L2P4E-00014P-7o for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 06:48:26 -0500 Received: from mail.gnu.org ([199.232.76.166]:33259 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1L2P46-0002sS-FV for bug-emacs@gnu.org; Tue, 18 Nov 2008 06:48:18 -0500 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1L2P4C-00014D-SS for bug-emacs@gnu.org; Tue, 18 Nov 2008 06:48:25 -0500 Received: from exprod7og111.obsmtp.com ([64.18.2.175]:47386) by monty-python.gnu.org with smtp (Exim 4.60) (envelope-from ) id 1L2P4C-00013x-GD for bug-emacs@gnu.org; Tue, 18 Nov 2008 06:48:24 -0500 Received: from source ([66.249.92.172]) by exprod7ob111.postini.com ([64.18.6.12]) with SMTP ID DSNKSSKrg4r2fwtJcnU4U/OwM6sdbyN39+XX@postini.com; Tue, 18 Nov 2008 03:48:24 PST Received: by ug-out-1314.google.com with SMTP id b39so188567ugd.15 for ; Tue, 18 Nov 2008 03:48:19 -0800 (PST) Received: by 10.103.12.16 with SMTP id p16mr1673823mui.41.1227008898760; Tue, 18 Nov 2008 03:48:18 -0800 (PST) Received: from 101.8.103-84.rev.gaoland.net (101.8.103-84.rev.gaoland.net [84.103.8.101]) by mx.google.com with ESMTPS id i5sm14406633mue.11.2008.11.18.03.48.16 (version=TLSv1/SSLv3 cipher=RC4-MD5); Tue, 18 Nov 2008 03:48:17 -0800 (PST) Date: Tue, 18 Nov 2008 12:48:15 +0100 (CET) From: Reuben Thomas To: bug-emacs@gnu.org Message-ID: User-Agent: Alpine 2.00 (DEB 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) The docstring says: Note: The value of `indent-tabs-mode' will determine whether a real tab character will be inserted, or the equivalent number of spaces. When inserting a tab, actually the function stored in the variable `c-insert-tab-function' is called. But this is not quite true. As far as I can tell from the code, indent-tabs-mode is not tested before calling c-insert-tab-function. What the documentation seems to mean is that if c-insert-tab-function has its default definition, insert-tab, then the first sentence applies. I suggest therefore the following paragraph in place of the above: The function stored in the variable `c-insert-tab-function' is called when a tab is to be inserted. By default, this function is `insert-tab', which uses the value of `indent-tabs-mode' to determine whether a real tab character will be inserted, or the equivalent number of spaces. -- http://rrt.sc3d.org/ | fantasize, a. the largest you can imagine From unknown Sun Aug 10 16:46:28 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.420 (Entity 5.420) X-Loop: don@donarmstrong.com From: help-debbugs@gnu.org (Emacs bug Tracking System) To: Reuben Thomas Subject: bug#1368 closed by Glenn Morris (Re: bug#1368: Confusing documentation for c-tab-always-indent) Message-ID: References: X-Emacs-PR-Message: they-closed 1368 X-Emacs-PR-Package: emacs,cc-mode Reply-To: 1368@debbugs.gnu.org Content-Type: multipart/mixed; boundary="----------=_1228189506-26284-1" This is a multi-part message in MIME format... ------------=_1228189506-26284-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" This is an automatic notification regarding your bug report which was filed against the emacs,cc-mode package: #1368: Confusing documentation for c-tab-always-indent It has been closed by Glenn Morris . Their explanation is attached below along with your original report. If this explanation is unsatisfactory and you have not received a better one in a separate message then please contact Glenn Morris by replying to this email. --=20 1368: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D1368 Emacs Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1228189506-26284-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit >From rgm@gnu.org Mon Dec 1 19:38:55 2008 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-11.3 required=4.0 tests=AWL,BAYES_00,HAS_BUG_NUMBER, RCVD_IN_DNSWL_MED,TVD_SPACE_RATIO,X_DEBBUGS_NO_ACK autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at 1368-done) by emacsbugs.donarmstrong.com; 2 Dec 2008 03:38:55 +0000 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mB23cqhb024823 for <1368-done@emacsbugs.donarmstrong.com>; Mon, 1 Dec 2008 19:38:54 -0800 Received: from rgm by fencepost.gnu.org with local (Exim 4.67) (envelope-from ) id 1L7M5j-0000CI-HA; Mon, 01 Dec 2008 22:38:27 -0500 From: Glenn Morris To: 1368-done@debbugs.gnu.org Subject: Re: bug#1368: Confusing documentation for c-tab-always-indent References: X-Spook: computer terrorism Afghanistan blackjack Mafia Medco X-Ran: Prm_wGiDoQwS2^v, (Reuben Thomas's message of "Tue, 18 Nov 2008 12:48:15 +0100 (CET)") Message-ID: User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii 2008-12-02 Glenn Morris * progmodes/cc-vars.el (c-tab-always-indent, c-insert-tab-function): Doc fix. (Bug#1368) ------------=_1228189506-26284-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit >From rrt@sc3d.org Tue Nov 18 03:48:32 2008 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-8.0 required=4.0 tests=BAYES_00,RCVD_IN_DNSWL_MED autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at submit) by emacsbugs.donarmstrong.com; 18 Nov 2008 11:48:32 +0000 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAIBmT8L001398 for ; Tue, 18 Nov 2008 03:48:30 -0800 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L2P4G-0007OF-5K for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 06:48:28 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L2P4E-0007NI-Hb for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 06:48:27 -0500 Received: from [199.232.76.173] (port=50596 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L2P4E-0007ND-Ev for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 06:48:26 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:43067) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1L2P4E-00014P-7o for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 06:48:26 -0500 Received: from mail.gnu.org ([199.232.76.166]:33259 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1L2P46-0002sS-FV for bug-emacs@gnu.org; Tue, 18 Nov 2008 06:48:18 -0500 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1L2P4C-00014D-SS for bug-emacs@gnu.org; Tue, 18 Nov 2008 06:48:25 -0500 Received: from exprod7og111.obsmtp.com ([64.18.2.175]:47386) by monty-python.gnu.org with smtp (Exim 4.60) (envelope-from ) id 1L2P4C-00013x-GD for bug-emacs@gnu.org; Tue, 18 Nov 2008 06:48:24 -0500 Received: from source ([66.249.92.172]) by exprod7ob111.postini.com ([64.18.6.12]) with SMTP ID DSNKSSKrg4r2fwtJcnU4U/OwM6sdbyN39+XX@postini.com; Tue, 18 Nov 2008 03:48:24 PST Received: by ug-out-1314.google.com with SMTP id b39so188567ugd.15 for ; Tue, 18 Nov 2008 03:48:19 -0800 (PST) Received: by 10.103.12.16 with SMTP id p16mr1673823mui.41.1227008898760; Tue, 18 Nov 2008 03:48:18 -0800 (PST) Received: from 101.8.103-84.rev.gaoland.net (101.8.103-84.rev.gaoland.net [84.103.8.101]) by mx.google.com with ESMTPS id i5sm14406633mue.11.2008.11.18.03.48.16 (version=TLSv1/SSLv3 cipher=RC4-MD5); Tue, 18 Nov 2008 03:48:17 -0800 (PST) Date: Tue, 18 Nov 2008 12:48:15 +0100 (CET) From: Reuben Thomas To: bug-emacs@gnu.org Subject: Confusing documentation for c-tab-always-indent Message-ID: User-Agent: Alpine 2.00 (DEB 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) The docstring says: Note: The value of `indent-tabs-mode' will determine whether a real tab character will be inserted, or the equivalent number of spaces. When inserting a tab, actually the function stored in the variable `c-insert-tab-function' is called. But this is not quite true. As far as I can tell from the code, indent-tabs-mode is not tested before calling c-insert-tab-function. What the documentation seems to mean is that if c-insert-tab-function has its default definition, insert-tab, then the first sentence applies. I suggest therefore the following paragraph in place of the above: The function stored in the variable `c-insert-tab-function' is called when a tab is to be inserted. By default, this function is `insert-tab', which uses the value of `indent-tabs-mode' to determine whether a real tab character will be inserted, or the equivalent number of spaces. -- http://rrt.sc3d.org/ | fantasize, a. the largest you can imagine ------------=_1228189506-26284-1--