diff --git a/doc/lfun/logon b/doc/lfun/logon
new file mode 100644
index 0000000..700f1e0
--- /dev/null
+++ b/doc/lfun/logon
@@ -0,0 +1,15 @@
+logon()
+
+SYNOPSIS:
+	int logon(void)
+
+DESCRIPTION:
+	When the parser accepts a new connection, it first calls
+	connect() in the master object and then applies logon() to
+	the object that is returned by the master. That will usually be
+	a special login object, that is expected to clone and get going
+	a user shell or player object.
+	Should return 0 on failure, everything else means success.
+
+SEE ALSO:
+	connect(M)