Document extension modules

Changelog.md

@@ -76,6 +76,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - extensions/ext/ray_tracing_pipeline: Pass indirect SBT regions as single item reference (#829)
 - Replaced `c_char` array setters with `CStr` setters (#831)
 - `push_next()` functions now allow unsized `p_next` argument (#855)
+- Removed the redundant `ash::extensions` module hierarchy in favor of defining wrappers directly in the extension modules under `ash::vk` (#894)
 
 ### Removed
 

ash-examples/src/lib.rs

@@ -11,11 +11,14 @@ use std::{
     borrow::Cow, cell::RefCell, default::Default, error::Error, ffi, ops::Drop, os::raw::c_char,
 };
 
-use ash::vk::{
-    ext::debug_utils,
-    khr::{surface, swapchain},
+use ash::{
+    vk,
+    vk::{
+        ext::debug_utils,
+        khr::{surface, swapchain},
+    },
+    Device, Entry, Instance,
 };
-use ash::{vk, Device, Entry, Instance};
 use winit::{
     event::{ElementState, Event, KeyEvent, WindowEvent},
     event_loop::{ControlFlow, EventLoop},

ash/src/lib.rs

@@ -70,6 +70,7 @@ pub mod util;
 pub mod vk;
 
 // macros of vk need to be defined beforehand
+/// Hand-written ergonomic wrappers for extension functions
 mod extensions;
 
 pub trait RawPtr<T> {