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

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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
@ermig1979
ermig1979 deleted the cursor/improve-synet-docs-3752 branch July 1, 2026 11:08
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