From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#7521: 24.0.50; doc for `delimit-columns-*' Date: Sat, 2 Jul 2011 08:59:20 -0700 Message-ID: <91E7FDE1A1EE45B6A5E0214F98214207@us.oracle.com> References: <6AF7D745DDFA44439FAE15E2647441AF@us.oracle.com><06B232927CEE40FC91F8398F1EFDDF97@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1309622544 8349 80.91.229.12 (2 Jul 2011 16:02:24 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 2 Jul 2011 16:02:24 +0000 (UTC) Cc: 7521@debbugs.gnu.org To: "'Lars Magne Ingebrigtsen'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jul 02 18:02:20 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Qd2eB-0008El-0O for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Jul 2011 18:02:19 +0200 Original-Received: from localhost ([::1]:33211 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qd2e9-0005V1-Tf for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Jul 2011 12:02:18 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:45271) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qd2c3-00050r-DJ for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 12:00:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qd2c1-0004BH-Au for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 12:00:06 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:38284) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qd2c0-0004Ax-W0 for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 12:00:05 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qd2bz-0007Uy-8g; Sat, 02 Jul 2011 12:00:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 02 Jul 2011 16:00:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 7521 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 7521-submit@debbugs.gnu.org id=B7521.130962238528751 (code B ref 7521); Sat, 02 Jul 2011 16:00:03 +0000 Original-Received: (at 7521) by debbugs.gnu.org; 2 Jul 2011 15:59:45 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qd2bh-0007Tg-6q for submit@debbugs.gnu.org; Sat, 02 Jul 2011 11:59:45 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qd2bf-0007TT-Dp for 7521@debbugs.gnu.org; Sat, 02 Jul 2011 11:59:44 -0400 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p62FxZAV003677 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 2 Jul 2011 15:59:37 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p62FxZBo027867 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sat, 2 Jul 2011 15:59:35 GMT Original-Received: from abhmt116.oracle.com (abhmt116.oracle.com [141.146.116.68]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p62FxTXh005445; Sat, 2 Jul 2011 10:59:29 -0500 Original-Received: from dradamslap1 (/10.159.63.244) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 02 Jul 2011 08:59:29 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Acw4zwPMP7vdv5OIT6OVuIuht20i1QAAROKw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090204.4E0F4069.0039:SCFMA922111,ss=1,re=-4.000,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 02 Jul 2011 12:00:03 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:47768 Archived-At: > > But even then the doc strings of the various functions > > (these are user _commands_, after all) need to give some > > explanation. If we cannot explain these commands at all > > then maybe that's a sign that the > > commands themselves are overly complex. > > There are oodles of commands tied to various modes/packages > that presume that you're aware of what the general gist of > the package is. There is certainly no need and no use in describing the general gist of a package in the doc for each of the packages commands. That's not the point at all. > It wouldn't be very productive to explain the concept of a > Message buffer in each message-mode command, for instance. Of course, but that's not the request. I don't use `message-mode', but I would guess (hope) that the doc for each of its _commands_ describes that command. If there were a `message-mode' command `msg-delete' (fictitious example) that deleted the current message then I would hope its doc string would say that's what it does.