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 19:56:12 +0000 Message-ID: <87mt5pdzc3.fsf@localhost> References: <87ttzy7pg1.fsf@localhost> <87wn4u6xj0.fsf@yahoo.com> <871qn1afay.fsf@localhost> <87r0v17iul.fsf@yahoo.com> <87zg9peijp.fsf@localhost> <87357hz2d8.fsf@codeisgreat.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6222"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 61325@debbugs.gnu.org To: Pankaj Jangid Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Feb 07 20:56:12 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 1pPU4Z-0001Lm-Gn for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 07 Feb 2023 20:56:11 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pPU4U-000116-G0; Tue, 07 Feb 2023 14:56:06 -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 1pPU4Q-00010Z-Tz for bug-gnu-emacs@gnu.org; Tue, 07 Feb 2023 14:56:03 -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 1pPU4Q-0004Sz-Li for bug-gnu-emacs@gnu.org; Tue, 07 Feb 2023 14:56:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pPU4Q-0006ku-Du for bug-gnu-emacs@gnu.org; Tue, 07 Feb 2023 14:56:02 -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 19:56:02 +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.167579974525936 (code B ref 61325); Tue, 07 Feb 2023 19:56:02 +0000 Original-Received: (at 61325) by debbugs.gnu.org; 7 Feb 2023 19:55:45 +0000 Original-Received: from localhost ([127.0.0.1]:54120 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pPU48-0006kG-KE for submit@debbugs.gnu.org; Tue, 07 Feb 2023 14:55:44 -0500 Original-Received: from mout02.posteo.de ([185.67.36.66]:33805) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pPU46-0006jw-6q for 61325@debbugs.gnu.org; Tue, 07 Feb 2023 14:55:42 -0500 Original-Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 2A667240132 for <61325@debbugs.gnu.org>; Tue, 7 Feb 2023 20:55:33 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1675799736; bh=+fexs07HqxRJoqpTya/P1CNdjE+xVRJi9xPHC28eUdk=; h=From:To:Cc:Subject:Date:From; b=Rg3MxoR95gRLnDUy+TNz8FPs5r0Nw1IDeTLlF8L0SiaDGxFcb0xUcZSlS2Bviq3zq FowTSrmIH2uMZbGjcQ2VVGdTmIkZ5xsk8yE2vjclg54V0vZklHfCXnUCv3axy8iP/O yu6h2j40/GQFHS3iZlIqpETYL//JdhxWXq8/Et0p0yKPmoAIomOGMvuh5AB2Asej4U FqFaBh58qOO8MMzGL51H31wfcORJa/KJ4fQVoyoE8UBK4bcINJzbTvVKY0pQt1lb4u /Vq5yJ8gQdc07lzcUABJV4nMXqvhK6SYvvnYfs67976I+Ry8tyVGwUEREg1B9+bo3N TQNwLJlZ/2JiA== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4PBDPw35STz6tmv; Tue, 7 Feb 2023 20:55:32 +0100 (CET) In-Reply-To: <87357hz2d8.fsf@codeisgreat.org> 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:255077 Archived-At: Pankaj Jangid writes: >> The paragraph structure is basically: >> >> >> >> Such structure is difficult to understand, especially if the joke itself >> is not understood. > > But you have understood the above structure. Then what is the issue? The issue is that it took an extra effort to understand it. Not because of technical details, but simply because of presence of jokes. IMHO, the primary aim of manuals is explaining technical information to the users. Jokes that help to understand or at least does not hurt are totally fine. But when jokes makes the information harder to understand, isn't it against the aim of writing a good manual? -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at