From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 32B7FA0093 for ; Tue, 19 May 2020 15:14:58 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 2AB731D702; Tue, 19 May 2020 15:14:58 +0200 (CEST) Received: from mail-wr1-f41.google.com (mail-wr1-f41.google.com [209.85.221.41]) by dpdk.org (Postfix) with ESMTP id 5E8A61D931 for ; Tue, 19 May 2020 15:14:57 +0200 (CEST) Received: by mail-wr1-f41.google.com with SMTP id k13so13779977wrx.3 for ; Tue, 19 May 2020 06:14:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=kEkmbeojfoTHFI1G/G8+VN7kwtbxPZx78//WUmY13zM=; b=AOYcdV09Yw551HqsfMt/kRiOlC8EIE6PYAZTmGlZF5naOggU/l/FMzho1UGrnPo9pm BZY/F2dluKyfSw7ZHgDyXU+AHya33nDmydYg5xcCpT8OUxZgh8Rs1B9pH4lY7QHK7NP/ 9QignIgMa7AsDAkm3uYwPhxhVbKJOhkjA5azo6Mwx9oBkY+iqhiqxfD/Hw4SNwdL40IR EtNjwj3PLC9DG8DSa0XBhxpxm4GOvmT5jswLfSRMe2s3L0KJRvUIcD/cE4XHxj48QdtP 8L2cKO6w9slpjRz0P5ENwYZKzV5ltP8H0UNpnFdlVfQHKX4cXXwgqUFyD/hHenaLJcAD hlew== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=kEkmbeojfoTHFI1G/G8+VN7kwtbxPZx78//WUmY13zM=; b=tFH8YhK5tM7S0kEvj2fBDPTMB0tfos8A4mSek7GmfIycM+J292p9Shrs58MnWHH/+k 65UI28zEqkp4xR93KD5nF8pa2l3/EVYMiNqJ3xV5Uo0ZOkhXB0V5vPHK1WCihpD/3N5v uYo6bsNZk6NysfoIuhWcwFQsHJocqrdLtxhUEP+UmexsV2pX/rxytSD0H2LutSN3VxWZ UeizMukomiFhgz4kPuYqfS9Dz2leUa10F0eeudRpsuuQFuORH45j5lhAs8YffBNdg3S2 bbfi45C633Jegxa/1LosKoS+lz0Cww8Xhg/pR9xnIbOfYPMjPYAeJFPr0YKyO7r1YUqt 5Gjw== X-Gm-Message-State: AOAM531gf5cOs3KDBHmKBtOLEA6nZc4/G86Gv/sAOeBoVJ+SmsNzbrFM OyC6EiQeaL5VnCcujYQkdmE= X-Google-Smtp-Source: ABdhPJxd25ZP783oqNyUVwZ136bcQ74qpOyMD49tVemGvotdwWMA7LQG498MiKYYYf2LRdAYW2AqcQ== X-Received: by 2002:adf:f907:: with SMTP id b7mr26404607wrr.203.1589894097029; Tue, 19 May 2020 06:14:57 -0700 (PDT) Received: from localhost ([2a01:4b00:f419:6f00:7a8e:ed70:5c52:ea3]) by smtp.gmail.com with ESMTPSA id x10sm2317959wrn.54.2020.05.19.06.14.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 19 May 2020 06:14:56 -0700 (PDT) From: luca.boccassi@gmail.com To: Nicolas Chautru Cc: Akhil Goyal , dpdk stable Date: Tue, 19 May 2020 14:05:08 +0100 Message-Id: <20200519130549.112823-173-luca.boccassi@gmail.com> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20200519130549.112823-1-luca.boccassi@gmail.com> References: <20200519125804.104349-1-luca.boccassi@gmail.com> <20200519130549.112823-1-luca.boccassi@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-stable] patch 'bbdev: fix doxygen comments' has been queued to stable release 19.11.3 X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org Sender: "stable" Hi, FYI, your patch has been queued to stable release 19.11.3 Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet. It will be pushed if I get no objections before 05/21/20. So please shout if anyone has objections. Also note that after the patch there's a diff of the upstream commit vs the patch applied to the branch. This will indicate if there was any rebasing needed to apply to the stable branch. If there were code changes for rebasing (ie: not only metadata diffs), please double check that the rebase was correctly done. Thanks. Luca Boccassi --- >From 6e0bdc2ba184f08dd3245f2cff1db490973dcf9a Mon Sep 17 00:00:00 2001 From: Nicolas Chautru Date: Sun, 19 Apr 2020 16:39:48 -0700 Subject: [PATCH] bbdev: fix doxygen comments [ upstream commit cc29fea1ca53ce9860566b6986491bcf5aab99b5 ] Several doxygen markup were incorrect in header files. Fixes: 4935e1e9f76e ("bbdev: introduce wireless base band device lib") Signed-off-by: Nicolas Chautru Acked-by: Akhil Goyal --- lib/librte_bbdev/rte_bbdev.h | 16 ++++++++-------- lib/librte_bbdev/rte_bbdev_op.h | 16 ++++++++-------- lib/librte_bbdev/rte_bbdev_pmd.h | 14 +++++++------- 3 files changed, 23 insertions(+), 23 deletions(-) diff --git a/lib/librte_bbdev/rte_bbdev.h b/lib/librte_bbdev/rte_bbdev.h index 591fb7914a..1f58a0762f 100644 --- a/lib/librte_bbdev/rte_bbdev.h +++ b/lib/librte_bbdev/rte_bbdev.h @@ -440,21 +440,21 @@ TAILQ_HEAD(rte_bbdev_cb_list, rte_bbdev_callback); * these fields, but should only write to the *_ops fields. */ struct __rte_cache_aligned rte_bbdev { - /**< Enqueue encode function */ + /** Enqueue encode function */ rte_bbdev_enqueue_enc_ops_t enqueue_enc_ops; - /**< Enqueue decode function */ + /** Enqueue decode function */ rte_bbdev_enqueue_dec_ops_t enqueue_dec_ops; - /**< Dequeue encode function */ + /** Dequeue encode function */ rte_bbdev_dequeue_enc_ops_t dequeue_enc_ops; - /**< Dequeue decode function */ + /** Dequeue decode function */ rte_bbdev_dequeue_dec_ops_t dequeue_dec_ops; - /**< Enqueue encode function */ + /** Enqueue encode function */ rte_bbdev_enqueue_enc_ops_t enqueue_ldpc_enc_ops; - /**< Enqueue decode function */ + /** Enqueue decode function */ rte_bbdev_enqueue_dec_ops_t enqueue_ldpc_dec_ops; - /**< Dequeue encode function */ + /** Dequeue encode function */ rte_bbdev_dequeue_enc_ops_t dequeue_ldpc_enc_ops; - /**< Dequeue decode function */ + /** Dequeue decode function */ rte_bbdev_dequeue_dec_ops_t dequeue_ldpc_dec_ops; const struct rte_bbdev_ops *dev_ops; /**< Functions exported by PMD */ struct rte_bbdev_data *data; /**< Pointer to device data */ diff --git a/lib/librte_bbdev/rte_bbdev_op.h b/lib/librte_bbdev/rte_bbdev_op.h index 1e119a757b..6e43495fb4 100644 --- a/lib/librte_bbdev/rte_bbdev_op.h +++ b/lib/librte_bbdev/rte_bbdev_op.h @@ -389,12 +389,12 @@ struct rte_bbdev_op_turbo_dec { */ uint8_t num_maps; - /**< [0 - TB : 1 - CB] */ + /** [0 - TB : 1 - CB] */ uint8_t code_block_mode; union { - /**< Struct which stores Code Block specific parameters */ + /** Struct which stores Code Block specific parameters */ struct rte_bbdev_op_dec_turbo_cb_params cb_params; - /**< Struct which stores Transport Block specific parameters */ + /** Struct which stores Transport Block specific parameters */ struct rte_bbdev_op_dec_turbo_tb_params tb_params; }; }; @@ -545,7 +545,7 @@ struct rte_bbdev_op_enc_turbo_tb_params { * the Turbo operation when r >= C-, [K:3*Kpi] */ uint16_t ncb_pos; - /**< The index of the first CB in the inbound mbuf data, default is 0 */ + /** The index of the first CB in the inbound mbuf data, default is 0 */ uint8_t r; }; @@ -744,11 +744,11 @@ enum { /** Structure specifying a single encode operation */ struct rte_bbdev_enc_op { - /**< Status of operation that was performed */ + /** Status of operation that was performed */ int status; - /**< Mempool which op instance is in */ + /** Mempool which op instance is in */ struct rte_mempool *mempool; - /**< Opaque pointer for user data */ + /** Opaque pointer for user data */ void *opaque_data; union { /** Contains turbo decoder specific parameters */ @@ -785,7 +785,7 @@ struct rte_bbdev_op_cap { } cap; /**< Operation-type specific capabilities */ }; -/**< @internal Private data structure stored with operation pool. */ +/** @internal Private data structure stored with operation pool. */ struct rte_bbdev_op_pool_private { enum rte_bbdev_op_type type; /**< Type of operations in a pool */ }; diff --git a/lib/librte_bbdev/rte_bbdev_pmd.h b/lib/librte_bbdev/rte_bbdev_pmd.h index 24ddcee7af..237e3361d7 100644 --- a/lib/librte_bbdev/rte_bbdev_pmd.h +++ b/lib/librte_bbdev/rte_bbdev_pmd.h @@ -146,18 +146,18 @@ typedef int (*rte_bbdev_queue_intr_disable_t)(struct rte_bbdev *dev, * fields are for non-vital operations */ struct rte_bbdev_ops { - /**< Allocate and configure device memory. Optional. */ + /** Allocate and configure device memory. Optional. */ rte_bbdev_setup_queues_t setup_queues; - /**< Configure interrupts. Optional. */ + /** Configure interrupts. Optional. */ rte_bbdev_intr_enable_t intr_enable; - /**< Start device. Optional. */ + /** Start device. Optional. */ rte_bbdev_start_t start; - /**< Stop device. Optional. */ + /** Stop device. Optional. */ rte_bbdev_stop_t stop; - /**< Close device. Optional. */ + /** Close device. Optional. */ rte_bbdev_close_t close; - /**< Get device info. Required. */ + /** Get device info. Required. */ rte_bbdev_info_get_t info_get; /** Get device statistics. Optional. */ rte_bbdev_stats_get_t stats_get; @@ -170,7 +170,7 @@ struct rte_bbdev_ops { rte_bbdev_queue_release_t queue_release; /** Start a queue. Optional. */ rte_bbdev_queue_start_t queue_start; - /**< Stop a queue pair. Optional. */ + /** Stop a queue pair. Optional. */ rte_bbdev_queue_stop_t queue_stop; /** Enable queue interrupt. Optional */ -- 2.20.1 --- Diff of the applied patch vs upstream commit (please double-check if non-empty: --- --- - 2020-05-19 14:04:51.581369117 +0100 +++ 0173-bbdev-fix-doxygen-comments.patch 2020-05-19 14:04:44.516653810 +0100 @@ -1,12 +1,13 @@ -From cc29fea1ca53ce9860566b6986491bcf5aab99b5 Mon Sep 17 00:00:00 2001 +From 6e0bdc2ba184f08dd3245f2cff1db490973dcf9a Mon Sep 17 00:00:00 2001 From: Nicolas Chautru Date: Sun, 19 Apr 2020 16:39:48 -0700 Subject: [PATCH] bbdev: fix doxygen comments +[ upstream commit cc29fea1ca53ce9860566b6986491bcf5aab99b5 ] + Several doxygen markup were incorrect in header files. Fixes: 4935e1e9f76e ("bbdev: introduce wireless base band device lib") -Cc: stable@dpdk.org Signed-off-by: Nicolas Chautru Acked-by: Akhil Goyal @@ -17,10 +18,10 @@ 3 files changed, 23 insertions(+), 23 deletions(-) diff --git a/lib/librte_bbdev/rte_bbdev.h b/lib/librte_bbdev/rte_bbdev.h -index 38d9d50057..ecd95a823d 100644 +index 591fb7914a..1f58a0762f 100644 --- a/lib/librte_bbdev/rte_bbdev.h +++ b/lib/librte_bbdev/rte_bbdev.h -@@ -442,21 +442,21 @@ TAILQ_HEAD(rte_bbdev_cb_list, rte_bbdev_callback); +@@ -440,21 +440,21 @@ TAILQ_HEAD(rte_bbdev_cb_list, rte_bbdev_callback); * these fields, but should only write to the *_ops fields. */ struct __rte_cache_aligned rte_bbdev { @@ -51,10 +52,10 @@ const struct rte_bbdev_ops *dev_ops; /**< Functions exported by PMD */ struct rte_bbdev_data *data; /**< Pointer to device data */ diff --git a/lib/librte_bbdev/rte_bbdev_op.h b/lib/librte_bbdev/rte_bbdev_op.h -index 9c66721e32..f726d7302e 100644 +index 1e119a757b..6e43495fb4 100644 --- a/lib/librte_bbdev/rte_bbdev_op.h +++ b/lib/librte_bbdev/rte_bbdev_op.h -@@ -398,12 +398,12 @@ struct rte_bbdev_op_turbo_dec { +@@ -389,12 +389,12 @@ struct rte_bbdev_op_turbo_dec { */ uint8_t num_maps; @@ -70,7 +71,7 @@ struct rte_bbdev_op_dec_turbo_tb_params tb_params; }; }; -@@ -554,7 +554,7 @@ struct rte_bbdev_op_enc_turbo_tb_params { +@@ -545,7 +545,7 @@ struct rte_bbdev_op_enc_turbo_tb_params { * the Turbo operation when r >= C-, [K:3*Kpi] */ uint16_t ncb_pos; @@ -79,7 +80,7 @@ uint8_t r; }; -@@ -751,11 +751,11 @@ enum { +@@ -744,11 +744,11 @@ enum { /** Structure specifying a single encode operation */ struct rte_bbdev_enc_op { @@ -94,7 +95,7 @@ void *opaque_data; union { /** Contains turbo decoder specific parameters */ -@@ -792,7 +792,7 @@ struct rte_bbdev_op_cap { +@@ -785,7 +785,7 @@ struct rte_bbdev_op_cap { } cap; /**< Operation-type specific capabilities */ };