From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: John Yates Newsgroups: gmane.emacs.devel Subject: Re: Question on set-window-margins Date: Thu, 4 Jan 2024 07:29:00 -0500 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> Mime-Version: 1.0 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="37301"; mail-complaints-to="usenet@ciao.gmane.io" Cc: nicolas.rougier@inria.fr, casouri@gmail.com, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Jan 04 13:30:23 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 1rLMre-0009Rg-5M for ged-emacs-devel@m.gmane-mx.org; Thu, 04 Jan 2024 13:30:22 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rLMqf-0006bV-Rn; Thu, 04 Jan 2024 07:29:21 -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 1rLMqb-0006au-EG for emacs-devel@gnu.org; Thu, 04 Jan 2024 07:29:17 -0500 Original-Received: from mail-ed1-f45.google.com ([209.85.208.45]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rLMqZ-0004tA-Ml; Thu, 04 Jan 2024 07:29:17 -0500 Original-Received: by mail-ed1-f45.google.com with SMTP id 4fb4d7f45d1cf-55692ad81e3so529873a12.1; Thu, 04 Jan 2024 04:29:14 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1704371353; x=1704976153; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=NKPNYT/vMWA9LAGy07wcMUJKntr0LL2VmAe83GbNKuA=; b=joRPJQDKWGtI3GULOUbwMx2cc1dJUJg4A0mL6bcVTY29tdDQcvzUZxSa9K6CWDMjMf L0sNkIZMqseTgTTuIoQWa4HrHY7LQtH+UI9D/8xouGxsMjDcXbuZv5QPgrb9HoU04TbI SVmOFpaFq1LBxeOnLbAeWE6e/A9LWAloFiQd+yyQPlG9H1bh/7pVxDmX+yDUuHFw4Quo fglFd5PXo3lmh16QUynl6lUMG0tKQTmVyvYfh/752913xLscO5yoYjwjLwOBStotyUis HTvlpFEY+rABKVkpKX9pG9nj3S97yNgC16Rcr4I+X3b/aADUa/H74X04UW6U/ezN1sL2 hj7w== X-Gm-Message-State: AOJu0YyRMz1kp3XcWQFrFQlMQ1wwbOWR31D07bYJoJT12jLcyIO+B9sO joTO9iiUyxhs+nS49OvesQRev7xmt9j9KsR2cYaWTZXbDA8= X-Google-Smtp-Source: AGHT+IHu9icTqS8G3xXvd5xpIWpLSPbMt5/Kpreczj3c347/y2zhuhjZUkYA+7DYo2+Ke8L+/LhS3BPKJk1Ll1y4rMs= X-Received: by 2002:a17:906:264c:b0:a28:bf47:27a3 with SMTP id i12-20020a170906264c00b00a28bf4727a3mr299253ejc.138.1704371352940; Thu, 04 Jan 2024 04:29:12 -0800 (PST) In-Reply-To: <83r0iyxsym.fsf@gnu.org> Received-SPF: pass client-ip=209.85.208.45; envelope-from=john.yates.sheets@gmail.com; helo=mail-ed1-f45.google.com X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no 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:314536 Archived-At: On Wed, Jan 3, 2024 at 11:49=E2=80=AFAM Eli Zaretskii wrote: > > 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. A visual link has the virtue that it makes immediately clear case holds. No link? Then the doc string is equivalent to what one will find in the manual (or the function is not documented in any manual). Link present? Then clearly there exists documentation somewhere that goes beyond what is included in the doc string. When I run describe function, along with the signature and the actual doc string, I get additional boilerplate: xxx-yyy-zzz is an autoloaded interactive byte-compiled Lisp function in =E2=80=98xxx.el=E2=80=99. Probably introduced at or before Emacs version ee.v. Help-mode binds 's' to help-view-source. That has prevented us from supplying a visible link to the source. Similarly, I suggest that, when there exists a relevant, more detailed bit of documentation, the first line could be extended to read: xxx-yyy-zzz is an autoloaded interactive byte-compiled Lisp function in =E2=80=98xxx.el=E2=80=99. [full doc]