Reworked shared pointers, with some smaller API changes.

1 files changed, 7 insertions, 6 deletions

diff --git a/docs/csptr_api.md b/docs/csptr_api.md
index 95c4f93c..8aa04ed7 100644
--- a/docs/csptr_api.md
+++ b/docs/csptr_api.md
@@ -33,18 +33,19 @@ The *csptr_X_compare()*, *csptr_X_del()* methods are defined based on the `i_cmp
 Use *csptr_X_clone(p)* when sharing ownership of the pointed-to object. For shared pointers stored in containers, define `i_val_csptr` to the shared pointers tag instead of a `i_val` macro. See example below.
 ```c
 csptr_X             csptr_X_init();                               // empty constructor
-csptr_X             csptr_X_make(Value val);                      // make_shared constructor, fast
+csptr_X             csptr_X_make(Value val);                      // make_shared constructor, like std::make_shared()
 csptr_X             csptr_X_from(Value* p);                       // construct from raw pointer
-csptr_X             csptr_X_clone(csptr_X ptr);                   // clone shared (increase use count)
-csptr_X             csptr_X_move(csptr_X* self);                  // fast transfer ownership to another sptr.
-csptr_X_value_t*    csptr_X_copy(csptr_X* self, csptr_X other);   // copy shared (increase use count)
+csptr_X             csptr_X_clone(csptr_X ptr);                   // return ptr with increased use count
+csptr_X             csptr_X_move(csptr_X* self);                  // transfer ownership to another sptr.
+void                csptr_X_take(csptr_X* self, csptr_X other);   // take a new-created or moved csptr
+void                csptr_X_copy(csptr_X* self, csptr_X other);   // copy shared (increase use count)
 
 void                csptr_X_del(csptr_X* self);                   // destruct (decrease use count, free at 0)
 long                csptr_X_use_count(csptr_X ptr);
 
 void                csptr_X_reset(csptr_X* self);
-csptr_X_value_t*    csptr_X_reset_make(csptr_X* self, Value val); // assign new sptr with value
-csptr_X_value_t*    csptr_X_reset_with(csptr_X* self, Value* p);  // slower than reset_make().
+void                csptr_X_reset_with(csptr_X* self, Value val); // make and assign new csptr with value
+void                csptr_X_reset_from(csptr_X* self, Value* p);  // create csptr from p.
 
 int                 csptr_X_compare(const csptr_X* x, const csptr_X* y);
 bool                csptr_X_equals(const csptr_X* x, const csptr_X* y);