Received: by 2002:a25:e7d8:0:0:0:0:0 with SMTP id e207csp2253548ybh; Mon, 9 Mar 2020 02:07:53 -0700 (PDT) X-Google-Smtp-Source: ADFU+vtXn0TuL9psOb4jWn9apZ6N8EuHu9vjuJqcEoErDCxmB8mYy4m0SoIi6q0i1KJ4cb6LTb+j X-Received: by 2002:a9d:19ef:: with SMTP id k102mr9169259otk.220.1583744873047; Mon, 09 Mar 2020 02:07:53 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1583744873; cv=none; d=google.com; s=arc-20160816; b=WKDuqcytwFMEIZRfOPo3ofvS09BXXIjslUNpakjOcPBg6ikY0X873RM+mHpUA4CW3M lKlqL9AeDwb7cbi/8gL8djudz9lPt1kfAxfErFf3CQq8IAeQbR+rzP6igeo/eO3EeAon whSDteLuw90iSYEzReG6O9rJGqy35BI1pz86vZi1+iltA1d3sIHH4fsV9m+H68ZwpMgh hNXdNf5jFQoxbSwyMNhCnGrHUp0KVr3zm/3YxPDuLoXJ3RU9IqiP9+FMbGpULAl/Cvhf Wr9erl59FKuVF/HMwJMu9QwqOsqL3J4JcPsH38+P4asuHXGf1HB6vF1f297dlZgX4mR7 JRuA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:in-reply-to:content-transfer-encoding :content-disposition:mime-version:references:message-id:subject:cc :to:from:date:dkim-signature; bh=ovwAOrod+pcHugf+bHywQDDeJcz0ScIRA7A9zSI+2vM=; b=heEytWYm8dmha/VipWf7Z71T9eQlapXh8qLUNcWmQxmf4r24eu6ZtkipB0Q+DfdLuf uz9A2mR9Guqbi5q2MLdvrbmxHhKRV5dbj3yGKyryIBgXelafZHcTDic4+HT6ltSsxRSO dIKdPzpBMzPz5W1YJOCGYwH3puUOkI6Bz++mGGk6mscsOS/VkR4jX2+qQplkEl9idFMl x12YTMZYI5501jnIGNhxJRUXzTwS6U6T8ULS7v7zBqP3lfzPU3W723A8S8m5T3PzqwDL bGFxvhf10Os/UEjZh80NLoFE4r92sJ49OIV4tdY0gjv+SEnjWjkR++a8VSrQbIIf1Tt7 QrHA== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@infradead.org header.s=bombadil.20170209 header.b="ifovaK/k"; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id j18si6196618otq.93.2020.03.09.02.07.41; Mon, 09 Mar 2020 02:07:53 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=fail header.i=@infradead.org header.s=bombadil.20170209 header.b="ifovaK/k"; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726461AbgCIJHI (ORCPT + 99 others); Mon, 9 Mar 2020 05:07:08 -0400 Received: from bombadil.infradead.org ([198.137.202.133]:45998 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726215AbgCIJHH (ORCPT ); Mon, 9 Mar 2020 05:07:07 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=In-Reply-To:Content-Transfer-Encoding :Content-Type:MIME-Version:References:Message-ID:Subject:Cc:To:From:Date: Sender:Reply-To:Content-ID:Content-Description; bh=ovwAOrod+pcHugf+bHywQDDeJcz0ScIRA7A9zSI+2vM=; b=ifovaK/kO8/X67kmI3vvmgEMFF FRSpZQLKfdun9jAgIFz5xMpIbEQmoH41eGKCSSh1F6bXXTZUqrzvxgkB6MR9siuaACaSXzRB8gXVV Ddy7r00J7jM5rnenJgxdYK754Vmg1vbuV9cO8I/GOeu6BK+NpAlw9+tr9GNvOArkHMjPMTRQBZ4OW cuNZfFIN5WE47Vsrr9kAx877r+CBW1CDcn80mrcumxiRjtgmU+/obDicBiUc1JftwOWOIHIjLEhNj wJJH9keSms1ln6ufyZZVdcSmFiRJO5nS1vW7yIOtlM23aQcpgf1BjOs560IsOYwmGMjxg06N53Mnc YslE+Hzw==; Received: from j217100.upc-j.chello.nl ([24.132.217.100] helo=noisy.programming.kicks-ass.net) by bombadil.infradead.org with esmtpsa (Exim 4.92.3 #3 (Red Hat Linux)) id 1jBENB-0001JG-PJ; Mon, 09 Mar 2020 09:06:53 +0000 Received: from hirez.programming.kicks-ass.net (hirez.programming.kicks-ass.net [192.168.1.225]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by noisy.programming.kicks-ass.net (Postfix) with ESMTPS id F295030066E; Mon, 9 Mar 2020 10:06:50 +0100 (CET) Received: by hirez.programming.kicks-ass.net (Postfix, from userid 1000) id D590225F2C26C; Mon, 9 Mar 2020 10:06:50 +0100 (CET) Date: Mon, 9 Mar 2020 10:06:50 +0100 From: Peter Zijlstra To: Jonathan =?iso-8859-1?Q?Neusch=E4fer?= Cc: linux-doc@vger.kernel.org, Alan Stern , Andrea Parri , Will Deacon , Boqun Feng , Nicholas Piggin , David Howells , Jade Alglave , Luc Maranget , "Paul E. McKenney" , Akira Yokosawa , Daniel Lustig , Jonathan Corbet , linux-kernel@vger.kernel.org, linux-arch@vger.kernel.org Subject: Re: [PATCH 0/3] docs: a few improvements for atomic_ops.rst Message-ID: <20200309090650.GF12561@hirez.programming.kicks-ass.net> References: <20200308195618.22768-1-j.neuschaefer@gmx.net> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20200308195618.22768-1-j.neuschaefer@gmx.net> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Sun, Mar 08, 2020 at 08:56:15PM +0100, Jonathan Neusch?fer wrote: > Hi, > > this is a short series of unrelated fixes that make the atomic > operations documentation look and read a bit better. > > Jonathan Neusch?fer (3): > docs: atomic_ops: Remove colons where they don't make sense > docs: atomic_ops: Move two paragraphs into the warning block above > docs: atomic_ops: Steer readers towards using refcount_t for reference > counts > > Documentation/core-api/atomic_ops.rst | 24 ++++++++++++------- FWIW, I consider this a dead document. I've written Documentation/atomic_t.txt and Documentation/atomic_bitops.txt as a replacement. If there is anything in atomic_ops you feel is missing from those two, please tell as I'm planing to delete atomic_ops soon.