From 6eec4b7768e41e253b01add1b2b4fd07dd09bb21 Mon Sep 17 00:00:00 2001
From: Daniel Verkamp <dverkamp@chromium.org>
Date: Thu, 27 Apr 2023 17:26:14 -0700
Subject: [PATCH] Fix cargo doc warnings from Rust 1.68

Some type parameters in <> were being mis-parsed as HTML tags.

BUG=b:276487055
TEST=tools/cargo-doc # with rust 1.68.2

Change-Id: Iaa9ec6cf94a6084cfdf323bb04c643396a320889
Reviewed-on: https://chromium-review.googlesource.com/c/crosvm/crosvm/+/4485758
Commit-Queue: Daniel Verkamp <dverkamp@chromium.org>
Reviewed-by: Alexandre Courbot <acourbot@chromium.org>
---
 base/src/custom_serde.rs                   | 2 +-
 crosvm_control/src/lib.rs                  | 4 ++--
 devices/src/bus.rs                         | 2 +-
 devices/src/tsc/calibrate.rs               | 2 +-
 media/cros-codecs/src/decoders/h264/dpb.rs | 4 ++--
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/base/src/custom_serde.rs b/base/src/custom_serde.rs
index 129392d500..c2391f0441 100644
--- a/base/src/custom_serde.rs
+++ b/base/src/custom_serde.rs
@@ -14,7 +14,7 @@ use serde::Serialize;
 use serde::Serializer;
 use sync::Mutex;
 
-/// Serialize data T inside an Arc<Mutex<T>>. T must be serializable.
+/// Serialize data `T` inside an `Arc<Mutex<T>>`. `T` must be serializable.
 ///
 /// NOTE: This does not validate already serialized Mutexes and data. If multiple structs contain a
 /// clone of the Arc, and they are all being serialized, this will result in the same data being
diff --git a/crosvm_control/src/lib.rs b/crosvm_control/src/lib.rs
index 9d495f151c..3153dc88cc 100644
--- a/crosvm_control/src/lib.rs
+++ b/crosvm_control/src/lib.rs
@@ -446,8 +446,8 @@ pub unsafe extern "C" fn crosvm_client_resize_disk(
     .unwrap_or(false)
 }
 
-/// Similar to internally used `BalloonStats` but using i64 instead of
-/// Option<u64>. `None` (or values bigger than i64::max) will be encoded as -1.
+/// Similar to internally used `BalloonStats` but using `i64` instead of
+/// `Option<u64>`. `None` (or values bigger than `i64::max`) will be encoded as -1.
 #[repr(C)]
 pub struct BalloonStatsFfi {
     swap_in: i64,
diff --git a/devices/src/bus.rs b/devices/src/bus.rs
index bdd82d975a..a2364234a0 100644
--- a/devices/src/bus.rs
+++ b/devices/src/bus.rs
@@ -71,7 +71,7 @@ pub struct ConfigWriteResult {
     pub io_add: Vec<BusRange>,
 
     /// Device specified at PciAddress will be removed after this config write
-    /// - 'Vec<PciAddress>>': specified device will be removed after this config write
+    /// - `Vec<PciAddress>>`: specified device will be removed after this config write
     pub removed_pci_devices: Vec<PciAddress>,
 }
 
diff --git a/devices/src/tsc/calibrate.rs b/devices/src/tsc/calibrate.rs
index bb5a18278f..64ce56cc86 100644
--- a/devices/src/tsc/calibrate.rs
+++ b/devices/src/tsc/calibrate.rs
@@ -34,7 +34,7 @@ pub enum TscCalibrationError {
     SetCpuAffinityError { core: usize, err: base::Error },
 }
 
-/// Get the standard deviation of a Vec<T>.
+/// Get the standard deviation of a `Vec<T>`.
 pub fn standard_deviation<T: num_traits::ToPrimitive + num_traits::Num + Copy>(items: &[T]) -> f64 {
     let sum: T = items.iter().fold(T::zero(), |acc: T, elem| acc + *elem);
     let count = items.len();
diff --git a/media/cros-codecs/src/decoders/h264/dpb.rs b/media/cros-codecs/src/decoders/h264/dpb.rs
index c97227b800..a0b8cbdf85 100644
--- a/media/cros-codecs/src/decoders/h264/dpb.rs
+++ b/media/cros-codecs/src/decoders/h264/dpb.rs
@@ -365,7 +365,7 @@ impl<T: DecodedHandle> Dpb<T> {
         self.interlaced = interlaced;
     }
 
-    /// Gets a Vec<ContainedPicture> of short term refs into `out`
+    /// Gets a `Vec<ContainedPicture>` of short term refs into `out`
     pub fn get_short_term_refs(&self, out: &mut Vec<DpbEntry<T>>) {
         out.extend(
             self.entries
@@ -375,7 +375,7 @@ impl<T: DecodedHandle> Dpb<T> {
         )
     }
 
-    /// Gets a Vec<ContainedPicture> of long term refs into `out`
+    /// Gets a `Vec<ContainedPicture>` of long term refs into `out`
     pub fn get_long_term_refs(&self, out: &mut Vec<DpbEntry<T>>) {
         out.extend(
             self.entries