From mboxrd@z Thu Jan  1 00:00:00 1970
From: Thomas Monjalon <thomas@monjalon.net>
Subject: Re: [PATCH v3 1/8] eal: introduce DMA memory barriers
Date: Mon, 22 Jan 2018 21:59:39 +0100
Message-ID: <1785374.EvMsrt8sou@xps>
References: <20180116011050.18866-1-yskoh@mellanox.com>
 <805e1578-6e4d-6a1b-00ce-13e3b1c16be8@solarflare.com>
 <5B266F6C-A33B-4019-BFDE-9CAC80835200@mellanox.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7Bit
Cc: dev@dpdk.org, "jianbo.liu@arm.com" <jianbo.liu@arm.com>,
 Jerin Jacob <jerin.jacob@caviumnetworks.com>,
 Adrien Mazarguil <adrien.mazarguil@6wind.com>,
 =?ISO-8859-1?Q?N=E9lio?= Laranjeiro <nelio.laranjeiro@6wind.com>,
 "bruce.richardson@intel.com" <bruce.richardson@intel.com>, "Ananyev,
 Konstantin" <konstantin.ananyev@intel.com>,
 Chao Zhu <chaozhu@linux.vnet.ibm.com>
To: Yongseok Koh <yskoh@mellanox.com>,
 Andrew Rybchenko <arybchenko@solarflare.com>
Return-path: <dev-bounces@dpdk.org>
Received: from out3-smtp.messagingengine.com (out3-smtp.messagingengine.com
 [66.111.4.27]) by dpdk.org (Postfix) with ESMTP id CE3B9A48C
 for <dev@dpdk.org>; Mon, 22 Jan 2018 22:00:18 +0100 (CET)
In-Reply-To: <5B266F6C-A33B-4019-BFDE-9CAC80835200@mellanox.com>
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://dpdk.org/ml/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>

22/01/2018 19:29, Yongseok Koh:
> > On Jan 18, 2018, at 11:16 PM, Andrew Rybchenko <arybchenko@solarflare.com> wrote:
> > Maybe it would be useful to:
> >  - avoid duplication of so long explanations (put in in one place and add reference?)
> 
> May have to ask Thomas how to do this. Thomas?

You can group barriers by type (SMP, IO, DMA) with this doxygen syntax:
	https://www.stack.nl/~dimitri/doxygen/manual/grouping.html#memgroup
So you can have a common description of the group, plus a description
of each function.