From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/88748 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: =?utf-8?Q?Adam_Sj=C3=B8gren?= Newsgroups: gmane.emacs.gnus.general Subject: Re: Proposed new introductory section to the Gnus manual Date: Sat, 07 Sep 2019 21:50:54 +0200 Organization: koldfront - analysis & revolution, Copenhagen, Denmark Message-ID: <87muffga1t.fsf@tullinup.koldfront.dk> References: <87o90mm4x2.fsf@ericabrahamsen.net> <87blwmuh6j.fsf@dick.i-did-not-set--mail-host-address--so-tickle-me> <87mug6klq3.fsf@ericabrahamsen.net> <87mug5bpuh.fsf@ucl.ac.uk> <87y2zojwbz.fsf@ericabrahamsen.net> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="144507"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) To: ding@gnus.org Original-X-From: ding-owner+M36952@lists.math.uh.edu Sat Sep 07 21:51:17 2019 Return-path: Envelope-to: ding-account@gmane.org Original-Received: from lists1.math.uh.edu ([129.7.128.208]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1i6gjt-000bV0-06 for ding-account@gmane.org; Sat, 07 Sep 2019 21:51:17 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.math.uh.edu) by lists1.math.uh.edu with smtp (Exim 4.92) (envelope-from ) id 1i6gjn-00067I-6R; Sat, 07 Sep 2019 14:51:11 -0500 Original-Received: from mx1.math.uh.edu ([129.7.128.32]) by lists1.math.uh.edu with esmtps (TLSv1.3:TLS_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1i6gjj-00064Y-Rl for ding@lists.math.uh.edu; Sat, 07 Sep 2019 14:51:07 -0500 Original-Received: from quimby.gnus.org ([80.91.231.51]) by mx1.math.uh.edu with esmtps (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.92) (envelope-from ) id 1i6gji-00044U-D0 for ding@lists.math.uh.edu; Sat, 07 Sep 2019 14:51:07 -0500 Original-Received: from 195-159-176-226.customer.powertech.no ([195.159.176.226] helo=blaine.gmane.org) by quimby.gnus.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1i6gje-0004Gn-VH for ding@gnus.org; Sat, 07 Sep 2019 21:51:05 +0200 Original-Received: from list by blaine.gmane.org with local (Exim 4.89) (envelope-from ) id 1i6gje-000bG3-Mz for ding@gnus.org; Sat, 07 Sep 2019 21:51:02 +0200 X-Injected-Via-Gmane: http://gmane.org/ OpenPGP: id=476630590A231909B0A0961A49D0746121BDE416; url=https://asjo.koldfront.dk/gpg.asc Mail-Follow-Up-To: never X-Face: )qY&CseJ?.:=8F#^~GcSA?F=9eu'{KAFfL1C3/A&:nE?PW\i65"ba0NS)97,Q(^@xk}n4Ou rPuR#V8I(J_@~H($[ym:`K_+]*kjvW>xH5jbgLBVFGXY:(#4P>zVBklLbdL&XxL\M)%T}3S/IS9lMJ ^St'=VZBR Precedence: bulk Xref: news.gmane.org gmane.emacs.gnus.general:88748 Archived-At: Eric writes: > Yup, that was me attempting to be amusing. Yeah - it's a hard edge to walk. > This is probably me trying to match Lars' voice in the rest of the > manual. That might be a bad idea. (but nitpicks are welcome!) Sometimes he also overdid it, I think. (Oooh, heresy.) >>> When sending messages, too, Gnus makes a distinction between news-like >>> and mail-like behavior. News servers handle mail delivery themselves, >> >> Perhaps "message delivery"? > > Or just "delivery"? Sold. > Well I'll tell you where I'm aiming! I called it "Don't Panic" because I > know for a fact that many potential users have considered Gnus, started > it up, gone "WTF is this how do I even get the thing to open where are > my goddamn oh to hell with it" and then shut it down for good It is indeed daunting to get started. That's what the tutorials try to handle. But it's hard to write a good one. I agree it would be good to have a more friendly/hand-holdey introduction right there, in the manual. > The Gnus manual is very long, and very unintuitive... uh, discursive. > All of us on this list are way past this point, but I can still remember > that it took me several days of poking around to understand the > difference between a mail backend and a mail source. My biggest problem has always been the general Emacs/elisp nomenclature. When do I need to put ', when do I need to not, when do I need to go ,() etc. And then the documentation uses `' around somethings, and other marks around others. It's all so simple if you're a lisp weenie. Eventually you become one, or just try all the combinations until you hit one that work (still my way of solving it). But I digress as much as I agree here. > New users regularly burst into invective about why their groups have > disappeared. This is an attempt to instill a measure of confidence in > people who have dived into Gnus, and hit a submerged rock. A worthy cause! Perhaps only slightly quixotic. Best regards, Adam -- "I forgot you grew up in an Enid Blyton novel." Adam Sjøgren asjo@koldfront.dk