Feat: rename dbox, dbuffer, fix format issues, fix intrinsics doctests

Author: RDambrosio016

crates/cuda_std/src/intrinsics.rs

@@ -0,0 +1,10 @@
+# Changelog
+
+Notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+- Rename `DBuffer` -> `DeviceBuffer`. This is how it was in rustacuda, but it was changed
+at some point, but now we reconsidered that it may be the wrong choice.
+- Renamed `DBox` -> `DeviceBox`.
+- Fixed some doctests that were using old APIs.

crates/cust/CHANGELOG.md

@@ -232,16 +232,16 @@ impl Event {
     /// # use cust::stream::{Stream, StreamFlags};
     /// # use cust::launch;
     /// # use cust::module::Module;
-    /// # use cust::memory::DBox;
+    /// # use cust::memory::DeviceBox;
     /// # use std::error::Error;
     /// # use std::ffi::CString;
     /// # fn main() -> Result<(), Box<dyn Error>> {
     /// # let _context = quick_init()?;
     /// # let module_data = CString::new(include_str!("../resources/add.ptx"))?;
     /// # let module = Module::load_from_string(&module_data)?;
-    /// # let mut x = DBox::new(&10.0f32)?;
-    /// # let mut y = DBox::new(&20.0f32)?;
-    /// # let mut result = DBox::new(&0.0f32)?;
+    /// # let mut x = DeviceBox::new(&10.0f32)?;
+    /// # let mut y = DeviceBox::new(&20.0f32)?;
+    /// # let mut result = DeviceBox::new(&0.0f32)?;
     /// use cust::event::{Event, EventFlags};
     ///
     /// let stream = Stream::new(StreamFlags::NON_BLOCKING, None)?;

crates/cust/src/event.rs

@@ -226,9 +226,8 @@ impl<'a> Function<'a> {
     /// # use std::ffi::CString;
     /// # let ptx = CString::new(include_str!("../resources/add.ptx"))?;
     /// # let module = Module::load_from_string(&ptx)?;
-    /// # let name = CString::new("sum")?;
     /// use cust::function::FunctionAttribute;
-    /// let function = module.get_function(&name)?;
+    /// let function = module.get_function("sum")?;
     /// let shared_memory = function.get_attribute(FunctionAttribute::SharedMemorySizeBytes)?;
     /// println!("This function uses {} bytes of shared memory", shared_memory);
     /// # Ok(())
@@ -270,9 +269,8 @@ impl<'a> Function<'a> {
     /// # use std::ffi::CString;
     /// # let ptx = CString::new(include_str!("../resources/add.ptx"))?;
     /// # let module = Module::load_from_string(&ptx)?;
-    /// # let name = CString::new("sum")?;
     /// use cust::context::CacheConfig;
-    /// let mut function = module.get_function(&name)?;
+    /// let mut function = module.get_function("sum")?;
     /// function.set_cache_config(CacheConfig::PreferL1)?;
     /// # Ok(())
     /// # }
@@ -298,9 +296,8 @@ impl<'a> Function<'a> {
     /// # use std::ffi::CString;
     /// # let ptx = CString::new(include_str!("../resources/add.ptx"))?;
     /// # let module = Module::load_from_string(&ptx)?;
-    /// # let name = CString::new("sum")?;
     /// use cust::context::SharedMemoryConfig;
-    /// let mut function = module.get_function(&name)?;
+    /// let mut function = module.get_function("sum")?;
     /// function.set_shared_memory_config(SharedMemoryConfig::EightByteBankSize)?;
     /// # Ok(())
     /// # }
@@ -487,8 +484,7 @@ impl<'a> Function<'a> {
 ///     result?;
 ///
 ///     // Launch the kernel again using the `function` form:
-///     let function_name = CString::new("sum")?;
-///     let sum = module.get_function(&function_name)?;
+///     let sum = module.get_function("sum")?;
 ///     // Launch with 1x1x1 (1) blocks of 10x1x1 (10) threads, to show that you can use tuples to
 ///     // configure grid and block size.
 ///     let result = launch!(sum<<<(1, 1, 1), (10, 1, 1), 0, stream>>>(