[dpdk-stable] patch 'bbdev: fix doxygen comments' has been queued to stable release 19.11.3

[luca.boccassi at gmail.com]

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 <nicolas.chautru at intel.com>
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 <nicolas.chautru at intel.com>
Acked-by: Akhil Goyal <akhil.goyal at nxp.com>
---
 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 <nicolas.chautru at intel.com>
 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 at dpdk.org
 
 Signed-off-by: Nicolas Chautru <nicolas.chautru at intel.com>
 Acked-by: Akhil Goyal <akhil.goyal at nxp.com>
@@ -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 */
  };