From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org) by nuthatch.gentoo.org with esmtp (Exim 4.54) id 1FYSwr-00063z-OC for garchives@archives.gentoo.org; Tue, 25 Apr 2006 19:11:46 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.13.6/8.13.6) with SMTP id k3PJAoUW022630; Tue, 25 Apr 2006 19:10:50 GMT Received: from pproxy.gmail.com (pproxy.gmail.com [64.233.166.180]) by robin.gentoo.org (8.13.6/8.13.6) with ESMTP id k3PJ8o6n019591 for ; Tue, 25 Apr 2006 19:08:51 GMT Received: by pproxy.gmail.com with SMTP id i49so1508314pye for ; Tue, 25 Apr 2006 12:08:50 -0700 (PDT) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=Bnn4Gli8edXmxR/v1bAuDW6LfNbuBru5zh27bpZHPZnK9DlwQKUUThZVSzaY8xpG+4T8KlH5T1g6a71eoo+vxV+TPsZpy2omu/6B10Qy7a7wsl2o3DiCbXx7GK/asfYLvVKhRuPsIM3bwd+1teF+7QUf2251ETVE/qgZMuKbouY= Received: by 10.35.105.18 with SMTP id h18mr1177941pym; Tue, 25 Apr 2006 12:08:50 -0700 (PDT) Received: by 10.35.99.11 with HTTP; Tue, 25 Apr 2006 12:08:49 -0700 (PDT) Message-ID: <623652d50604251208n27f718cdg9ed8eb6b6cc8f101@mail.gmail.com> Date: Tue, 25 Apr 2006 20:08:50 +0100 From: "Chris Bainbridge" To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] Purpose of USE=doc In-Reply-To: <444E6454.5040907@gentoo.org> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Disposition: inline References: <444E6454.5040907@gentoo.org> Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from quoted-printable to 8bit by robin.gentoo.org id k3PJ8o6n019591 X-Archives-Salt: 76ed8cbc-9317-4d03-a8f6-6719809cfb99 X-Archives-Hash: a97d0d472a80371dd09135504d5918ac On 25/04/06, Jakub Moc wrote: > Hello here, > > I'd like to see some clarification of intended doc use flag usage, so > that we wouldn't force users to download/install 40+ megs of docs for a > ~3 meg package, with the only reason being that USE=doc is for developer > documentation only. [1] The handbook states that "doc" is for package documentation. I've never heard of it being restricted to developer docs only, and if that's true, there are many packages which break that policy. As I always understood it, "doc" is there for all optional documentation such as manuals, APIs etc. Non-optional documentation would be things like online docs accessible from within the program (eg. "help" menu items for gui apps), which if missing generate run-time errors. -- gentoo-dev@gentoo.org mailing list