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.devel Subject: Re: Question on set-window-margins Date: Wed, 03 Jan 2024 15:15:26 +0200 Message-ID: <834jfuzhg1.fsf@gnu.org> References: <83il4bzgmk.fsf@gnu.org> <83h6jvyu9p.fsf@gnu.org> <5FC2FDA6-CB7F-4285-958E-EC8595FC66AE@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="24942"; mail-complaints-to="usenet@ciao.gmane.io" Cc: casouri@gmail.com, emacs-devel@gnu.org To: "Nicolas P. Rougier (inria)" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Jan 03 14:16:43 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 1rL16w-0006HO-FY for ged-emacs-devel@m.gmane-mx.org; Wed, 03 Jan 2024 14:16:42 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rL168-0005J2-6W; Wed, 03 Jan 2024 08:15:52 -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 1rL163-0005Gd-5a for emacs-devel@gnu.org; Wed, 03 Jan 2024 08:15:47 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rL161-00006w-HA; Wed, 03 Jan 2024 08:15:45 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=i22npvWsA7ClPuxY3d4eFDxkmUVHWNQ+18n5fc4XGCA=; b=fdjSz3ToaR1a8gupmq5X J29BhiQKXOyFjjRGrui+IBhrEwp54grerWYj7MOEOitFdw4KRO6tj0lLcZqbabcEIbxIXLXiqih1r gHOAEbzbg7FjCiunEjZyDACDxyepQFp0WW8gHhWRLGBPuGgtpIOVJqnTR4wrejL54LqKRclWq6UxD ZiK1SiObU0XRtD6jndKudn9dFfMLY5ojlRn5VgLqtGLHqZY8qNz/uJOyXlf3pVqajkHroZDvMdEIV JBH7SZk84YRXdMsbMEECrc8Oug1Gei+G0FM/KQN9m27blHXeX/eOWEf/ibLoWoXCocglm7FAEdesN csRKAM+kaQj6dA==; In-Reply-To: (nicolas.rougier@inria.fr) 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:314491 Archived-At: > From: "Nicolas P. Rougier (inria)" > Cc: Eli Zaretskii , emacs-devel@gnu.org > Date: Wed, 03 Jan 2024 06:50:17 +0100 > > > Yuan Fu [2024-01-02 at 19:42] wrote: > > > > I think Nicolas means that the last paragraph isn’t present in > > the > > docstring of set-window-margin. That paragraph is only in the > > manual. It might be a good idea to mention this caveat in the > > docstring. > > Exactly. I added that, but I'm always surprised by people jumping to conclusions without studying both the relevant doc string(s) and the relevant descriptions in the manual. Doc strings and the manuals have different purposes and different size limitations, so it's unreasonable to expect only one of them to include all of the important information, let alone that of secondary importance, caveats, etc. Please always look up the functions you are interested in both in the built-in help and in the manual, before you conclude that something is strange or undocumented.