From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/59664 Path: main.gmane.org!not-for-mail From: Lars Magne Ingebrigtsen Newsgroups: gmane.emacs.gnus.general Subject: Re: Gnus docs questions/notes Date: Fri, 28 Jan 2005 00:55:41 +0100 Organization: Programmerer Ingebrigtsen Message-ID: References: <41E9AD33.5010306@boost-consulting.com> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: sea.gmane.org 1106870366 15697 80.91.229.6 (27 Jan 2005 23:59:26 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 27 Jan 2005 23:59:26 +0000 (UTC) Original-X-From: ding-owner+M8204@lists.math.uh.edu Fri Jan 28 00:59:20 2005 Return-path: Original-Received: from malifon.math.uh.edu ([129.7.128.13]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CuJXk-0005hU-00 for ; Fri, 28 Jan 2005 00:59:20 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.math.uh.edu ident=lists) by malifon.math.uh.edu with smtp (Exim 3.20 #1) id 1CuJXd-00009b-00; Thu, 27 Jan 2005 17:59:13 -0600 Original-Received: from util2.math.uh.edu ([129.7.128.23]) by malifon.math.uh.edu with esmtp (Exim 3.20 #1) id 1CuJXY-00009W-00 for ding@lists.math.uh.edu; Thu, 27 Jan 2005 17:59:08 -0600 Original-Received: from quimby.gnus.org ([80.91.224.244]) by util2.math.uh.edu with esmtp (Exim 4.30) id 1CuJXS-0007lL-2P for ding@lists.math.uh.edu; Thu, 27 Jan 2005 17:59:02 -0600 Original-Received: from main.gmane.org ([80.91.224.249]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1CuJXR-00015i-00 for ; Fri, 28 Jan 2005 00:59:01 +0100 Original-Received: from list by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 1CuJXR-0004Nm-00 for ; Fri, 28 Jan 2005 00:59:01 +0100 Original-Received: from quimbies.gnus.org ([80.91.231.2]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 28 Jan 2005 00:59:01 +0100 Original-Received: from larsi by quimbies.gnus.org with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 28 Jan 2005 00:59:01 +0100 X-Injected-Via-Gmane: http://gmane.org/ Mail-Followup-To: ding@gnus.org Original-To: ding@gnus.org Original-Lines: 179 Original-X-Complaints-To: usenet@sea.gmane.org X-Gmane-NNTP-Posting-Host: quimbies.gnus.org Mail-Copies-To: never X-Now-Playing: It's Immaterial's _Song_: "Heaven Knows" User-Agent: Gnus/5.110003 (No Gnus v0.3) Emacs/21.3.50 (gnu/linux) Cancel-Lock: sha1:E0cxHfmcy70wR3H5P6KJZvQjY98= Precedence: bulk Original-Sender: ding-owner@lists.math.uh.edu Xref: main.gmane.org gmane.emacs.gnus.general:59664 X-Report-Spam: http://spam.gmane.org/gmane.emacs.gnus.general:59664 David Abrahams writes: > I realize that _some_ of what I'm asking for may be outside the charter > of this document as described in 15.4, "On Writing Manuals," but it's > the only comprehensive document we have AFAIK, so it may make sense to > improve it rather than wait for someone to write something that's more > like a "user's guide." Well, there have been quite a few "user guide" style documents that cover various parts of Gnus on the web. my.gnus.org collects quite a few of these. It's apparently easier to write HTML than TeXinfo. :-) > Section 1.1 Finding the news > > - Page numbering is restarted somewhere in gnus-manual-standard.pdf, so > that the reference on page 2 to the Terminology section points to page > 113, but there's no indication of the restart. That's confusing. Generating the pdf is a pain, but I'll give it a go... Hm... there doesn't seem to be any text on my page two. > - p.2 mentions "the local spool." What's a spool? It's not covered in > the terminology section Added.. > - p.2 mentions "Leafnode." It would be nice to have at least a short > footnote that says what that is. I've added a parenthesis. I'm not really sure it's necessary; if you don't know what it is, you're not running it, and you definitely don't need that advice. (Which really belongs in a FAQ instead.) > - p.3 mentions "active files." I realize this is defined in the > terminology section, but it would be nice if newly-introduced terms > could be cross-referenced to their definitions. Yes... but I think this sort of thing really would be better handled if an editor(ish) type of person would read over the manual and just rearrange things and add links. It's less work doing that than describing what the problem is. (TeXinfo is really quite easy to work with. Hint, hint. :-) Patches welcome.) > It isn't clear whether the active file is typically stored on the > machine where Gnus is running or on the server; the answer could > greatly affect how I decide to make many Gnus settings, since active > files can grow so large. It all depends on how your setup is like. If the (nntp) server is local, then the active file is. If not, then not... > Section 1.2 The First Time > > - By "startup files" do you mean .gnus et. al? Yes. There's a section called "Startup Files" that talks about all this. I've added a reference to that. > - "If gnus-default-subscribed-newsgroups is t, Gnus will just use the > normal functions for handling new groups, and not do anything special." > This is too vague. It's unclear what these normal functions might be, > nor what special things might have happened otherwise. It's a very vague section, meant to give a brief, readable overview of what's supposed to be happening. I was trying to write a user manual at the time. > 1.5 Fetching a Group > > - why might this be more useful for someone who writes code than for users? Because you have to know what the group name is. That section shouldn't be in chapter one at all. I'll move it. > - does it start Gnus? If not, and you can read a group without starting > Gnus, what does it mean to start Gnus? That's also not something that's really well defined. The function in question can't really be said to meaningfully start Gnus. > 1.6.1 Checking New Groups > > The news servers I use have so many groups on them, and I have so much > incoming traffic, that it's hard to imagine anyone wanting to have Gnus > automatically subscribe them to new groups. Is this really a common > usage pattern? No, I think not. But back in 1987, it probably was. > From reading the docs, it seems like there's a lot of > expensive computation and storage devoted to being able to do that in > Gnus, and it's all turned on by default. Gnus makes new groups into zombies by default, which is quite cheap. And it doesn't read the entire active file by default, so I think it might be doing the right thing. > 1.8 Startup Files > > - Begins, "Now, you all know about the `.newsrc' file." Well, not > really. I don't know much about it at all yet. The statement makes me > wonder what I *should* know about it at this point, and where I ought to > go to find that information. Heh. That shows my geeky bias. When I started doing Gnus, I don't think anybody who read news wouldn't have known what the .newsrc file was. But times change... I've changed this to --- Most common Unix news readers use a shared startup file called @file{.newsrc}. This file contains all the information about what groups are subscribed, and which articles in these groups have been read. --- > - "You can turn off writing the ‘.newsrc’ file by setting > gnus-save-newsrc-file to nil, which means you can delete the file and > save some space, as well as exiting from Gnus faster. However, this will > make it impossible to use other newsreaders than Gnus." > > This baffles me. How could telling Gnus not to touch .newsrc prevent me > from using other newsreaders? Well, they wouldn't know what articles you've read, or what groups you're subscribed to. That's not impossible, but it's certainly painful... > - "Similarly, setting gnus-read-newsrc-file to nil makes Gnus ignore the > ‘.newsrc’ file and any ‘.newsrc-SERVER’ files, which is convenient if > you have a tendency to use Netscape once in a while." > > Why is that convenient for people who use Netscape once in a while? Because Netscape writes those files, and have a tendency to write totally bogus info there. But it's probably outdated info by now. I've changed it. > - "You should always set gnus-check-new-newsgroups to nil or ask-server > if you set this variable to nil (see “New Groups” on page 5). This > variable can also be a regular expression. If that’s the case, remove > all groups that do not match this regexp before saving." > > Is this an instruction to me, the user, or is it really telling me what > Gnus will do if gnus-check-new-newsgroups is a regexp? Before saving > what? Remove the groups from where? It's talking about `gnus-save-killed-list', so the "remove" is from the variable that's controlling. I.e., the list of killed groups. > - The gnus-startup-file variable says where the startup files are. The > default value is ‘˜/.newsrc’, with the Gnus (El Dingo) startup file > being whatever that one is, with a “.eld” appended. > > What is El Dingo? A joke. :-) > 1.10 The Active File > > I'm trying to figure out how to set gnus-read-active-file for my primary > select method, which will be an IMAP server. I assume that's neither > Leafnode nor INN, so none of the information here applies to me. I don't think you have to do anything in particular for that, really. (setq gnus-select-method '(nnimap "your.imap.server")) The defaults should be OK. -- (domestic pets only, the antidote for overdose, milk.) larsi@gnus.org * Lars Magne Ingebrigtsen