From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Reuben Thomas Newsgroups: gmane.emacs.bugs Subject: bug#1368: Confusing documentation for c-tab-always-indent Date: Tue, 18 Nov 2008 12:48:15 +0100 (CET) Message-ID: Reply-To: Reuben Thomas , 1368@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Trace: ger.gmane.org 1227010231 12951 80.91.229.12 (18 Nov 2008 12:10:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 18 Nov 2008 12:10:31 +0000 (UTC) To: bug-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Nov 18 13:11:32 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1L2PQX-0003B2-Ld for geb-bug-gnu-emacs@m.gmane.org; Tue, 18 Nov 2008 13:11:30 +0100 Original-Received: from localhost ([127.0.0.1]:43860 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L2PPO-0002Yg-Ts for geb-bug-gnu-emacs@m.gmane.org; Tue, 18 Nov 2008 07:10:18 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L2PPK-0002XE-RW for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 07:10:14 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L2PPH-0002UJ-LC for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 07:10:13 -0500 Original-Received: from [199.232.76.173] (port=53008 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L2PPH-0002UG-Hm for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 07:10:11 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:60237) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L2PPH-0003A4-9f for bug-gnu-emacs@gnu.org; Tue, 18 Nov 2008 07:10:11 -0500 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAICA8Sq007655; Tue, 18 Nov 2008 04:10:09 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id mAIBt4Qs002785; Tue, 18 Nov 2008 03:55:04 -0800 X-Loop: don@donarmstrong.com Resent-From: Reuben Thomas Resent-To: bug-submit-list@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: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12270089121404 (code B ref -1); Tue, 18 Nov 2008 11:55:03 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 18 Nov 2008 11:48:32 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-Received: by ug-out-1314.google.com with SMTP id b39so188567ugd.15 for ; Tue, 18 Nov 2008 03:48:19 -0800 (PST) Original-Received: by 10.103.12.16 with SMTP id p16mr1673823mui.41.1227008898760; Tue, 18 Nov 2008 03:48:18 -0800 (PST) Original-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) User-Agent: Alpine 2.00 (DEB 1167 2008-08-23) 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) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Tue, 18 Nov 2008 07:10:13 -0500 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:22469 Archived-At: 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