From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 3EAD1138247 for ; Mon, 16 Dec 2013 20:48:36 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 2D536E0C1E; Mon, 16 Dec 2013 20:48:30 +0000 (UTC) Received: from mail-wi0-f174.google.com (mail-wi0-f174.google.com [209.85.212.174]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 128D2E0B70 for ; Mon, 16 Dec 2013 20:48:28 +0000 (UTC) Received: by mail-wi0-f174.google.com with SMTP id z2so2764345wiv.7 for ; Mon, 16 Dec 2013 12:48:27 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:user-agent:mime-version:to:subject:references :in-reply-to:content-type:content-transfer-encoding; bh=8+mhtpT9WlWL751bqy2TUMPulZb3anmgPwxVzeyuKV8=; b=yaHiE36+J++P13z3Mad7Ovo2bLE/upLlcLfQHPds8mOty3M/byEfBdqEXEAB3ebuQ2 cnAKRnCnHkU77xlbn+CQ0Xs2P/EKeqoV6mL654BcOG0ZFBpUurN3/3sKsSTDJ+uWKRN/ iQmjDOEpTZshYPNxr+zkRzL1Rnj1OmEuzexfSWW6QmhX6ytwZ5Cc2TNCDIzP4MBvC5/p UTI8HAIceALFRX8jKO2wOjc3zdtfTVcU3IipGoiv+4ISHy3/mXKQEl/CSt1WQUbXJ7fF SrW/MT164mOdT0n/V3s0FEGXYLZSKy9hdgWA3F6ojN1VlpEkyXv2IhBnurg8l/94JP9O WbUw== X-Received: by 10.194.243.170 with SMTP id wz10mr8944095wjc.74.1387226907859; Mon, 16 Dec 2013 12:48:27 -0800 (PST) Received: from [172.20.0.40] (196-210-126-64.dynamic.isadsl.co.za. [196.210.126.64]) by mx.google.com with ESMTPSA id xn17sm29229989wib.1.2013.12.16.12.48.26 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Mon, 16 Dec 2013 12:48:27 -0800 (PST) Message-ID: <52AF6717.2080909@gmail.com> Date: Mon, 16 Dec 2013 22:48:23 +0200 From: Alan McKinnon User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] Re: New global use flags: 3dnowext, mmxext, ssse3, sse4_1, avx, avx2 References: <52AF1E7E.9030803@gentoo.org> <52AF4491.8090000@gmail.com> <52AF5FD8.70505@gentoo.org> In-Reply-To: <52AF5FD8.70505@gentoo.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Archives-Salt: 39889598-3507-42fb-b00f-43c616df5537 X-Archives-Hash: 9b0c2b13e5274e59129120e231f3618b On 16/12/2013 22:17, Michael Orlitzky wrote: > On 12/16/2013 01:21 PM, Alan McKinnon wrote: >>> >>> "Enable use of the SSSE3 instruction set (NOT sse3). This is needed by >>> projects which contain assembly code or which use certain compiler >>> intrinsics. It is not a replacement for CFLAGS and friends." >> >> The second and third sentences add nothing to the description. They only >> describe how cpu instruction sets in general work and are used, but tell >> you nothing about ssse3. > > USE flags are a user interface, not documentation. A good description is > one that helps the user decide, "do I want to enable this?" I'm not > particular about the wording -- and my use of "needed" was a mistake -- > but with that purpose in mind, a good description should contain, > > 1. Why might I want to enable this? > > 2. Why might I want to disable this? > > So e.g. my description is missing #2, "You should not enable this unless > you have a processor supporting SSSE3." > > >> then modifying all cpu instruction set flags similarly > > Yup. Is it worthwhile adding a link in the description to a resource that describes a USE flag in greater detail? Most flags are obvious as to what they do, like jpeg/png/gif: the user simply asks himself if he wants to use those formats. Most flags are like this, and come down to user preference; portage merges in any missing parts required cpu sets are different: they also depend on whether they CAN be used in a given environment. Portage cannot know if ssse3 will work for the cpu running the code so cannot fill in the missing bits. The user must first check if the intended cpu supports ssse3 at all (often preceded by finding out how to find this out). That's a lot of vital ,necessary info and it deserves the full documentation treatment. A USE description is not the place for that, but a link could work nicely. Especially if the linked page describes the intent and usage of the USE flag in full. -- Alan McKinnon alan.mckinnon@gmail.com