rust: fix clippy warnings doc_overindented_list_items

warning: doc list item overindented
   --> src/nfs/rpc_records.rs:284:5
    |
284 | ///           type: bool
    |     ^^^^^^^^^^ help: try using `  ` (2 spaces)
    |
    = help: for further information visit https://rust-lang.github.io/rust-clippy/master/index.html#doc_overindented_list_items
    = note: `#[warn(clippy::doc_overindented_list_items)]` on by default

rust/src/dcerpc/dcerpc.rs

@@ -454,9 +454,7 @@ impl DCERPCState {
     /// parser in C. This requires an internal transaction ID to be maintained.
     ///
     /// Arguments:
-    /// * `tx_id`:
+    /// * `tx_id`: internal transaction ID to track transactions
-    ///           type: unsigned 32 bit integer
-    ///    description: internal transaction ID to track transactions
     ///
     /// Return value:
     /// Option mutable reference to DCERPCTransaction
@@ -474,12 +472,8 @@ impl DCERPCState {
     /// found, create one.
     ///
     /// Arguments:
-    /// * `call_id`:
+    /// * `call_id`: call_id param derived from TCP Header
-    ///             type: unsigned 32 bit integer
+    /// * `dir`: direction of the flow
-    ///      description: call_id param derived from TCP Header
-    /// * `dir`:
-    ///         type: enum Direction
-    ///   description: direction of the flow
     ///
     /// Return value:
     /// Option mutable reference to DCERPCTransaction
@@ -567,13 +561,12 @@ impl DCERPCState {
     /// Makes a call to the nom parser for parsing DCERPC Header.
     ///
     /// Arguments:
-    /// * `input`:
+    /// * `input`: bytes from the beginning of the buffer.
-    ///           type: u8 vector slice.
-    ///    description: bytes from the beginning of the buffer.
     ///
     /// Return value:
     /// * Success: Number of bytes successfully parsed.
-    /// * Failure: -1 in case of Incomplete data or Eof.
+    /// * Failure:
+    //    -1 in case of Incomplete data or Eof.
     ///   -2 in case of Error while parsing.
     ///   -3 in case of invalid DCERPC header.
     pub fn process_header(&mut self, input: &[u8]) -> i32 {
@@ -782,15 +775,9 @@ impl DCERPCState {
     /// Handles stub data for both request and response.
     ///
     /// Arguments:
-    /// * `input`:
+    /// * `input`: bytes left *after* parsing header.
-    ///           type: u8 vector slice.
+    /// * `bytes_consumed`: bytes consumed *after* parsing header.
-    ///    description: bytes left *after* parsing header.
+    /// * `dir`: direction whose stub is supposed to be handled.
-    /// * `bytes_consumed`:
-    ///           type: 16 bit unsigned integer.
-    ///    description: bytes consumed *after* parsing header.
-    /// * `dir`:
-    ///           type: enum Direction.
-    ///    description: direction whose stub is supposed to be handled.
     ///
     /// Return value:
     /// * Success: Number of bytes successfully parsed.

rust/src/dcerpc/dcerpc_udp.rs

@@ -130,8 +130,7 @@ impl DCERPCUDPState {
     /// parser in C. This requires an internal transaction ID to be maintained.
     ///
     /// Arguments:
-    /// * `tx_id`:
+    /// * `tx_id`: internal transaction ID to track transactions
-    ///    description: internal transaction ID to track transactions
     ///
     /// Return value:
     /// Option mutable reference to DCERPCTransaction

rust/src/nfs/rpc_records.rs

@@ -215,9 +215,7 @@ pub struct RpcPacket<'a> {
 ///  2. we have partial data (large records) -> allow partial prog_data parsing
 ///
 /// Arguments:
-/// * `complete`:
+/// * `complete`: do full parsing, including of `prog_data`
-///           type: bool
-///    description: do full parsing, including of `prog_data`
 ///
 pub fn parse_rpc(start_i: &[u8], complete: bool) -> IResult<&[u8], RpcPacket> {
     let (i, hdr) = parse_rpc_packet_header(start_i)?;
@@ -282,9 +280,7 @@ pub fn parse_rpc(start_i: &[u8], complete: bool) -> IResult<&[u8], RpcPacket> {
 ///  2. we have partial data (large records) -> allow partial prog_data parsing
 ///
 /// Arguments:
-/// * `complete`:
+/// * `complete`: do full parsing, including of `prog_data`
-///           type: bool
-///    description: do full parsing, including of `prog_data`
 ///
 pub fn parse_rpc_reply(start_i: &[u8], complete: bool) -> IResult<&[u8], RpcReplyPacket> {
     let (i, hdr) = parse_rpc_packet_header(start_i)?;