diff --git a/doc/efun/new_lwobject b/doc/efun/new_lwobject
new file mode 100644
index 0000000..ab19e42
--- /dev/null
+++ b/doc/efun/new_lwobject
@@ -0,0 +1,63 @@
+SYNOPSIS
+        lwobject new_lwobject(string name, ...)
+
+DESCRIPTION
+        Creates a new lightweight object from the program <name> and
+        returns it. The program will be loaded as a regular object,
+        called a blueprint, first, and then a lightweight object will
+        be created therefrom.
+
+        Note that the pathname must be complete, which means there are no
+        relative paths allowed. Any further arguments will be passed to
+        the H_CREATE_LWOBJECT hook to initialize the lightweight object.
+
+        If strict euids are enforced, the calling object must have a
+        non-zero euid.
+
+        Variable initialization is done similar to cloned objects with a call
+        to the internal lfun __INIT(). However, if #pragma share_variables is
+        in effect, the values for a lightweight object's variables are taken
+        from the current variables of the blueprint.
+
+        In the absence of share_variables, variables without explicit
+        initializers are initialized to 0.
+
+
+EXAMPLES
+        --- /lwo/stack.c ---
+        mixed* stack = ({});
+
+        int empty()
+        {
+            return sizeof(stack) == 0;
+        }
+
+        void push(mixed val)
+        {
+            stack += ({ val });
+        }
+
+        mixed pop()
+        {
+            mixed result;
+
+            if (empty())
+                raise_error("stack is empty.\n");
+
+            result = stack[<1];
+            stack = stack[..<2];
+            return result;
+        }
+
+        --- usage: ---
+        lwobject stack = new_lwobject("/lwo/stack");
+
+        stack.push("A");
+        return stack.pop();
+
+
+HISTORY
+        LDMud 3.6.5 introduced lightweight objects.
+
+SEE ALSO
+        blueprint(E), lwobjectp(E), load_name(E), uids(C), pragma(LPC)