core: update NAPacketiser::parse_stream() documentation
authorKostya Shishkov <kostya.shishkov@gmail.com>
Tue, 23 Apr 2024 16:50:29 +0000 (18:50 +0200)
committerKostya Shishkov <kostya.shishkov@gmail.com>
Tue, 23 Apr 2024 16:50:29 +0000 (18:50 +0200)
nihav-core/src/codecs/mod.rs

index b7d781987a8a7da159561ba8fb0bb076137b12c2..80e2da813ff4084ec814eb570ac0726b4258b2c3 100644 (file)
@@ -437,10 +437,12 @@ pub trait NAPacketiser {
     fn add_data(&mut self, src: &[u8]) -> bool;
     /// Tries to retrieve stream information from the data.
     ///
-    /// Returns [`NAStream`] reference on success (with stream ID set to `id`), [`ShortData`] when there is not enough data to parse the headers and other errors in case there was an error parsing the data.
+    /// Returns [`NAStream`] reference on success (with stream ID set to `id`), [`ShortData`] when there is not enough data to parse the headers, [`MissingReference`] when stream parsing is not possible without reference information provided by [`attach_stream`] and other errors in case there was an error parsing the data.
     ///
     /// [`NAStream`]: ../frame/struct.NAStream.html
     /// [`ShortData`]: ./enum.DecoderError.html#variant.ShortData
+    /// [`MissingReference`]: ./enum.DecoderError.html#variant.MissingReference
+    /// [`attach_stream`]: ./trait.NAPacketiser.html#tymethod.attach_stream
     fn parse_stream(&mut self, id: u32) -> DecoderResult<NAStreamRef>;
     /// Tries to discard junk data until the first possible packet header.
     ///