From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Ihor Radchenko Newsgroups: gmane.emacs.bugs Subject: bug#61325: 30.0.50; Jokes in GNUS manual Date: Tue, 07 Feb 2023 14:43:06 +0000 Message-ID: <87wn4tedtx.fsf@localhost> References: <87ttzy7pg1.fsf@localhost> <87wn4u6xj0.fsf@yahoo.com> <871qn1afay.fsf@localhost> <87r0v17iul.fsf@yahoo.com> <87zg9peijp.fsf@localhost> <87mt5p7etx.fsf@yahoo.com> 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="7851"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 61325@debbugs.gnu.org To: Po Lu Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Feb 07 15:43:22 2023 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 1pPPBp-0001kg-Ak for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 07 Feb 2023 15:43:21 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pPPBY-0000y3-6Z; Tue, 07 Feb 2023 09:43:04 -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 1pPPBW-0000xf-3U for bug-gnu-emacs@gnu.org; Tue, 07 Feb 2023 09:43:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pPPBV-000236-RE for bug-gnu-emacs@gnu.org; Tue, 07 Feb 2023 09:43:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pPPBV-0003fD-NZ for bug-gnu-emacs@gnu.org; Tue, 07 Feb 2023 09:43:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Ihor Radchenko Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 07 Feb 2023 14:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 61325 X-GNU-PR-Package: emacs Original-Received: via spool by 61325-submit@debbugs.gnu.org id=B61325.167578097014061 (code B ref 61325); Tue, 07 Feb 2023 14:43:01 +0000 Original-Received: (at 61325) by debbugs.gnu.org; 7 Feb 2023 14:42:50 +0000 Original-Received: from localhost ([127.0.0.1]:51630 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pPPBJ-0003eh-Hi for submit@debbugs.gnu.org; Tue, 07 Feb 2023 09:42:50 -0500 Original-Received: from mout01.posteo.de ([185.67.36.65]:60295) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pPPBG-0003eP-Oc for 61325@debbugs.gnu.org; Tue, 07 Feb 2023 09:42:48 -0500 Original-Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 8B5962404DD for <61325@debbugs.gnu.org>; Tue, 7 Feb 2023 15:42:40 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1675780960; bh=5luOzGDxbP88+tiDeVCUb3J7jJLG3cmrtE8iJm/22Ag=; h=From:To:Cc:Subject:Date:From; b=JZOgPxGrV9MFJpDmGsgxT480oZXA4J5MexknfLN2f1OqYl+0GoWg1SPhKRn3C622P D/sOOBv39E/+2OGhNBts30LJzgCQ7fqzbnIVvusva6GFjH34rZn6xocbauootACT05 kGUg3pD7rrTgKVrGZMnNH/TSiSuClKOh08QDMjU87eZXaPeySDQj65iI5CEjTUgy0k IlMbDem9ebX7NTv31YX7OqUv2+hG/+n9aw09EaVLxBAZ79B9DuNTItPBtCBpFRdVpl cPk/towgszL+bQCzG/Ac7cz0ZrHSOV0k+RqXi0bwo1VALcHF1wYI6ONGX4tVmtNMLX dRq4atQl0FINQ== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4PB5Sv3dtgz9rxB; Tue, 7 Feb 2023 15:42:39 +0100 (CET) In-Reply-To: <87mt5p7etx.fsf@yahoo.com> 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:255051 Archived-At: Po Lu via "Bug reports for GNU Emacs, the Swiss army knife of text editors" writes: >>> 3.16 Group Topics >>> >>> If you read lots and lots of groups, it might be convenient to group >>> them hierarchically according to topics. You put your Emacs groups= over >>> here, your sex groups over there, and the rest (what, two groups or= so?) >>> you put in some misc section that you never bother with anyway. Yo= u can >>> even group the Emacs sex groups as a sub-topic to either the Emacs >>> groups or the sex groups=E2=80=94or both! Go wild! >> >> Thanks. >> I also partially understand the joke. >> My main problem is the last sentence, which I am not sure if it is >> technical or still part of the joke. >> >> You can even group the Emacs sex groups as a sub-topic to either the >> Emacs groups or the sex groups=E2=80=94or both! >> >> The paragraph structure is basically: >> >> >> >> Such structure is difficult to understand, especially if the joke itself >> is not understood. > ... >> Not when the jokes stay on the way of understanding the technical parts. > > They do not. End of discussion. I kindly disagree. 3.16 Group Topics section was difficult to understand _for me_ precisely because of the jokes. I will elaborate below. > Where I come from, it is generally said that a person who deliberately > tries to find problems with something is trying to ``pick pricks''. > They are usually able to find some problems, because the problems they > report tend to, by definition, rely on their own testimony: ``I don't > understand'', ``I'm offended by'', etc. > > Such people generally ruin the day for everyone else wherever they > appear. Upon hearing about the problem and checking the specifically indicated sections in the manual, I tend to agree with the person being offended. Not because I am not offended (I am not), but because, as I stated earlier, I believe that jokes should not complicate the understanding. > Whoever reported the problem with the Gnus manual, which has not seen > other such reports in over 20 years, certainly sounds like one such > individual. And if you don't understand the manual, then it is not a > problem with the jokes therein. Just read it again until you do. > How many people can understand the following sentence without reading it > at least once or twice? Absence of bug reports does not imply that the manual is easy to understand. I do not say that it is incomprehensible, but the examples I pointed to do make it harder to understand. Won't it be an improvement to make the manual easier to understand for more people? > XcmsCIELabClipL > > This brings the encountered out-of-gamut color specification into the > screen's color gamut by reducing or increasing CIE metric lightness > (L*) in the CIE Lab color space until the color is within the > gamut. If the Psychometric Chroma of the color specification is beyond > maximum for the Psychometric Hue Angle, then while maintaining the > same Psychometric Hue Angle, the color will be clipped to the CIE Lab > coordinates of maximum Psychometric Chroma. See > `XcmsCIELabQueryMaxC'. No client data is necessary. > > Is color management, thus, an evil which should be persecuted by hordes > of crusaders? I do not see any problem with the provided paragraph. Yes, it contains a lot of unfamiliar terms, but they appear to be necessary to describe the technical information. In contrast, jokes do not convey any new information. They are good to have as an _occasional_ distraction - a break that may be necessary to simplify understanding; but not good when they make understanding more difficult. Imagine a joke inserted into your example, on top of all other unfamiliar terms: > This brings the encountered out-of-gamut (not gonad, mind you) color > specification into the screen's color gamut by reducing or > increasing (let's not think further) CIE metric lightness (L*) in the > CIE Lab color space until the color is within (mmm...) the gamut. Would you find it helpful or at least neutral to have these extra jokes when trying to understand the above sentence? --=20 Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at