From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Sean Whitton Newsgroups: gmane.emacs.devel Subject: Re: New optional Eshell module: em-elecslash Date: Sat, 16 Apr 2022 13:04:26 -0700 Message-ID: <87fsmckd6d.fsf@melete.silentflame.com> References: <87k0bokg98.fsf@melete.silentflame.com> <83ee1wzvki.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="12328"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Emacs/29.0.50 (x86_64-pc-linux-gnu) Cc: philipk@posteo.net, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Apr 16 22:06:19 2022 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 1nfogT-00030L-Lt for ged-emacs-devel@m.gmane-mx.org; Sat, 16 Apr 2022 22:06:19 +0200 Original-Received: from localhost ([::1]:58144 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nfogS-0006xy-5m for ged-emacs-devel@m.gmane-mx.org; Sat, 16 Apr 2022 16:06:16 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44156) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nfoen-000689-1T for emacs-devel@gnu.org; Sat, 16 Apr 2022 16:04:33 -0400 Original-Received: from wout2-smtp.messagingengine.com ([64.147.123.25]:55209) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nfoel-00013Z-2i; Sat, 16 Apr 2022 16:04:32 -0400 Original-Received: from compute2.internal (compute2.nyi.internal [10.202.2.46]) by mailout.west.internal (Postfix) with ESMTP id A62143201FA0; Sat, 16 Apr 2022 16:04:28 -0400 (EDT) Original-Received: from mailfrontend1 ([10.202.2.162]) by compute2.internal (MEProxy); Sat, 16 Apr 2022 16:04:29 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=spwhitton.name; h=cc:cc:content-type:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:sender :subject:subject:to:to; s=fm3; t=1650139468; x=1650225868; bh=NU 06JHpwQGs4e2Sa/7wPWh3NNLgxr7e2hpUDK7NAfJk=; b=bQzi8lOTwsd/a3QFcz o4uojqWCj2xml1AMd9mKcjfuO4h/fjnEVNrBsfCUbXoCZm9Vj5VeAq9PEn0s1m+f EpA6bxcLuS/D7Jeh55b9NoBJt+zDm6vzDRZWp49W/DFe03K5dkngI6At43kRZZva /p1Wk5PuYTSlo/j2N8xfsEZ8zNGp0Poigk8Rma8YukQrKNY8MomCWTEoHGxaXnuP YPiqExTEWyrOZ6kZvjZ1o4nwsQlERii6LYtGgeZBl1WPoJeFfEPKPuyCUblLq0AB sb4Hb9z5IZQIWziTpDCYORjsFaRv+qYn+zpqFg3TDNN+ZJWftm1w6C7lOq30sGC8 GNsw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-type:date:date:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:sender:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1650139468; x= 1650225868; bh=NU06JHpwQGs4e2Sa/7wPWh3NNLgxr7e2hpUDK7NAfJk=; b=Z HFkuUd6tVxKqYfIjpg4ZMw2A7PRw0hGptCBo4RcgzJo2QRk+xm4TwlI+vXeTkfUV tGutbQjDSWNbiGWA3b74UJg0idDI0F2OKfbo4dmqQtDAWMbGD38lgq62DCIJnwul Bxd5F64JB3ae+V6hp+B1bZ4TLmdXPUKdN6xna+SsYFvPk8ou9fbwCkrYnN0Ejf3v NCHrMeuDDumKsqCC34/djNcd0EEjEtjQpS4exLdgCnPJ+/QjGo2eZ6NohOPoHY3y V6/RMKWppb0tdA9BmnadrYlaje+4+CnFpl8oNQNCLh1POQmiGRJcTeyHxLTyLH0+ P11ArTSJI2rlRsQ7V+afA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvvddrudeljedgudegiecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpefhvffujghffgffkfggtgesthdttddttdertdenucfhrhhomhepufgvrghn ucghhhhithhtohhnuceoshhpfihhihhtthhonhesshhpfihhihhtthhonhdrnhgrmhgvqe enucggtffrrghtthgvrhhnpeelgeeggfdvieejvdfhudfggeetgfekkeeuieeljeejhedu geegfeetgefhueffkeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrih hlfhhrohhmpehsphifhhhithhtohhnsehsphifhhhithhtohhnrdhnrghmvg X-ME-Proxy: Original-Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 16 Apr 2022 16:04:27 -0400 (EDT) Original-Received: by melete.silentflame.com (Postfix, from userid 1000) id CE19C7E511F; Sat, 16 Apr 2022 13:04:26 -0700 (MST) In-Reply-To: <83ee1wzvki.fsf@gnu.org> Received-SPF: pass client-ip=64.147.123.25; envelope-from=spwhitton@spwhitton.name; helo=wout2-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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" Xref: news.gmane.io gmane.emacs.devel:288508 Archived-At: Hello, On Sat 16 Apr 2022 at 10:18PM +03, Eli Zaretskii wrote: >> +If the @code{eshell-elecslash} module has been added to >> +@code{eshell-modules-list}, and @code{default-directory} is remote, >> +then when you type the first forward slash of an argument to a Lisp >> +function, the Tramp prefix will be filled in for you. A second >> +forward slash can be used to undo the insertion, for when you really >> +do want to pass a local absolute path, such as when you want to copy a >> +remote file to the local machine. And when typing arguments to >> +external commands, the Tramp prefix is not filled in. The result is >> +that you don't have to think about inserting the Tramp prefix and can >> +just type absolute paths in the same way for both types of command. >> +The Tramp prefix is additionally filled in when you type @code{~/}. > > You use passive tense a lot (here and elsewhere), which in many cases > makes the text longer, more complicated, and harder to understand. > Please try rephrasing without using passive tense so much. I'm happy to try to make it clearer, but in the U.K. we don't have this idea that the passive voice is worse than the active -- I didn't learn the distinction until after finishing a humanities degree -- so could you be more specific, please? >> +*** New optional Eshell module to help avoid mistakes when supplying > > The first line of a NEWS entry is a heading, so it should be a > complete sentence, to facilitate reading the outlines. Hmm interesting. I found continuing sentences from the outline heading to the next line strange, but noticed that many NEWS entries did it, so thought it was how outline-mode is meant to be used. >> +;;;###autoload >> +(progn >> +(defgroup eshell-elecslash nil >> + "When `default-directory' is remote thanks to Eshell's TRAMP > > the first line of a doc string should be a complete sentence, because > some Help commands only show that single line. > >> +(defun eshell-electric-forward-slash () >> + "Electric insertion of TRAMP part of `default-directory' in >> +remote Eshells. Added to `post-self-insert-hook' when the > > Likewise. I'll try to come up with something. This rule can be very difficult to satisfy given line length restrictions. -- Sean Whitton