From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: John Yates Newsgroups: gmane.emacs.devel Subject: Re: Git mirrors Date: Mon, 17 Oct 2011 10:44:48 -0400 Message-ID: References: <87lissh32y.fsf@wanadoo.es> <87zkh8e286.fsf@catnip.gol.com> <87d3e4gttq.fsf@wanadoo.es> <87ehyjrhxh.fsf@uwakimon.sk.tsukuba.ac.jp> <87d3e2rfte.fsf@uwakimon.sk.tsukuba.ac.jp> <878voqfiaw.fsf@wanadoo.es> <87zkh4bhho.fsf@wanadoo.es> <87zkh4nrcr.fsf@uwakimon.sk.tsukuba.ac.jp> <87zkh0ozjz.fsf@uwakimon.sk.tsukuba.ac.jp> <87d3dvyev3.fsf@wanadoo.es> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1318862715 23767 80.91.229.12 (17 Oct 2011 14:45:15 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 17 Oct 2011 14:45:15 +0000 (UTC) Cc: rms@gnu.org, lekktu@gmail.com, emacs-devel@gnu.org, Andreas Schwab , Eli Zaretskii , stephen@xemacs.org To: =?ISO-8859-1?Q?=D3scar_Fuentes?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Oct 17 16:45:08 2011 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RFoRA-0005c8-LD for ged-emacs-devel@m.gmane.org; Mon, 17 Oct 2011 16:45:08 +0200 Original-Received: from localhost ([::1]:48776 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RFoRA-0003i9-9n for ged-emacs-devel@m.gmane.org; Mon, 17 Oct 2011 10:45:08 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:38796) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RFoR3-0003eo-2e for emacs-devel@gnu.org; Mon, 17 Oct 2011 10:45:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RFoQy-0003mT-PQ for emacs-devel@gnu.org; Mon, 17 Oct 2011 10:45:01 -0400 Original-Received: from mail-gx0-f169.google.com ([209.85.161.169]:48065) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RFoQs-0003kc-Ag; Mon, 17 Oct 2011 10:44:50 -0400 Original-Received: by ggdk5 with SMTP id k5so3624979ggd.0 for ; Mon, 17 Oct 2011 07:44:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=lvwMk45Gmvawo49EJTEWN8XniE3PkgtRO5Jujq0mPVs=; b=mBI4c/2gTy8WpORCULpHepWeLz28Ywwb+NRKy0j1Y3MaNjLOz05SXLiktY0MUZf1De Q/iJZTh+Shq+JIGLGi9i1pOgsDV9B48vuh/B6tl+CDwykkgaSFhpVAJdHSFwxfD0yXyx IwrQJjzI1xHk1SA97qYYdhjBvSk7GoXHgE1KE= Original-Received: by 10.43.132.67 with SMTP id ht3mr39169368icc.35.1318862688295; Mon, 17 Oct 2011 07:44:48 -0700 (PDT) Original-Received: by 10.42.171.2 with HTTP; Mon, 17 Oct 2011 07:44:48 -0700 (PDT) In-Reply-To: <87d3dvyev3.fsf@wanadoo.es> X-Google-Sender-Auth: uSrbZpzIe6jVI3q3L2NwDL564O8 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 209.85.161.169 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:145259 Archived-At: On Mon, Oct 17, 2011 at 8:36 AM, =D3scar Fuentes wrote: > > So you want those manpages to be both informative for inexperienced > users and a reference. That's unreasonable. That would be a reasonable stance if tutorials provided an introduction of every concept. Often they only cover a subset. In such cases the man pages are the _only_ documentation and thus a newcomer's primary intro to more exotic features. Recourse to googling, experimenting, posting to news groups, etc. all suggest that the reference documentation failed at some level. /john