From dc2493e7525bb7633f697ef10f72b72b46222249 Mon Sep 17 00:00:00 2001 From: Andy Belle-Isle Date: Fri, 30 Aug 2019 00:45:36 -0400 Subject: Forget what I said, I just need to change git attributes to mark for vendor --- lib/sol2/docs/source/traits.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 lib/sol2/docs/source/traits.rst (limited to 'lib/sol2/docs/source/traits.rst') diff --git a/lib/sol2/docs/source/traits.rst b/lib/sol2/docs/source/traits.rst new file mode 100644 index 0000000..ca1b566 --- /dev/null +++ b/lib/sol2/docs/source/traits.rst @@ -0,0 +1,18 @@ +customization traits +==================== + +These are customization points within the library to help you make sol3 work for the types in your framework and types. + +To learn more about various customizable traits, visit: + +* :doc:`containers customization traits` + - This is how to work with containers in their entirety and what operations you're afforded on them + - when you have an compiler error when serializing a type that has ``begin`` and ``end`` functions but isn't exactly a container +* :doc:`unique usertype (custom pointer) traits` + - This is how to deal with unique usertypes, e.g. ``boost::shared_ptr``, reference-counted pointers, etc + - Useful for custom pointers from all sorts of frameworks or handle types that employ very specific kinds of destruction semantics and access +* :doc:`customization points` + - This is how to customize a type to work with sol2 + - Can be used for specializations to push strings and other class types that are not natively ``std::string`` or ``const char*``, like `a wxString, for example`_ + +.. _a wxString, for example: https://github.com/ThePhD/sol2/issues/140#issuecomment-237934947 -- cgit v1.2.3