From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Yuan Fu Newsgroups: gmane.emacs.devel Subject: Re: Question on set-window-margins Date: Thu, 4 Jan 2024 16:25:26 -0800 Message-ID: References: <83il4bzgmk.fsf@gnu.org> <83h6jvyu9p.fsf@gnu.org> <5FC2FDA6-CB7F-4285-958E-EC8595FC66AE@gmail.com> <834jfuzhg1.fsf@gnu.org> <83r0iyxsym.fsf@gnu.org> <83ttntw9a6.fsf@gnu.org> Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3731.700.6\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="16737"; mail-complaints-to="usenet@ciao.gmane.io" Cc: John Yates , "Nicolas P. Rougier (inria)" , emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Jan 05 01:26:34 2024 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 1rLY2k-00049P-Jl for ged-emacs-devel@m.gmane-mx.org; Fri, 05 Jan 2024 01:26:34 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rLY1y-0005CW-KB; Thu, 04 Jan 2024 19:25:46 -0500 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 1rLY1w-0005CN-L8 for emacs-devel@gnu.org; Thu, 04 Jan 2024 19:25:44 -0500 Original-Received: from mail-pf1-x433.google.com ([2607:f8b0:4864:20::433]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rLY1t-0004Wg-Me; Thu, 04 Jan 2024 19:25:44 -0500 Original-Received: by mail-pf1-x433.google.com with SMTP id d2e1a72fcca58-6dac8955af0so641162b3a.0; Thu, 04 Jan 2024 16:25:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1704414339; x=1705019139; darn=gnu.org; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=fPDxndJIFVygTN1HEzBPIu6VpMEDlu1Z0PLHFDPpDzw=; b=bJR0eGWQZQQ9KmR4PKH62lySGt76DdWQzOJloYonw9MSGtZIPGlcXvlSykEd5px7m2 81HmqebJPcokn5X8qa11NVsQ8WzcSeBvbeF0eDQ1/WvMsV2obBZYKn3xiKydTZhOCXkm ICUxNoGyumm1QIDdaYEPB4taj7jYvyI+UIIKoKqAcC/9bTgBzoV4vVXb14XSo62kuGLf BdFVgbhwOl9B8DnDx22zbW6yXzD2KCrheRsP58qaR0fdT80wVYvG2iuc4PpJjzc/4yMQ 6kC+VdDz01zkYuMUfmwFtDbFOvFQAVgkK8WPaaBOvmk7AGOyRWEA8ZhUyMikWS1qy7pH B9zQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1704414339; x=1705019139; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=fPDxndJIFVygTN1HEzBPIu6VpMEDlu1Z0PLHFDPpDzw=; b=HyYdVzhxGfVfF0g4GCCaJm+fdR4R6EqYeU09lD5f04J0VH7gjZa4dg/1Zn38VruP1l I8FpLXWX1IfIjzb7+Vy2Ywo+zovzzNYOju45RsqCMSm27c18tRn+XKrU/DUqrIeDa7qF egM/eNy3/+uJGtT3WxQY9nOXu6B4stMGiImGAyOto4DxKtI37TME7GXJDPwqI16soN7o I9xUvIHZCUdXPR1KxjqwWVuqLDa2NhI1kDOPxCPH7+Am4qKeyCNNqHBtzTRLz/0aIW2m lI5m+sCt1KK/vt71Nr+qSXFa2v+l5QEoyurzKFbxfyUSd8XF1oT4iMWYKQPvNBmSUcvE iSlQ== X-Gm-Message-State: AOJu0YwVhI+S1HI7Jki+l5A1xyca1M8Cq9dwSVjwVfnw02ET/0psHBq5 sbLshmOcu45LQbO/T1Z+3aA+yreum+g= X-Google-Smtp-Source: AGHT+IFa/68h0ggbUJ/SlGL0K82srFfz1Mk5dEdeTym/UDRvZE6kOyZ7TT5BnsWrN+NcgjPzAYWMaA== X-Received: by 2002:a05:6a00:290f:b0:6d9:c03e:f235 with SMTP id cg15-20020a056a00290f00b006d9c03ef235mr1510633pfb.59.1704414338321; Thu, 04 Jan 2024 16:25:38 -0800 (PST) Original-Received: from smtpclient.apple (172-117-161-177.res.spectrum.com. [172.117.161.177]) by smtp.gmail.com with ESMTPSA id ei28-20020a056a0080dc00b006da0f15b31csm238127pfb.97.2024.01.04.16.25.37 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 04 Jan 2024 16:25:37 -0800 (PST) In-Reply-To: <83ttntw9a6.fsf@gnu.org> X-Mailer: Apple Mail (2.3731.700.6) Received-SPF: pass client-ip=2607:f8b0:4864:20::433; envelope-from=casouri@gmail.com; helo=mail-pf1-x433.google.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, 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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:314544 Archived-At: > On Jan 4, 2024, at 4:52 AM, Eli Zaretskii wrote: >=20 >> From: John Yates >> Date: Thu, 4 Jan 2024 07:29:00 -0500 >> Cc: nicolas.rougier@inria.fr, casouri@gmail.com, emacs-devel@gnu.org >>=20 >> On Wed, Jan 3, 2024 at 11:49=E2=80=AFAM Eli Zaretskii = wrote: >>>=20 >>> We do that when there are too many details to have them in the doc >>> string. Otherwise, there's no need for a link because typing 'i' in >>> the *Help* buffer will show the corresponding documentation in the >>> manual. >>=20 >> A visual link has the virtue that it makes immediately clear case >> holds. >=20 > It is infeasible to maintain such a link in a doc string of every > symbol which is described in the manual(s), and unreasonable to expect > us to add a link to each doc string of such symbols. There are too > many of them, and keeping the links up-to-date given the changes in > the manuals is a lot of work. So we do that judiciously, where we > think it's needed; a judgment call. Helpful.el automatically inserts a button that links to the manual entry = if it can find the symbol in the manual. It=E2=80=99s probably not = perfect, but I frequently found it to be, well, helpful ;-) The test function is defined as (defun helpful--in-manual-p (sym) "Return non-nil if SYM is in an Info manual." (let ((completions (cl-letf (((symbol-function #'message) (lambda (_format-string &rest _args)))) (info-lookup->completions 'symbol 'emacs-lisp-mode)))) (-when-let (buf (get-buffer " temp-info-look")) (kill-buffer buf)) (or (assoc sym completions) (assoc-string sym completions)))) Yuan=