From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Magne Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#7521: 24.0.50; doc for `delimit-columns-*' Date: Sat, 02 Jul 2011 17:34:30 +0200 Message-ID: References: <6AF7D745DDFA44439FAE15E2647441AF@us.oracle.com> <06B232927CEE40FC91F8398F1EFDDF97@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1309621592 3915 80.91.229.12 (2 Jul 2011 15:46:32 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 2 Jul 2011 15:46:32 +0000 (UTC) Cc: 7521@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jul 02 17:46:26 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 1Qd2Oo-00037K-6d for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Jul 2011 17:46:26 +0200 Original-Received: from localhost ([::1]:48598 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qd2On-00035G-Iv for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Jul 2011 11:46:25 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:59263) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qd2OT-00034Z-Od for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 11:46:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qd2OR-000223-PA for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 11:46:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:41281) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qd2OR-00021j-GL for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 11:46:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qd2OQ-00078J-MX; Sat, 02 Jul 2011 11:46:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Magne Ingebrigtsen 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 15:46:02 +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.130962150624342 (code B ref 7521); Sat, 02 Jul 2011 15:46:02 +0000 Original-Received: (at 7521) by debbugs.gnu.org; 2 Jul 2011 15:45:06 +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 1Qd2NV-0006KO-Jr for submit@debbugs.gnu.org; Sat, 02 Jul 2011 11:45:05 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qd2NS-0006GM-Lb for 7521@debbugs.gnu.org; Sat, 02 Jul 2011 11:45:03 -0400 Original-Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1Qd2NH-0007fd-5E; Sat, 02 Jul 2011 17:44:51 +0200 In-Reply-To: <06B232927CEE40FC91F8398F1EFDDF97@us.oracle.com> (Drew Adams's message of "Sat, 2 Jul 2011 08:21:40 -0700") User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAFVBMVEUYAgdwNSj7v2RXIRsz Dw69ZTUiBgs+heLhAAACUklEQVQ4jV2Ty46jMBBFS+oW6/EYsg8j9rHsZN3INbWHjPe0sPz/n9C3 iqQf4wUCDvW6tyDnfGKWRhu1tlVplbkKMwFEFq6z7CeidxFpOLWS8y5mqfvt5PwbpTz/ak0Z+eic E6m4usvrKTjX9ssBgvP+tKcU2+UlxhQk1tvWyIWgqN0azT3htOZ92wjA+ZykcaNEBl6yT9SRd4vP 1gk9z+57ADcMnnWQ7RPQa3zbaMAg/4MWekHEooC/paJuzwA4pskBOg2gl9g+wbdM3UbdASI3oZ/n CaThs5xysh46G1ABnhvVoQxLNCAwQQGEx9O8jlO5a7FO4z9BvY7jON3TZtVJ/VATqcsKximhDSRu D3Dpah4M9OiDv8Bb41hWy6WgVUwePRzZOMUyDQiI0AArgWWIMbooKc5juY7l7J4A/gUXa4rXcS1r KcvtC6Dd2huYxlISAIqgeHAhGZjWqaxTMhMqtgQhB0BP0zr2LNXWJ6G41JuBcSwA7QDa1a3KAcoP 4NypSg4632LAdiYGjN4DuGKSTF5tZgUqSZM8DKsR2Kn9kmZyXvgJSmbrl7yJKJX/lnVVdQ8gNiD+ g5rmqUDfhQ/AFC0XwA5jS+k5yzegqaomKqjW9H0lDB4WL7uBsdz5cSixaoXw2SLuVqIqQK7ENfHV QHzUFtIu8HOnaM0uMSf2B8ClZhfDZGAJkYtaQsgnYVgOpc7DcndlWgygO7w/9DiXctf1QgjBeF3a 9Qmcgn8AkF6dWB/+LbZ2fwxg/RVMqP0bSMFZKsD7cFgEBY843Ev9AEeN5tNPmQbbAAAAAElFTkSu QmCC X-Now-Playing: Current 93's _All the Pretty Little Horses_: "Calling for Vanished Faces I." X-Hashcash: 1:23:110702:drew.adams@oracle.com::IuDFRSPVEVOo7oHR:0000000000000000000000000000000000000000JbHX X-Hashcash: 1:23:110702:7521@debbugs.gnu.org::U8PoD9bIHT4vJN3l:00000000000000000000000000000000000000000aikl X-MailScanner-ID: 1Qd2NH-0007fd-5E MailScanner-NULL-Check: 1310226291.4192@wUMK6MI3Zueg5iLJhTA/gQ X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 02 Jul 2011 11:46:02 -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:47765 Archived-At: "Drew Adams" writes: > 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. It wouldn't be very productive to explain the concept of a Message buffer in each message-mode command, for instance. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/