Update comments reflecting Allocator lifetime guarantees.

src/definitions.rs

@@ -389,7 +389,13 @@ bitflags! {
 pub struct AllocatorCreateInfo<'a> {
     /// Vulkan physical device. It must be valid throughout whole lifetime of created allocator.
     pub(crate) physical_device: PhysicalDevice,
+
+    /// Vulkan device.
+    /// It must be valid throughout the whole lifetime of created allocator.
     pub(crate) device: &'a Device,
+
+    /// Handle to Vulkan instance object.
+    /// Must be valid throughout the whole lifetime of created allocator.
     pub(crate) instance: &'a Instance,
 
     /// Flags for created allocator.

src/lib.rs

@@ -46,8 +46,10 @@ unsafe impl Send for Allocation {}
 unsafe impl Sync for Allocation {}
 
 impl Allocator {
-    /// Constructor a new `Allocator` using the provided options.
-    pub fn new(create_info: AllocatorCreateInfo) -> VkResult<Self> {
+    /// Construct a new `Allocator` using the provided options.
+    /// Safety: [`AllocatorCreateInfo::instance`], [`AllocatorCreateInfo::device`] and
+    /// [`AllocatorCreateInfo::physical_device`] must be valid throughout the lifetime of the allocator.
+    pub unsafe fn new(create_info: AllocatorCreateInfo) -> VkResult<Self> {
         unsafe extern "system" fn get_instance_proc_addr_stub(
             _instance: vk::Instance,
             _p_name: *const ::std::os::raw::c_char,