From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([69.77.167.62] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1LVJYm-0002wF-Lr for garchives@archives.gentoo.org; Fri, 06 Feb 2009 05:47:28 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id A4A13E0468; Fri, 6 Feb 2009 05:47:27 +0000 (UTC) Received: from mail-ew0-f11.google.com (mail-ew0-f11.google.com [209.85.219.11]) by pigeon.gentoo.org (Postfix) with ESMTP id 502A7E0468 for ; Fri, 6 Feb 2009 05:47:27 +0000 (UTC) Received: by ewy4 with SMTP id 4so210500ewy.10 for ; Thu, 05 Feb 2009 21:47:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:from:to:subject:date :user-agent:references:in-reply-to:mime-version:content-type :content-transfer-encoding:content-disposition:message-id; bh=jJYEvJFvcy6prujMbx7KzCzmcoyKV9Rttb1hdlZMyVI=; b=g+sI/uIdyC6AgQNhG7WALoqlRaI5ZkHPansMgPsJS/tNVIyoShDGKEi332wwDJbELf SrCzOrSxiYojOFKG3Ec6oKPTC1Ozud012uUhzbwyPqw+IAdrgsYSLqbp/bWtbnBbHKAy 1sT0aBOvqp1Yl94jp5j5RSIijH3P9CJVRdU+U= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:subject:date:user-agent:references:in-reply-to:mime-version :content-type:content-transfer-encoding:content-disposition :message-id; b=hUHoY8y5MZqNSlWi0F1ARjoGmrfbHIUbtQsIs1/ilH+s2fl3casYb5B5qqTmWamBQn ZXgiVLUXOedYNf3Ic0Jr0T03478kAJFN+dcrKngm30Q2ysw5UGZZ4Vsr5e4jiaBRNYNx C/Hz390U2QUUqkq+jyzTF00w1fVNScMMbPNUY= Received: by 10.66.236.16 with SMTP id j16mr121485ugh.26.1233899246685; Thu, 05 Feb 2009 21:47:26 -0800 (PST) Received: from ?172.20.0.5? (196-210-140-105-wblv-esr-3.dynamic.isadsl.co.za [196.210.140.105]) by mx.google.com with ESMTPS id 40sm422562uge.25.2009.02.05.21.47.25 (version=TLSv1/SSLv3 cipher=RC4-MD5); Thu, 05 Feb 2009 21:47:25 -0800 (PST) From: Alan McKinnon To: gentoo-user@lists.gentoo.org Subject: Re: [gentoo-user] Re: Gentoo's advantage: 'optimized for your system' -- huh? Date: Fri, 6 Feb 2009 07:46:02 +0200 User-Agent: KMail/1.9.10 References: <8bc092095a8eb20bac335408b3423d3e.squirrel@jesgue.homelinux.org> <93F9BE3C-D6FF-4D65-8769-16450204099D@stellar.eclipse.co.uk> In-Reply-To: <93F9BE3C-D6FF-4D65-8769-16450204099D@stellar.eclipse.co.uk> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-user@lists.gentoo.org Reply-to: gentoo-user@lists.gentoo.org MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline Message-Id: <200902060746.02494.alan.mckinnon@gmail.com> X-Archives-Salt: 0d8a88fe-95f9-4809-b4a1-150cb5d18344 X-Archives-Hash: 2b53f9894468be7202cdd652992082dc On Friday 06 February 2009 06:40:01 Stroller wrote: > > If the problem is "contents" then that's nothing to do with > > man, but with whomever made (or didn't made) the page. > > Yes, but there's a problem with the MAJORITY of contents, perhaps of =A0 > the majority of people writing manpages? It just seems to be a culture =A0 > of the way man pages are written. They make perfect sense only with =A0 > experience - don't get me wrong, I love 'em and at least to a degree I =A0 > think that's how it should be. Man pages are mostly written as reference documents. Like technical specs,= =20 they tend to list the capabilities of the app without giving the "bigger=20 picture overview" as that is assumed to be known. They are not teaching aids or howtos. For that you need classes, dummy guid= es=20 etc. When you've learned how man pages work, then you can use the man pages= =2E=20 But the man pages don't tell you how the man pages work. =2D-=20 alan dot mckinnon at gmail dot com