From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Po Lu Newsgroups: gmane.emacs.devel Subject: Documentation fix Date: Fri, 07 Apr 2023 20:04:43 +0800 Message-ID: <871qkvq4o4.fsf@yahoo.com> References: <871qkvq4o4.fsf.ref@yahoo.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="28767"; mail-complaints-to="usenet@ciao.gmane.io" To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Apr 07 14:05:47 2023 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pkkqh-0007Ne-H0 for ged-emacs-devel@m.gmane-mx.org; Fri, 07 Apr 2023 14:05:47 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pkkpz-0001Bm-A4; Fri, 07 Apr 2023 08:05:03 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pkkpw-0001BS-Gk for emacs-devel@gnu.org; Fri, 07 Apr 2023 08:05:00 -0400 Original-Received: from sonic301-31.consmr.mail.ne1.yahoo.com ([66.163.184.200]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pkkpt-00070F-DX for emacs-devel@gnu.org; Fri, 07 Apr 2023 08:05:00 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1680869094; bh=5v6laxsljLTCrWI/jZxShJb/gE+mUshvWcqrimqSecA=; h=From:To:Subject:Date:References:From:Subject:Reply-To; b=lzbgFq7kNgL+cEIyQO3pXHNOnQUIESGFpba9jZIgUYLDggCYD1Zl/ESYShIhvFQ75EUl96Zrm9OIG3zfrhzRl1nw73UtkOZ0ouxPsgf2biydQKZTX5IirXcYre/46Kz99zR0YnWgR7nstNOpVoj7KfsEu6uLOVqW3Jwawuc+jRw9uRpeqzdeQog76yRraSAy+WPKoUppBWYJNk0aXnfqgOJ09przIfCh4+LXPO46L9bMItDafHy3BWwYyIkJ1tw4Nq0j3pH5o6yvIO753kxciCPtZyTEbUYTffumijjc6C2hjU+F4Ssnm1eQ1WYVWkpyNBzO3lYy2EuHLUaoiVwuBA== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1680869094; bh=UlW8zmdTIJvN/QKsz9XYyHPzC+UDfv7/DrOPadAH64k=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=dEvVW9eqe/X5Mm4ZrIlp/6OkTUHdzFDStACWhlJbTluMedpF4RpzUXsMUd2sKQDXmSCgsYu2EAJs698CWzqvOcn6fBsXeIZXWRDVWMt0Gbk1y/9kn3Mma4ALCAh6UoC3B9ZjfnzUnLR8wqHTT7d8tetTI0Cbv5qafaIB+EvnkGkZqupRDppzkLiFTrtlUt5N3KSDQFx/itCXIkKi5/MgkYP6TzYnDTqjuSroP8ol2pUExHjWM4KZsMY6guqDlQeh7uhjQb6UnUjv2NSumZLgtOb01qK1oDQ7uEec2i87/6VJ9Jb5b/64DJAGEYNX4vuYR8ZWjB2oOEWSRI9XhvbFew== X-YMail-OSG: W63stvAVM1mRji_RrcgBlQKtn3SCJHloRMrmlPFLEabfHY7TQ3lglIqwJoJfCsV k.5DtUJklcn5DVLHdJ_1RUAIVMmFpV9s2TjLzUEqfHLAy6tTxnnwFBIZHI5La7QGC7qLjf8S2YBH HMqOqodm8O3tb9PBxkOwJPtRRCfuu0zbMCOUmntHj_bSXu2G2CR7pXhsa1Y0DjvDUpZ1l.w46W3d 3GMI5jUPJ5gdm1HsQepE3WfIGTVdElAh_ta88JJGundh6pT9VD0c.5yPkpWpuudIDLA8lHJi6.bk Idep0hcNGq_gvAVZ7GLTphgpmW8CFpPVrSpAUZcaGXWaqGKsATVsYgVbFoh1XtyVF.._DrFR38qS oVtgIsRdYPBrP7CoXVHl0EfpWnfgV5mRUpddWQjKaGZNMTsjPuMW1aGiipUhP7FpXEFfwoV_0xCs J4BwA2vZ3WByQ4eNg.xZrf32xz666WuoBfEQw39yDobunvKfi6lJCNO_kBvYaGiXHATn3aifT8KQ uDlO2O3vX6SCEp40xpv9MM33sopsoJFZIE8vW1POLgpws6Y8a_lg9GLdrmqs_QfXEV4uiCU6Ecyk qLP2FNiJdSHjRHZoSP8UA0tkPXtXe5ioUtYQ4rFlf.1OGPgwMKtBQEm61KJOsdFpLd37DCxvyoBn 3gLzgNFJ_lUeVbLjNUgoh2Ho.1uAFfne8F8m3SHCXsnj950d7ZvJpwB5ei9YrcCHbiOb1Zx9mRhp pNjo0_4.YP7_aiZjPfjUQ_mPDS3VoFu.FOrJa.IdB6dow0mmhqI9jzXZsfSfjyZT1g4fRoWom7j8 lajmEKKIvwJRszOFEUdcdBm8nAQvH4RxCQzGcYcgD. X-Sonic-MF: X-Sonic-ID: fd9dc339-8d86-469c-a759-23fc20ed75ff Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic301.consmr.mail.ne1.yahoo.com with HTTP; Fri, 7 Apr 2023 12:04:54 +0000 Original-Received: by hermes--production-sg3-6d6fb994f6-5v57h (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID 70f13f6dd80246da766b31f59043b0e4; Fri, 07 Apr 2023 12:04:47 +0000 (UTC) X-Mailer: WebService/1.1.21365 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo Received-SPF: pass client-ip=66.163.184.200; envelope-from=luangruo@yahoo.com; helo=sonic301-31.consmr.mail.ne1.yahoo.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:305157 Archived-At: Would someone who can please install the following change to emacs-29? Savannah seems to be down again. 2023-04-07 Po Lu * doc/lispref/frames.texi (Drag and Drop): Fix description of `x-dnd-direct-save-function'. diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index 9083b4b01c9..fd3bf67cf9f 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -4177,19 +4177,25 @@ Drag and Drop However, @code{x-dnd-types-alist} does not handle a special kind of drop sent by a program that wants Emacs to tell it where to save a file in a specific location determined by the user. These drops are -instead handled by a function that is the value of the variable -@code{x-dnd-direct-save-function}. This function should accept two arguments. -If the first argument is non-@code{nil}, then the second argument is a -file name to save (with leading directories) that the other -program recommends, and the -function should return the full file name under which it should be -saved. After the function completes, Emacs will ask the other program -to save the file under the name that was returned, and if the file was -successfully saved, call the function again with the first argument -set to a non-@code{nil} value and the second argument set to the file -name that was returned. The function should then perform whatever -action is appropriate (i.e., opening the file or refreshing a -directory listing.) +instead handled by a function determined by the variable +@code{x-dnd-direct-save-function}. This function is essentially two +functions in one---its first argument is a boolean which tells it what +operations to perform. + + When the drop takes place, the function is first called with its +first argument set to a non-@code{nil} value, and its second argument +set to a file name that the file should be saved under; this file name +does not contain the directory under which the file should be saved. + + The function should return the complete file name under which the +file should be saved, including the directory where it should be +saved, under which Emacs will ask the other program to save the file. + + If the file was successfully saved, the function is called again, +this time with the first argument set to @code{nil}, and the second +argument set to the file name that was returned. The function should +then perform whatever action is appropriate (i.e., opening the file or +refreshing a directory listing.) @cindex initiating drag-and-drop On capable window systems, Emacs also supports dragging contents