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 4B98E138247 for ; Mon, 16 Dec 2013 18:21:21 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id EFF24E0BC0; Mon, 16 Dec 2013 18:21:13 +0000 (UTC) Received: from mail-wi0-f182.google.com (mail-wi0-f182.google.com [209.85.212.182]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id E2468E0BA6 for ; Mon, 16 Dec 2013 18:21:12 +0000 (UTC) Received: by mail-wi0-f182.google.com with SMTP id en1so2547135wid.9 for ; Mon, 16 Dec 2013 10:21:11 -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=3zXowwMx/RBtVF/uG8PaDMwbJOAr0vqkn6upVpjhUlU=; b=wlejkSCk7Elf6FwI9+ZaGl0BW7EgumZHWMfB4u1URv8lcX4SXRTebvFNN/TwRLn3wG xs0jiLlFaBCQt+20fvxw8yO1xTLF/E1wv/g1eSg8fxYX87gCvsgv1INJAGjSeKvOtr1w Cg7ZU1oBKxTq04b+Qvt89GQx0qfA6c1ZaJ3qXISb6Sn5tkeCt7UPJpkpJ0jdCnx5ksE4 /EjM81hVQSCNS+a+oOtqYh41n8h8Vo75kA1DyB8ZZ/24yXeCE9mXN3W56gK1NefFFcN9 EhKy0oKX4SpRFtFC+YITfgq9o/xlgzjXvCrJW0+rKstH4Yhq33YNtRYGwlp/v8EReGuX fTrQ== X-Received: by 10.180.187.72 with SMTP id fq8mr15009406wic.26.1387218071574; Mon, 16 Dec 2013 10:21:11 -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 md9sm223858wic.1.2013.12.16.10.21.10 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Mon, 16 Dec 2013 10:21:10 -0800 (PST) Message-ID: <52AF4491.8090000@gmail.com> Date: Mon, 16 Dec 2013 20:21:05 +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> In-Reply-To: <52AF1E7E.9030803@gentoo.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Archives-Salt: 616dd2cc-f401-44c1-be5f-1a5af95b7040 X-Archives-Hash: be1d766a3ed3fa918da9d09d5c8c8708 On 16/12/2013 17:38, Michael Orlitzky wrote: > On 12/16/2013 05:44 AM, Duncan wrote: >> Matt Turner posted on Sun, 15 Dec 2013 15:34:13 -0800 as excerpted: >> >>> sse3: Use the SSE3 instruction set (pni in cpuinfo) >>> ssse3: Use the SSSE3 instruction set >> >> I'd suggest a parenthetical on ssse3 as well, something like: >> >> ssse3: Use the SSSE3 instruction set (NOT sse3, three s) >> >> I know that confused me for awhile, and I tend to be reasonably literate >> (as a user, anyway) on this sort of thing, > > Why not go all the way? > > "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. I recommend a short expansion on what ssse3 is, and shortening the rest while retaining it's meaning, then modifying all cpu instruction set flags similarly > You can make a case for brevity, but how many times do you find yourself > (a) reading USE flag descriptions, and (b) thinking they're too long? It's possible to have a very verbose, and meaningless, description. be verbose by all means if the verbosity carries useful information -- Alan McKinnon alan.mckinnon@gmail.com