Jens-G opened a new pull request, #3525: URL: https://github.com/apache/thrift/pull/3525
## Summary - Output files now use the `.md` extension by default (previously extension-less). The `suffix` option still overrides; `suffix=` (empty) explicitly suppresses any extension. - `@param` and `@return` tags in function doc-comments are now rendered as a Markdown table instead of being buried in inline prose. Tags are only matched at the start of a line, so `@`-signs in ordinary prose (e.g. email addresses) are unaffected. Multi-line descriptions are joined; `|` characters are escaped. - Adds test fixture `DocTest.thrift`, golden file `DocTest.md`, and 6-case Python unittest `markdown_doc_test.py` registered as `MarkdownDocTest` in CMake. ## Test plan - [x] Compiler builds cleanly (`ninja thrift-compiler` in `cmake_build_compiler/`) - [x] All 6 Python tests pass: `python3 compiler/cpp/test/compiler/markdown_doc_test.py <thrift-binary> -v` - [x] Manual inspection of `ThriftTest.thrift` output: `testMulti` renders 6 param rows + Returns row; `testException` plain prose is unaffected - [ ] `clang-format` — not available in the build environment; manual style review needed before merge ## Related JIRA: https://issues.apache.org/jira/browse/THRIFT-6038 🤖 Generated with [Claude Code](https://claude.com/claude-code) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
