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#11348: 24.0.95; TAB-completion in shell-command produces d:\/foo on MS-Windows Date: Fri, 4 May 2012 17:22:28 -0700 Message-ID: References: <83obqeiwb0.fsf@gnu.org> <83mx5n6ceu.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1336177404 19017 80.91.229.3 (5 May 2012 00:23:24 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 5 May 2012 00:23:24 +0000 (UTC) Cc: 11348@debbugs.gnu.org To: "'Stefan Monnier'" , "'Eli Zaretskii'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat May 05 02:23:22 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SQSmP-0007Yc-6o for geb-bug-gnu-emacs@m.gmane.org; Sat, 05 May 2012 02:23:21 +0200 Original-Received: from localhost ([::1]:54815 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SQSmO-0002zo-DC for geb-bug-gnu-emacs@m.gmane.org; Fri, 04 May 2012 20:23:20 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:44460) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SQSmL-0002zj-Ox for bug-gnu-emacs@gnu.org; Fri, 04 May 2012 20:23:18 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SQSmK-0000In-0Y for bug-gnu-emacs@gnu.org; Fri, 04 May 2012 20:23:17 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:35500) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SQSmJ-0000Ih-T8 for bug-gnu-emacs@gnu.org; Fri, 04 May 2012 20:23:15 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SQSo2-0000fW-1q for bug-gnu-emacs@gnu.org; Fri, 04 May 2012 20:25:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 05 May 2012 00:25:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11348 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 11348-submit@debbugs.gnu.org id=B11348.13361774732530 (code B ref 11348); Sat, 05 May 2012 00:25:02 +0000 Original-Received: (at 11348) by debbugs.gnu.org; 5 May 2012 00:24:33 +0000 Original-Received: from localhost ([127.0.0.1]:36534 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SQSnZ-0000el-69 for submit@debbugs.gnu.org; Fri, 04 May 2012 20:24:33 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:17982) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SQSnW-0000eX-TP for 11348@debbugs.gnu.org; Fri, 04 May 2012 20:24:31 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q450MZHK015703 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 5 May 2012 00:22:36 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q450MYTq003204 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sat, 5 May 2012 00:22:35 GMT Original-Received: from abhmt107.oracle.com (abhmt107.oracle.com [141.146.116.59]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q450MYEB001537; Fri, 4 May 2012 19:22:34 -0500 Original-Received: from dradamslap1 (/10.159.172.28) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 04 May 2012 17:22:33 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Ac0qTk2FAvSdy644SzGLvDmv08irYwABjrEg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) 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:59763 Archived-At: > > description of the control and data flow in several popular > > use-cases. > > Not sure what that could look like. Would the following be helpful? > > For completion--file-name-table... ... Yes, this kind of thing is helpful. I think, at least for what you just wrote, that simply adding it to the source file would be a good way to communicate it. Some other info might be more directed to users of the functions concerned, and so could be added to the Elisp manual. But for purposes of understanding the code it should be sufficient to comment the file with similar text to what you wrote.