From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.bugs Subject: bug#61325: 30.0.50; Jokes in GNUS manual Date: Tue, 21 Feb 2023 23:33:01 -0500 Message-ID: References: <87ttzy7pg1.fsf@localhost> <87wn4u6xj0.fsf@yahoo.com> <87sffg69yj.fsf@yahoo.com> <87zg9f3rz4.fsf@localhost> <87ilfyjleb.fsf@yahoo.com> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="9901"; mail-complaints-to="usenet@ciao.gmane.io" Cc: yantar92@posteo.net, 61325@debbugs.gnu.org, bugs@gnu.support To: Po Lu Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Feb 22 05:34:23 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 1pUgpi-0002LU-51 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 22 Feb 2023 05:34:22 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pUgpR-0002qO-KH; Tue, 21 Feb 2023 23:34:05 -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 1pUgpO-0002q8-L8 for bug-gnu-emacs@gnu.org; Tue, 21 Feb 2023 23:34: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 1pUgpO-00072T-DN for bug-gnu-emacs@gnu.org; Tue, 21 Feb 2023 23:34:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pUgpN-0000Eh-UJ for bug-gnu-emacs@gnu.org; Tue, 21 Feb 2023 23:34:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Richard Stallman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 22 Feb 2023 04:34: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.1677040393849 (code B ref 61325); Wed, 22 Feb 2023 04:34:01 +0000 Original-Received: (at 61325) by debbugs.gnu.org; 22 Feb 2023 04:33:13 +0000 Original-Received: from localhost ([127.0.0.1]:57696 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pUgoa-0000Dc-L2 for submit@debbugs.gnu.org; Tue, 21 Feb 2023 23:33:13 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:46902) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pUgoV-0000DM-Re for 61325@debbugs.gnu.org; Tue, 21 Feb 2023 23:33:11 -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 1pUgoP-00059O-Rs; Tue, 21 Feb 2023 23:33:01 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=xTKKqIqaUCxX1t+dGa9PCQLTQLj1+R+4vBhNKRf+ccY=; b=g4mmBkVRHZa0 mma789OD8/cpmQfu4Fs7rpctkdJYlqWpvw0+aCI5fq5caOWNtWsDJCK0ae+PDPQ1l6FVhM1t2i031 MTPr30T1Y3Pf7h4wkNanIQpZyKkZPd8zUL01SXzBfbS+OHlaedWx8taa9Z6pNx5gVS5HBXRn3t52r AQROANy6mwTt2WcprjvHELMmRM59Jw07aJqBf7xomv4PQV8yjGaU4OUcNNGbG9OUnCDrPCf+3tftm 6J95lTrQEqbiF19hIIkOl0bJn8eogzDEVPsvnB2jJYujSgsobdZ3nBrhsvS0YHs3Euem9t0YBOgJh pnFWc9EB1h6gPxRQo8hpaA==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1pUgoP-0006DY-Ir; Tue, 21 Feb 2023 23:33:01 -0500 In-Reply-To: <87ilfyjleb.fsf@yahoo.com> (message from Po Lu on Sun, 19 Feb 2023 13:04:44 +0800) 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:256317 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > That seems like a useful feature. But the GNUS manual has to explain it. > And, it does... > 8.13 Kill Files > =============== > Gnus still supports those pesky old kill files. In fact, the kill file > entries can now be expiring, which is something I wrote before Daniel > Quinlan thought of doing score files, so I’ve left the code in there. That section gives full documentation of the kill file feature, but the text with the joke doesn't say anything about it. So that section still has the problem I complained about, of using a term that has not been explained. That section ought to have a sentence saying what kill files do, with an xref to the Kill Files node. Can someone please write that small fix? > 8.4 Score File Format > ===================== > A score file is an ‘emacs-lisp’ file that normally contains just a > single form. Casual users are not expected to edit these files; > everything can be changed from the summary buffer. The most important documentation for score files is how to use the score feature. Does the GNUS manual have that? If it already has good documentation of using that feature, there is no need to write it over again. But the section with the joke needs to have a sentence or two saying what scores and score files do, plus a cross reference to the explanation of how to use them. Can someone please write that small fix? -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)