Handle multiline descriptions for @return and other tags

Copilot · swissspidy · Copilot · commit 9ec518ac76d4 · 2025-12-17T20:51:48.000Z
Extended the fix to handle multiline descriptions for all docblock tags (@return, @throws, etc.), not just @param. Removed the 'param' === $param_name check so any tag with a description can span multiple lines. Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>
diff --git a/bin/Handbook_Command.php b/bin/Handbook_Command.php
@@ -812,8 +812,8 @@ private static function parse_docblock( $docblock ) {
 					end( $ret['parameters'][ $param_name ] );
 					$key = key( $ret['parameters'][ $param_name ] );
 					reset( $ret['parameters'][ $param_name ] );
-					// Always set $in_param for @param tags to capture multiline descriptions
-					if ( 'param' === $param_name && ! empty( $ret['parameters'][ $param_name ][ $key ][2] ) ) {
+					// Always set $in_param for tags that can have multiline descriptions
+					if ( ! empty( $ret['parameters'][ $param_name ][ $key ][2] ) ) {
 						$in_param = [ $param_name, $key ];
 					} else {
 						$in_param = false;
