| docs(math): 批量更新 math 目录算子文档至最新标准模板 Co-authored-by: wyb780310<wangyubo37@huawei.com> # message auto-generated for no-merge-commit merge: !1559 merge master into master docs(math): 批量更新 math 目录算子文档至最新标准模板 Created-by: wyb780310 Commit-by: wyb780310 Merged-by: cann-robot Description: ## 描述 本次 PR 主要针对 math 目录下多个算子的 aclnn*.md 接口说明文档进行了批量重构和格式审查，使其严格符合最新的 开源aclnnmd新模板 格式规范。（注：本次追加提交包含了更多算子的文档统一规范化处理） **主要修改内容包括：** 1. **函数原型对齐**：将原型统一修改为带有换行和参数垂直对齐的 Cpp 格式代码块，大幅提升可读性。 2. **参数说明表格化**：废弃了原本冗长的无序列表描述，全面重构为标准宽度的 8 字段 HTML 表格（主表格宽统一为 1550px）。 3. **数据类型精简**：合并整理了各硬件系列支持的数据类型至“数据类型”列，将特定芯片（如不支持 BFLOAT16）的差异说明精简提炼至表格下方，去除冗余描述。 4. **补充必要字段**：为所有的 Tensor 参数显式补齐了“支持空Tensor。”以及关联的推导说明。 5. **排版与标点规范**：统一所有返回值和二级接口参数表格的宽度为 1150px 及特定列配比；并将全篇的 **返回值:** 等标点符号修正为规范的中文冒号；清理了无用的代码块外粗体。 **涉及修改的算子及目录清单：** - reduce_log_sum (aclnnReduceLogSum) - reduce_nansum (aclnnReduceNansum) - reduce_sum_op (aclnnReduceSum) - floor_mod / mod (aclnnRemainder, aclnnFmod) - scale (aclnnScale) - sub (aclnnRsub, aclnnRsubs) - rsqrt (aclnnRsqrt) - round (aclnnRound, aclnnRoundDecimals) ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 纯文档格式规范化更新，不涉及底层 Kernel/Host 代码逻辑修改。 已在本地通过 Markdown 渲染预览，表格排版正常无错位；已完成 Committer 级别的对标审查（与标杆模板 aclnnSum.md 的规范要求完全一致）。 ## 文档更新 批量更新并规范化了 math 目录下多个子目录的算子 docs/aclnn*.md 说明文档。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!1559 | 6 个月前 |
