From fbd313976cab1551e5e0f691897420ba2ee1c841 Mon Sep 17 00:00:00 2001
From: sogaiu <33044872+sogaiu@users.noreply.github.com>
Date: Wed, 26 Aug 2026 22:14:45 +0000
Subject: [PATCH] Improve docstring for table/to-struct (#1831)

Co-authored-by: sogaiu <983021772@users.noreply.github.com>
---
 src/core/table.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/core/table.c b/src/core/table.c
index ec418d6a..1cddad73 100644
--- a/src/core/table.c
+++ b/src/core/table.c
@@ -384,7 +384,11 @@ JANET_CORE_FN(cfun_table_setproto,
 
 JANET_CORE_FN(cfun_table_tostruct,
               "(table/to-struct tab &opt proto)",
-              "Convert a table to a struct. Returns a new struct.") {
+              "Create and return a struct based on a table `tab`. "
+              "If given, the optional argument `proto` specifies "
+              "a struct to be used as the newly created struct's "
+              "prototype. Note that if `proto` is not specified, "
+              "the newly created struct will not have a prototype.") {
     janet_arity(argc, 1, 2);
     JanetTable *t = janet_gettable(argv, 0);
     JanetStruct proto = janet_optstruct(argv, argc, 1, NULL);