From b6641c67735060bd0327a8ec9e35e0f5edfb1be2 Mon Sep 17 00:00:00 2001
From: Xenira <1288524+Xenira@users.noreply.github.com>
Date: Thu, 10 Jul 2025 17:23:20 +0200
Subject: [PATCH] fix(stubs): include doc comments in `__construct()` stubs

Refs: #497
---
 crates/macros/src/function.rs      | 2 ++
 tests/src/integration/class/mod.rs | 3 +++
 2 files changed, 5 insertions(+)

diff --git a/crates/macros/src/function.rs b/crates/macros/src/function.rs
index 1afcfa3b42..e1dcb5a416 100644
--- a/crates/macros/src/function.rs
+++ b/crates/macros/src/function.rs
@@ -337,6 +337,7 @@ impl<'a> Function<'a> {
                 .variadic()
             }
         });
+        let docs = &self.docs;
 
         quote! {
             ::ext_php_rs::class::ConstructorMeta {
@@ -359,6 +360,7 @@ impl<'a> Function<'a> {
                 build_fn: {
                     fn inner(func: ::ext_php_rs::builders::FunctionBuilder) -> ::ext_php_rs::builders::FunctionBuilder {
                         func
+                            .docs(&[#(#docs),*])
                             #(.arg(#required_args))*
                             .not_required()
                             #(.arg(#not_required_args))*
diff --git a/tests/src/integration/class/mod.rs b/tests/src/integration/class/mod.rs
index 5ce40ab798..b84e018f06 100644
--- a/tests/src/integration/class/mod.rs
+++ b/tests/src/integration/class/mod.rs
@@ -53,6 +53,9 @@ pub struct TestClassArrayAccess {}
 
 #[php_impl]
 impl TestClassArrayAccess {
+    /// Constructor
+    /// doc
+    /// comment
     pub fn __construct() -> Self {
         Self {}
     }