From 58481857e229e8665b94b60937bf73742de0c856 Mon Sep 17 00:00:00 2001
From: Roland Conybeare <rconybeare@gmail.com>
Date: Wed, 21 Jan 2026 17:35:01 -0500
Subject: [PATCH] xo-reader2: DefineSsm: respond to = token

---
 include/xo/facet/obj.hpp | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/include/xo/facet/obj.hpp b/include/xo/facet/obj.hpp
index b50bf65..3983cec 100644
--- a/include/xo/facet/obj.hpp
+++ b/include/xo/facet/obj.hpp
@@ -103,7 +103,12 @@ namespace xo {
                 return *this;
             }
 
-            /** safe downcast from variant. null if downcast fails **/
+            /** safe downcast from variant. null if downcast fails
+             *
+             *  Use:
+             *    obj<AFoo> x = ...;
+             *    obj<AFoo,DQuux> quux = obj<AFoo,DQuux>::from(x);
+             **/
             static obj from(const OObject<AFacet> & other) {
                 return obj(other.template downcast<DRepr>());
             }