From mboxrd@z Thu Jan  1 00:00:00 1970
From: "Mcnamara, John" <john.mcnamara@intel.com>
Subject: Re: [PATCH 1/6] doc: add empty PMDs todo list
Date: Mon, 11 Dec 2017 11:52:29 +0000
Message-ID: <B27915DBBA3421428155699D51E4CFE23EE1F8F0@IRSMSX103.ger.corp.intel.com>
References: <20171121014241.61050-1-ferruh.yigit@intel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Cc: "dev@dpdk.org" <dev@dpdk.org>
To: "Yigit, Ferruh" <ferruh.yigit@intel.com>, Thomas Monjalon
 <thomas@monjalon.net>
Return-path: <dev-bounces@dpdk.org>
Received: from mga14.intel.com (mga14.intel.com [192.55.52.115])
 by dpdk.org (Postfix) with ESMTP id 6849C2C38
 for <dev@dpdk.org>; Mon, 11 Dec 2017 12:52:32 +0100 (CET)
In-Reply-To: <20171121014241.61050-1-ferruh.yigit@intel.com>
Content-Language: en-US
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <http://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: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>



> -----Original Message-----
> From: Yigit, Ferruh
> Sent: Tuesday, November 21, 2017 1:43 AM
> To: Thomas Monjalon <thomas@monjalon.net>; Mcnamara, John
> <john.mcnamara@intel.com>
> Cc: dev@dpdk.org; Yigit, Ferruh <ferruh.yigit@intel.com>
> Subject: [PATCH 1/6] doc: add empty PMDs todo list
>=20
> Some library modifications require extra checks or modifications in PMDs
> but currently we don't have a good way to trace these modifications.
>=20
> And number of these kind of updates increasing by time.
>=20
> This is an effort to document and track library updates that requires
> attention in PMDs.
>=20
> Although this is under documentation main use case is for internal
> development.
>=20
> Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>

>...
>
> +PMDs internal TODO list
> +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
> +
> +This is the list for tracking required PMD changes triggered by library
> modifications.
> +
> +.. table:: PMDs internal TODO list
> +
> + +------+------+----------+----------------+------+
> + | TODO | PMDs | Deadline | Related Commit | Note |
> + +=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D+=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D+
> + |      |      |          |                |      |
> + +------+------+----------+----------------+------+


The table should have a label, and it should be indented to the level of ..=
 table
as shown in the guidelines: http://dpdk.org/doc/guides/contributing/documen=
tation.html#rst-guidelines

Something like this:

.. _table_nic_todo:

.. table:: PMDs internal TODO list

   +------+------+----------+----------------+------+
   | TODO | PMDs | Deadline | Related Commit | Note |
   +=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D+=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D+
   |      |      |          |                |      |
   +------+------+----------+----------------+------+

However, it isn't an error so:


Acked-by: John McNamara <john.mcnamara@intel.com>