From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Documentation fix Date: Fri, 07 Apr 2023 15:18:11 +0300 Message-ID: <83ttxroph8.fsf@gnu.org> References: <871qkvq4o4.fsf.ref@yahoo.com> <871qkvq4o4.fsf@yahoo.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="10699"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Po Lu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Apr 07 14:18:21 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 1pkl2q-0002da-PX for ged-emacs-devel@m.gmane-mx.org; Fri, 07 Apr 2023 14:18:20 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pkl2F-0004Fl-8l; Fri, 07 Apr 2023 08:17:43 -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 1pkl2C-0004FT-Q7 for emacs-devel@gnu.org; Fri, 07 Apr 2023 08:17:40 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pkl2C-0003ak-Hl; Fri, 07 Apr 2023 08:17:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=Jag/Q1m72xrZlH5Q535j9ENn193jzzS1QYCp9uJ6nL0=; b=TRLEjjOUn3oB Ezn4QK3xJDcMKCVIKM1W0pR8NhmU373AgMXW7u16KJeOQF6jqGgByWM8feIU/53IME1h9trBCWlAP TEowHPKFjyT7UNV+GQk1RYxVhb8LemSGmo2JafadcsylmaMrV+6zXHGqZEY0vHZ3likq7KMuYdeAW u0IvHANqufyw2M2T8VU74kk7sKAKE6epXGsh+jQGyRJWfgtJK1RGzTQeN/LzIfnpwP06XU2n/xFfd WknIf6Mse/jFZcWryOaryjzccYNhzCmvrY4k7p1HCBKuoUDlyi0hd3x1b0CKwyOGnkCpewp9f8Nxc ZJLCU3jrs4/9qcRNOZUt3Q==; Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pkl2B-0003dQ-DW; Fri, 07 Apr 2023 08:17:39 -0400 In-Reply-To: <871qkvq4o4.fsf@yahoo.com> (message from Po Lu on Fri, 07 Apr 2023 20:04:43 +0800) 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:305158 Archived-At: > From: Po Lu > Date: Fri, 07 Apr 2023 20:04:43 +0800 > > Would someone who can please install the following change to emacs-29? > Savannah seems to be down again. It isn't down from here. > +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. Does this mean the function gets on the basename of the file, without any leading directories? Or does it mean something else? > + 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. How would the function know what is the "right" directory to save the file? Without some hints to that effect, this documentation is not very useful, IMO. > + If the file was successfully saved, And if not? > 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.) ^^^^ I guess, you mean "e.g." there. More importantly, I don't understand why would Emacs need to do anything with the file at all. As a matter of fact, I don't think I understand the purpose of this protocol at all, and I don't see it clarified in the manual. Can you explain what is this used for? Without such explanation, this documentation lacks context without which the information makes no sense. Thanks.