From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id EPenD399H2WRbwAA9RJhRA:P1 (envelope-from ) for ; Fri, 06 Oct 2023 05:22:39 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id EPenD399H2WRbwAA9RJhRA (envelope-from ) for ; Fri, 06 Oct 2023 05:22:39 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id D133C44BC8 for ; Fri, 6 Oct 2023 05:22:38 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=none; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=gmail.com (policy=none) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1696562559; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=mcU3DChuUcWJ8jeTdK6KyDIhU43ip12bGtmmUwLZipI=; b=cTLmocpZtzyZWgHqOSAiJq1JWPQuLSMrey0VMlNK+iocZ0Nc+0pPmYCFBsCAkus0a+AHOF Xgw87ajzSoHbmwXMFGayxAwcNVf5/VcQK0rKUt4/Qrq8B5cxZxgEhgsqo/D73YvTuRtxYg 2e2kHd1EtUFTR7HJ1S54uZyFYBEu60frOKvaPxouUlfIXZCfxJWaPpp57rNJiykKKTZ0Rx lq4pXFlOi4Qb6sRBgkQ5vdf/b449LivR1h3oIL2oqOlt18s+GTFsRQysjR1jDxRlxJ8QdS kLgtpfrWWCLIzpMvMWrDrAWw2clhDkhz8ZtTr/E1P8cgiEEMxW3jwEPxsyZ0XQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1696562559; a=rsa-sha256; cv=none; b=SqrsgmIeeo7wibroI1ajulqOyRFJUEWvdOSs/S06KppmlnZhrNDUGvjkDCyDUMBF6cTrFU XpDJiKX0S920bxvudW48F8g0QxqbNI22e4rKqX/JosAx5jyezFXhO+jzxQKF7aBq7/hRUx FA0vCROPkX2AMtXrsSW0Nr8wwNVVWUXAVj60oSQ27Ps244fa//4/CXmsdZpVGr0kevHGb4 nE5QE9c9BxF/eisz/F/1sAA6Bg8GZNxOxyYGOynqtBHGkOyqoMbL7CRiBuGkdPa4aLuYRB CYNRrTuak3gPYycOfh1N572meo2q+tM3QPAynDMP7m+JLATKEdvz7vAfXIh7EA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=gmail.com (policy=none) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qobKf-0000sz-HH; Thu, 05 Oct 2023 23:16:53 -0400 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 1qobKe-0000sq-53 for emacs-orgmode@gnu.org; Thu, 05 Oct 2023 23:16:52 -0400 Received: from ciao.gmane.io ([116.202.254.214]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qobKc-0007GP-QZ for emacs-orgmode@gnu.org; Thu, 05 Oct 2023 23:16:51 -0400 Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1qobKa-00016y-UF for emacs-orgmode@gnu.org; Fri, 06 Oct 2023 05:16:48 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: emacs-orgmode@gnu.org From: Max Nikulin Subject: Re: Completion of links to man pages Date: Fri, 6 Oct 2023 10:16:41 +0700 Message-ID: References: <87sf6pi9fn.fsf@localhost> <838r8h3w3f.fsf@gnu.org> <87zg0xgimp.fsf@localhost> <83ttr52fmx.fsf@gnu.org> <87sf6pggd6.fsf@localhost> <83mswx2dvl.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit User-Agent: Mozilla Thunderbird Content-Language: en-US, ru-RU In-Reply-To: <83mswx2dvl.fsf@gnu.org> Cc: emacs-devel@gnu.org Received-SPF: pass client-ip=116.202.254.214; envelope-from=geo-emacs-orgmode@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: 28 X-Spam_score: 2.8 X-Spam_bar: ++ X-Spam_report: (2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, FORGED_GMAIL_RCVD=1, FORGED_MUA_MOZILLA=2.309, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, NML_ADSP_CUSTOM_MED=0.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Scanner: mx0.migadu.com X-Migadu-Spam-Score: -4.88 X-Spam-Score: -4.88 X-Migadu-Queue-Id: D133C44BC8 X-TUID: DHjde8MNB7NJ On 06/10/2023 00:11, Eli Zaretskii wrote: > From where I stand, we have already a stable API tested by years of > use. What is maybe missing is some documentation to allow its easier > use, that's all. In some cases it is no API but just an interactive command. Sometimes it can be used from other code, sometimes it requires to copy-paste enough implementation details to achieve a similar effect. While man.el requires "just" resetting cache and disabling case sensitivity, woman.el needs to initialize cache before invoking a completion function. When woman.el is considered in isolation, it is not an issue that `woman-file-name' is not decomposed into smaller functions since there is no need to reuse parts of its code. However it becomes an obstacle when another package tries to interact with woman. Side note: I am afraid of behavior divergence for `man' and `org-insert-link' in future, but I have not figured out what API I would expect.