Enabled docs.rs feature gate flag rendering.

Cargo.toml

@@ -35,3 +35,10 @@ trybuild = "1.0"
 
 [workspace]
 members = ["gdal-sys"]
+
+# docs.rs-specific configuration
+[package.metadata.docs.rs]
+# include `array` feature in documentation
+features = ["array"]
+# define attribute `docsrs` for feature badges
+rustdoc-args = ["--cfg", "docsrs"]

src/errors.rs

@@ -14,6 +14,7 @@ pub enum GdalError {
     #[error("StrUtf8Error")]
     StrUtf8Error(#[from] std::str::Utf8Error),
     #[cfg(feature = "ndarray")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "array")))]
     #[error("NdarrayShapeError")]
     NdarrayShapeError(#[from] ndarray::ShapeError),
     #[error("CPL error class: '{class:?}', error number: '{number}', error msg: '{msg}'")]

src/lib.rs

@@ -21,6 +21,9 @@
 #![crate_name = "gdal"]
 #![crate_type = "lib"]
 
+// Enable `doc_cfg` features when `docsrs` is defined by docs.rs config
+#![cfg_attr(docsrs, feature(doc_cfg))]
+
 pub use version::version_info;
 
 pub mod config;

src/raster/mdarray.rs

@@ -226,6 +226,7 @@ impl<'a> MDArray<'a> {
     }
 
     #[cfg(feature = "ndarray")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "array")))]
     /// Read a 'Array2<T>' from this band. T implements 'GdalType'.
     ///
     /// # Arguments

src/raster/rasterband.rs

@@ -311,6 +311,7 @@ impl<'a> RasterBand<'a> {
     }
 
     #[cfg(feature = "ndarray")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "array")))]
     /// Read a 'Array2<T>' from this band. T implements 'GdalType'.
     ///
     /// # Arguments
@@ -348,6 +349,7 @@ impl<'a> RasterBand<'a> {
     }
 
     #[cfg(feature = "ndarray")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "array")))]
     /// Read a 'Array2<T>' from a 'Dataset' block. T implements 'GdalType'
     /// # Arguments
     /// * block_index - the block index