Skip to content

Improve Synet API documentation#368

Merged
ermig1979 merged 1 commit into
masterfrom
cursor/improve-synet-docs-3752
Jun 5, 2026
Merged

Improve Synet API documentation#368
ermig1979 merged 1 commit into
masterfrom
cursor/improve-synet-docs-3752

Conversation

@ermig1979
Copy link
Copy Markdown
Owner

Summary

  • Improve SimdLib.h documentation for Synet deconvolution, dequantization, eltwise, activation, gather-elements, grid-sample, and inner-product APIs based on implementation behavior.
  • Clarify tensor shapes, data types, buffer units, activation formulas, constant index analysis, and FP32/BF16/INT8 semantics.

Testing

  • git diff --check
  • printf '#include "Simd/SimdLib.h"\nint main(){return 0;}\n' | g++ -std=c++11 -I./src -x c++ -fsyntax-only -

Full test suite was intentionally not run per request.

Open in Web Open in Cursor 

Co-authored-by: Ihar Yermalayeu <ermig@tut.by>
@ermig1979 ermig1979 marked this pull request as ready for review June 5, 2026 12:51
Copilot AI review requested due to automatic review settings June 5, 2026 12:51
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves the in-header (Doxygen) documentation for several Synet-related public APIs in SimdLib.h, aligning the comments with the actual behavior and parameter semantics implemented in the Synet backends.

Changes:

  • Expanded BF16/FP32 deconvolution (SimdSynetDeconvolution16b*) documentation with shape constraints, buffer semantics, and forward behavior notes.
  • Clarified semantics for dequantization, eltwise, and multiple activation helpers (parameter units, “only [0] used” patterns, and formulas).
  • Documented GatherElements and GridSample2D contexts with explicit tensor shapes, supported data types, and implementation notes; expanded inner-product API docs (FP32 and BF16/FP32) including buffer units and const-weight behavior.

@ermig1979 ermig1979 merged commit b6cba0a into master Jun 5, 2026
25 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants