From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-0.6 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6BF92C76191 for ; Thu, 18 Jul 2019 13:47:33 +0000 (UTC) Received: from dpdk.org (dpdk.org [92.243.14.124]) by mail.kernel.org (Postfix) with ESMTP id F15FB20873 for ; Thu, 18 Jul 2019 13:47:32 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=monjalon.net header.i=@monjalon.net header.b="lopgAr9B"; dkim=fail reason="signature verification failed" (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="yCCDONXb" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org F15FB20873 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=monjalon.net Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=dev-bounces@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 3966B276C; Thu, 18 Jul 2019 15:47:32 +0200 (CEST) Received: from wout5-smtp.messagingengine.com (wout5-smtp.messagingengine.com [64.147.123.21]) by dpdk.org (Postfix) with ESMTP id A37751DBE for ; Thu, 18 Jul 2019 15:47:30 +0200 (CEST) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.west.internal (Postfix) with ESMTP id 6F70442A; Thu, 18 Jul 2019 09:47:29 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Thu, 18 Jul 2019 09:47:29 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding:content-type; s=mesmtp; bh=oj2txgZeK0UmYI/QjPItsvPQ5Tu5eE8OLEAa9rFd1Lk=; b=lopgAr9B121O GXlMubcXFSTF7QxaEAH1zIwnMGW2wo9CY8gSsoV/0acXJbpRUljh7BIkd0ikOemI mtsVPZkIyNnMK8sWZ08BfIcGxf9UBKNUc12yeWu3X1HEAxZXtR5K6fR+0na27usY +WPkRiVGgfbGu+h5aQzR0QMvjmwFS5M= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=oj2txgZeK0UmYI/QjPItsvPQ5Tu5eE8OLEAa9rFd1 Lk=; b=yCCDONXbuFEL4usF9PX1ecnrbFgb/X2PMZ/svQVTq/q7sdaqy4fLbG3gk Bo59E27ZXfpt0k1nzxWcopwvkyN3sTH/62QkLdHIljleGKNygeBZyO0V1fcFBy7q OFP8+QBS7+TBw9R1VJEiBLSxdtCkLKbul17Nl9wtcgqYfUZJ1hS42z9ZwKK5S5q2 9IIZXGsl2aW3RIl0bNAe5kmOwo/V1p0f6oiw8Z4Piy2NHO6Q+0kq6BaO+q5HH4Bf vNr5mfUZls7crlJohiCbEzmRsfRSEKiLOZzTax1BJ1Xuwg9RHHl7eMehLepRyVz1 rImA+ijdh2521g0pvwFCLfFC2H+Nw== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduvddrieehgdejudcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpefhvffufffkjghfggfgtgesthfuredttddtvdenucfhrhhomhepvfhhohhmrghs ucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenucffoh hmrghinhepughpughkrdhorhhgnecukfhppeejjedrudefgedrvddtfedrudekgeenucfr rghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhhonhdrnhgvthenuc evlhhushhtvghrufhiiigvpedt X-ME-Proxy: Received: from xps.localnet (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id 05ACF80059; Thu, 18 Jul 2019 09:47:27 -0400 (EDT) From: Thomas Monjalon To: "Chautru, Nicolas" Cc: "Mcnamara, John" , "Kovacevic, Marko" , "dev@dpdk.org" Date: Thu, 18 Jul 2019 15:47:26 +0200 Message-ID: <65166682.iuaK6TOrCN@xps> In-Reply-To: <1183128033837D43A851F70F33ED5C575C1FD28B@FMSMSX109.amr.corp.intel.com> References: <20190717220123.6165-1-thomas@monjalon.net> <1183128033837D43A851F70F33ED5C575C1FD28B@FMSMSX109.amr.corp.intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Subject: Re: [dpdk-dev] [PATCH] doc: fix PDF build of bbdev prog guide X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" 18/07/2019 15:33, Chautru, Nicolas: > From: Thomas Monjalon [mailto:thomas@monjalon.net] > >Anyway all the documentation about the API details should be removed. > >The guide is expected to give an understanding of the whole design, not replacing the details maintained in the doxygen comments. > > Thanks Thomas. > These tables are arguably useful on that page with the related contextual verbose information aside which provide more context usage. Still I am reformatting into simpler table structure. > I have just pushed a parallel patch here : https://patches.dpdk.org/patch/56715/ Sorry, I am not sure to understand. You want to keep all this information? As I said, most of this guide may be removed because it is redundant with what we should have in doxygen: http://doc.dpdk.org/api/rte__bbdev_8h.html Do you need to add more information in doxygen?