docs: add doc(cfg(...)) attributes for docsrs feature documentation

Author: roderickvd

src/decoder/mod.rs

@@ -1174,6 +1174,7 @@ pub enum DecoderError {
     /// The stream contained malformed data and could not be decoded or demuxed.
     #[error("The stream contained malformed data and could not be decoded or demuxed: {0}")]
     #[cfg(feature = "symphonia")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "symphonia")))]
     DecodeError(&'static str),
 
     /// A default or user-defined limit was reached while decoding or demuxing
@@ -1183,16 +1184,19 @@ pub enum DecoderError {
         "A default or user-defined limit was reached while decoding or demuxing the stream: {0}"
     )]
     #[cfg(feature = "symphonia")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "symphonia")))]
     LimitError(&'static str),
 
     /// The demuxer or decoder needs to be reset before continuing.
     #[error("The demuxer or decoder needs to be reset before continuing.")]
     #[cfg(feature = "symphonia")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "symphonia")))]
     ResetRequired,
 
     /// No streams were found by the decoder.
     #[error("No streams were found by the decoder.")]
     #[cfg(feature = "symphonia")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "symphonia")))]
     NoStreams,
 }
 assert_error_traits!(DecoderError);

src/lib.rs

@@ -163,6 +163,7 @@
 )]
 
 #[cfg(feature = "playback")]
+#[cfg_attr(docsrs, doc(cfg(feature = "playback")))]
 pub use cpal::{
     self, traits::DeviceTrait, Device, Devices, DevicesError, InputDevices, OutputDevices,
     SupportedStreamConfig,
@@ -172,6 +173,7 @@ mod common;
 mod sink;
 mod spatial_sink;
 #[cfg(feature = "playback")]
+#[cfg_attr(docsrs, doc(cfg(feature = "playback")))]
 pub mod stream;
 #[cfg(feature = "wav_output")]
 #[cfg_attr(docsrs, doc(cfg(feature = "wav_output")))]
@@ -195,6 +197,7 @@ pub use crate::sink::Sink;
 pub use crate::source::Source;
 pub use crate::spatial_sink::SpatialSink;
 #[cfg(feature = "playback")]
+#[cfg_attr(docsrs, doc(cfg(feature = "playback")))]
 pub use crate::stream::{play, OutputStream, OutputStreamBuilder, PlayError, StreamError};
 #[cfg(feature = "wav_output")]
 #[cfg_attr(docsrs, doc(cfg(feature = "wav_output")))]

src/source/agc.rs

@@ -41,6 +41,7 @@ const fn power_of_two(n: usize) -> usize {
 const RMS_WINDOW_SIZE: usize = power_of_two(8192);
 
 #[cfg(feature = "experimental")]
+#[cfg_attr(docsrs, doc(cfg(feature = "experimental")))]
 /// Automatic Gain Control filter for maintaining consistent output levels.
 ///
 /// This struct implements an AGC algorithm that dynamically adjusts audio levels