Update wrappers docs

src/wrap/caching.rs

@@ -24,9 +24,9 @@ pub type CachingProd<R> = Caching<R, true, false>;
 pub type CachingCons<R> = Caching<R, false, true>;
 
 impl<R: RbRef, const P: bool, const C: bool> Caching<R, P, C> {
- /// # Safety
+ /// Create a new ring buffer cached wrapper.
  ///
- /// There must be no more than one consumer wrapper.
+ /// Panics if wrapper with matching rights already exists.
  pub fn new(rb: R) -> Self {
  Self { frozen: Frozen::new(rb) }
  }

src/wrap/direct.rs

@@ -36,9 +36,9 @@ impl<R: RbRef> Clone for Obs<R> {
 }
 
 impl<R: RbRef, const P: bool, const C: bool> Direct<R, P, C> {
- /// # Safety
+ /// Create a new ring buffer direct wrapper.
  ///
- /// There must be no more than one wrapper with the same parameter being `true`.
+ /// Panics if wrapper with matching rights already exists.
  pub fn new(rb: R) -> Self {
  if P {
  assert!(!unsafe { rb.rb().hold_write(true) });

src/wrap/frozen.rs

@@ -38,7 +38,9 @@ pub type FrozenProd<R> = Frozen<R, true, false>;
 pub type FrozenCons<R> = Frozen<R, false, true>;
 
 impl<R: RbRef, const P: bool, const C: bool> Frozen<R, P, C> {
- /// Create new ring buffer cache.
+ /// Create a new ring buffer frozen wrapper.
+ ///
+ /// Panics if wrapper with matching rights already exists.
  pub fn new(rb: R) -> Self {
  if P {
  assert!(!unsafe { rb.rb().hold_write(true) });
@@ -53,7 +55,7 @@ impl<R: RbRef, const P: bool, const C: bool> Frozen<R, P, C> {
  ///
  /// # Safety
  ///
- /// There must be maximum one instance of producer and one - of consumer.
+ /// There must be maximum one instance of matching rights.
  pub(crate) unsafe fn new_unchecked(rb: R) -> Self {
  Self {
  read: Cell::new(rb.rb().read_index()),