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.bugs Subject: bug#58071: 28.2; [PATCH] jumprel: A tool to find/create related files Date: Mon, 26 Sep 2022 10:42:15 +0300 Message-ID: <83k05qlgyw.fsf@gnu.org> References: <878rm7wvib.fsf@cassou.me> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="4463"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 58071@debbugs.gnu.org To: Damien Cassou Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Sep 26 10:08:11 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1ocj9s-0000xp-JY for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 26 Sep 2022 10:08:08 +0200 Original-Received: from localhost ([::1]:42060 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ocili-0006Tq-DQ for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 26 Sep 2022 03:43:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57898) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ocila-0006Ti-SK for bug-gnu-emacs@gnu.org; Mon, 26 Sep 2022 03:43:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:50095) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ocila-0008UK-Ji for bug-gnu-emacs@gnu.org; Mon, 26 Sep 2022 03:43:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ocila-0000Fz-9q for bug-gnu-emacs@gnu.org; Mon, 26 Sep 2022 03:43:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 26 Sep 2022 07:43:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 58071 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 58071-submit@debbugs.gnu.org id=B58071.1664178154949 (code B ref 58071); Mon, 26 Sep 2022 07:43:02 +0000 Original-Received: (at 58071) by debbugs.gnu.org; 26 Sep 2022 07:42:34 +0000 Original-Received: from localhost ([127.0.0.1]:49173 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ocil8-0000FE-AA for submit@debbugs.gnu.org; Mon, 26 Sep 2022 03:42:34 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:46956) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ocil6-0000F1-E4 for 58071@debbugs.gnu.org; Mon, 26 Sep 2022 03:42:32 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:45526) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ocikz-0008Sa-UG; Mon, 26 Sep 2022 03:42:25 -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=owk2yhYPbnifrN3pbKWlfVjwauvuHI98VXebDoEmuWA=; b=AX0STOgnS14O DW6ENoG/b7umi3N3C2fkENJu8BXmI9xKySsFOPHQu1x+bz6RBkWO9l8GU8LPT4+bed52Ee7lCq8Fr ADStYCtrIVZIqFrgz8VEnWbOjfVjl0bFzrXyYO1zsbKSACW0uDJKZYvXPQJq2FJXA3odpOf6ykB3M uloSVFKRnyfNx4bUrw0jhgVxX5NYWvHXQERGqYXhkNHRgEyQkmGn03hGgYbvwj+klygFoNGE9pDVm Gnwamb/gMS+6IFp7disiwawNRrsaTGuD032OIKUArVvuRSear2G14gmiHxicT8bmDIpDwRW59Rmh7 8DNEu5XEYqKxbYJ7sHcT3Q==; Original-Received: from [87.69.77.57] (port=1675 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 1ocikz-0002s5-CT; Mon, 26 Sep 2022 03:42:25 -0400 In-Reply-To: <878rm7wvib.fsf@cassou.me> (message from Damien Cassou on Sun, 25 Sep 2022 13:20:28 +0200) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:243626 Archived-At: > From: Damien Cassou > Date: Sun, 25 Sep 2022 13:20:28 +0200 > > Please find attached jumprel, a tool to find/create related files. This > tool has been described (and compared with `find-file.el' and > `find-sibling-file') in emacs-devel's thread "Comparison of tools to > search for related files". Thanks. A few high-level comments I have are: . "jumprel" is not the best name, IMO; something like "related-files" would be better . what you call "recipes", i.e. descriptors of how to generate the name of related files from a given file name, should be documented in a single doc string, and the other places that use recipes should reference the symbol whose doc string documents them (currently, it looks like the documentation is scattered all over the code and comments, and mainly as examples; there's no single exhaustive list with descriptions) . I find no documentation of how to describe alternatives -- several alternative file names produced from a single original file name . I wonder whether "recipes" like these are a convenient method of customizing this facility: do people really find it easy to write "ordered" property lists for this purpose?