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;
From:   Bogdan Purcareata <bogdan.purcareata@nxp.com>
To:     =?iso-8859-2?Q?Horia_Geant=E3?= <horia.geanta@nxp.com>,
        "gregkh@linuxfoundation.org" <gregkh@linuxfoundation.org>,
        Laurentiu Tudor <laurentiu.tudor@nxp.com>,
        Ruxandra Ioana Ciocoi Radulescu <ruxandra.radulescu@nxp.com>
CC:     "stuyoder@gmail.com" <stuyoder@gmail.com>,
        "arnd@arndb.de" <arnd@arndb.de>,
        "robh@kernel.org" <robh@kernel.org>,
        Razvan Stefanescu <razvan.stefanescu@nxp.com>,
        Ioana Ciornei <ioana.ciornei@nxp.com>,
        Nipun Gupta <nipun.gupta@nxp.com>,
        Roy Pledge <roy.pledge@nxp.com>,
        "marc.zyngier@arm.com" <marc.zyngier@arm.com>,
        "tglx@linutronix.de" <tglx@linutronix.de>,
        "jason@lakedaemon.net" <jason@lakedaemon.net>,
        "devel@driverdev.osuosl.org" <devel@driverdev.osuosl.org>,
        "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>,
        "linux-arm-kernel@lists.infradead.org" 
        <linux-arm-kernel@lists.infradead.org>
Subject: RE: [PATCH v6 1/2] staging: fsl-mc: Move core bus out of staging
Thread-Topic: [PATCH v6 1/2] staging: fsl-mc: Move core bus out of staging
Thread-Index: AQHTnorG7fJk+WIg1U6NBej+X5uKQKOXEVnA
Date:   Tue, 6 Feb 2018 08:57:10 +0000
Message-ID: <AM0PR0402MB3649BC95F62CDAA921CF361DEAFD0@AM0PR0402MB3649.eurprd04.prod.outlook.com>
References: <20180205140743.29974-1-bogdan.purcareata@nxp.com>
 <20180205140743.29974-2-bogdan.purcareata@nxp.com>
 <VI1PR0402MB33427D7D04239420F3FE7D5A98FD0@VI1PR0402MB3342.eurprd04.prod.outlook.com>
In-Reply-To: <VI1PR0402MB33427D7D04239420F3FE7D5A98FD0@VI1PR0402MB3342.eurprd04.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
received-spf: None (protection.outlook.com: nxp.com does not designate
 permitted sender hosts)
spamdiagnosticoutput: 1:99
spamdiagnosticmetadata: NSPM
Content-Type: text/plain; charset="iso-8859-2"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: 4e2c9fdc-86ec-4449-87e6-08d56d3f9b7e
X-MS-Exchange-CrossTenant-originalarrivaltime: 06 Feb 2018 08:57:10.0827
 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR0402MB3683
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

> -----Original Message-----
> From: Horia Geant=E3
> Sent: Tuesday, February 06, 2018 9:18 AM
> To: Bogdan Purcareata <bogdan.purcareata@nxp.com>; gregkh@linuxfoundation=
.org;
> Laurentiu Tudor <laurentiu.tudor@nxp.com>; Ruxandra Ioana Ciocoi Radulesc=
u
> <ruxandra.radulescu@nxp.com>
> Cc: stuyoder@gmail.com; arnd@arndb.de; robh@kernel.org; Razvan Stefanescu
> <razvan.stefanescu@nxp.com>; Ioana Ciornei <ioana.ciornei@nxp.com>; Nipun=
 Gupta
> <nipun.gupta@nxp.com>; Roy Pledge <roy.pledge@nxp.com>; marc.zyngier@arm.=
com;
> tglx@linutronix.de; jason@lakedaemon.net; devel@driverdev.osuosl.org; lin=
ux-
> kernel@vger.kernel.org; linux-arm-kernel@lists.infradead.org
> Subject: Re: [PATCH v6 1/2] staging: fsl-mc: Move core bus out of staging
>=20
> On 2/5/2018 4:08 PM, Bogdan Purcareata wrote:
> > Move the source files out of staging into their final locations:
> >   -mc.h include file in drivers/staging/fsl-mc/include go to
> include/linux/fsl
> >   -source files in drivers/staging/fsl-mc/bus go to drivers/bus/fsl-mc
> >   -overview.rst, providing an overview of DPAA2, goes to
> >    Documentation/networking/dpaa2/overview.rst
> [...]
> >  rename {drivers/staging/fsl-mc =3D>
> Documentation/networking/dpaa2}/overview.rst (100%)
>=20
> Is this the proper location for documentation?
> The doc focuses on networking, however there's also information about fsl=
 mc
> bus, dpio.

Yes, after internal discussions we concluded it would be the best fit, sinc=
e
the end usage scenario is a networking one. So far the main user of the fsl=
-mc
bus and dpio is dpaa2-eth, which is an Ethernet driver. It's also next to t=
he
previous DPAA generation driver documentation at Documentation/networking/d=
paa.txt.

> In the future, we might want to add doc for other dpaa2 objects sitting o=
n the
> fsl mc bus:
> -dpseci ("Data Path SEC Interface" - abstraction for the crypto engine)
> -dpdcei ("Data Path Decompression and Compression Engine Interface")
>=20
> Would these fit under networking doc folder too?

IMO it would make sense to place them in the same Documentation/networking/=
dpaa2/
folder, since they're part of the same architecture. Of course, the end loc=
ation
can be changed based on later feedback.

Cheers,
Bogdan P.