From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/33123 Path: main.gmane.org!not-for-mail From: Dave Love Newsgroups: gmane.emacs.gnus.general Subject: Re: emacs21-branch (Re: ognus) Date: Thu, 2 Nov 2000 17:23:23 GMT Sender: owner-ding@hpc.uh.edu Message-ID: <200011021723.RAA12718@djlvig.dl.ac.uk> References: <2nwvetu80i.fsf@tiger.jia.vnet> <20001028192205.7987BDBA78@tux.gnu.franken.de> <20001029184843.3207BDBAC8@tux.gnu.franken.de> <200010302253.WAA08203@djlvig.dl.ac.uk> NNTP-Posting-Host: coloc-standby.netfonds.no Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1035169288 23477 80.91.224.250 (21 Oct 2002 03:01:28 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Mon, 21 Oct 2002 03:01:28 +0000 (UTC) Return-Path: Original-Received: from spinoza.math.uh.edu (spinoza.math.uh.edu [129.7.128.18]) by mailhost.sclp.com (Postfix) with ESMTP id 12A20D049A for ; Thu, 2 Nov 2000 12:24:02 -0500 (EST) Original-Received: from sina.hpc.uh.edu (lists@Sina.HPC.UH.EDU [129.7.3.5]) by spinoza.math.uh.edu (8.9.1/8.9.1) with ESMTP id LAB28854; Thu, 2 Nov 2000 11:23:47 -0600 (CST) Original-Received: by sina.hpc.uh.edu (TLB v0.09a (1.20 tibbs 1996/10/09 22:03:07)); Thu, 02 Nov 2000 11:23:08 -0600 (CST) Original-Received: from mailhost.sclp.com (postfix@66-209.196.61.interliant.com [209.196.61.66] (may be forged)) by sina.hpc.uh.edu (8.9.3/8.9.3) with ESMTP id LAA10314 for ; Thu, 2 Nov 2000 11:22:57 -0600 (CST) Original-Received: from djlvig.dl.ac.uk (djlvig.dl.ac.uk [148.79.112.146]) by mailhost.sclp.com (Postfix) with ESMTP id E50EAD049A for ; Thu, 2 Nov 2000 12:23:23 -0500 (EST) Original-Received: (from fx@localhost) by djlvig.dl.ac.uk (8.8.7/8.8.5) id RAA12718; Thu, 2 Nov 2000 17:23:23 GMT X-Authentication-Warning: djlvig.dl.ac.uk: fx set sender to d.love@dl.ac.uk using -f X-Face: "_!nmR@11ZNuumt0oqG"Y3Hfy|;FGz)`"ul[G?ah6k-oNyDW?3/Nq3Qab$kUnUQ_d4};kPl R=}-Vqfo|S5mThi-kaBR=>%g5a3-OvnEhdHu{^APIaP:b}0m!$bDC>SX zz'r)e?`at?tpD*+~b+pf Original-To: ding@gnus.org In-Reply-To: User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/21.0.90 Original-Lines: 27 Precedence: list X-Majordomo: 1.94.jlt7 Xref: main.gmane.org gmane.emacs.gnus.general:33123 X-Report-Spam: http://spam.gmane.org/gmane.emacs.gnus.general:33123 >>>>> "DD" == Denys Duchier writes: DD> when you buy a physical device, you expect the manual to contain DD> instructions about maintenance. Then you must get disappointed. DD> Same here, only more so. It's probably pointless to enumerate why putting details of the CVS repository in a user manual is a bad idea, but I'll go further and say they shouldn't be in any manual in the distribution. Consider alternatives. DD> Things can be complicated enough as they are. Yes, like I often can't figure out how I'm supposed to do something in Gnus without reading the code, and it's often hard even then. DD> Let's not make them harder by withholding crucial information. Let's not set up straw men. How about contributing to the documentation so that it is less complicated for people? Try to follow rms's exacting standards for user and programmer docs. -- People have told me the [Emacs] manual is very good. -- rms