Problem
The current PTO ISA documentation still presents the following T* APIs as part of the tile instruction surface:
TSETFMATRIX
TSET_IMG2COL_RPT
TSET_IMG2COL_PADDING
TGET_SCALE_ADDR
That categorization is misleading at the API/semantic level.
These operations do not primarily describe tile payload transformation. They program or derive control/state used by later execution:
TSETFMATRIX programs FMATRIX-related configuration state.
TSET_IMG2COL_RPT programs IMG2COL repeat metadata.
TSET_IMG2COL_PADDING programs IMG2COL padding metadata.
TGET_SCALE_ADDR derives/binds an address relationship rather than performing tile arithmetic.
As a result, the tile-family docs overstate what the tile surface actually is, and PTO-AS / ISA taxonomy remains blurry.
Requested change
Reclassify these four operations into the micro-instruction surface and temporarily remove them from the tile instruction documentation.
This should be treated as a semantic/API taxonomy change, not just a wording tweak.
Scope
Reclassify
Move the semantic classification of:
TSETFMATRIX
TSET_IMG2COL_RPT
TSET_IMG2COL_PADDING
TGET_SCALE_ADDR
from tile-instruction docs into the micro-instruction docs.
Temporarily remove from tile docs
Until the micro-instruction placement is complete, remove these ops from tile-instruction taxonomies and tile-family summaries so the tile docs remain semantically clean.
Affected documentation areas
At minimum, review and update:
docs/isa/instruction-surfaces/tile-instructions*.md
docs/isa/instruction-families/tile-families*.md
docs/isa/instruction-surfaces/README*.md
docs/assembly/PTO-AS*.md
docs/mkdocs/src/manual/07-instructions*.md
docs/isa/manifest.yaml
- generated index / matrix outputs derived from the manifest
- the micro-instruction landing / group pages under
docs/isa/scalar/ops/micro-instruction/
Acceptance criteria
- The tile instruction docs no longer classify these four operations as tile instructions.
- The micro-instruction docs explicitly include and explain these four operations.
- PTO-AS docs make the semantic family clear and do not imply that a
T* name automatically belongs to the tile surface.
docs/isa/manifest.yaml and generated family/index pages reflect the new classification.
- English and Chinese docs remain aligned.
git diff --check passes.
- Manifest-derived doc generation/check scripts pass.
Notes
This issue is intentionally limited to these four operations. A broader semantic cleanup of the T* namespace may still be needed later, but that should be tracked separately.
Problem
The current PTO ISA documentation still presents the following
T*APIs as part of the tile instruction surface:TSETFMATRIXTSET_IMG2COL_RPTTSET_IMG2COL_PADDINGTGET_SCALE_ADDRThat categorization is misleading at the API/semantic level.
These operations do not primarily describe tile payload transformation. They program or derive control/state used by later execution:
TSETFMATRIXprograms FMATRIX-related configuration state.TSET_IMG2COL_RPTprograms IMG2COL repeat metadata.TSET_IMG2COL_PADDINGprograms IMG2COL padding metadata.TGET_SCALE_ADDRderives/binds an address relationship rather than performing tile arithmetic.As a result, the tile-family docs overstate what the tile surface actually is, and PTO-AS / ISA taxonomy remains blurry.
Requested change
Reclassify these four operations into the micro-instruction surface and temporarily remove them from the tile instruction documentation.
This should be treated as a semantic/API taxonomy change, not just a wording tweak.
Scope
Reclassify
Move the semantic classification of:
TSETFMATRIXTSET_IMG2COL_RPTTSET_IMG2COL_PADDINGTGET_SCALE_ADDRfrom tile-instruction docs into the micro-instruction docs.
Temporarily remove from tile docs
Until the micro-instruction placement is complete, remove these ops from tile-instruction taxonomies and tile-family summaries so the tile docs remain semantically clean.
Affected documentation areas
At minimum, review and update:
docs/isa/instruction-surfaces/tile-instructions*.mddocs/isa/instruction-families/tile-families*.mddocs/isa/instruction-surfaces/README*.mddocs/assembly/PTO-AS*.mddocs/mkdocs/src/manual/07-instructions*.mddocs/isa/manifest.yamldocs/isa/scalar/ops/micro-instruction/Acceptance criteria
T*name automatically belongs to the tile surface.docs/isa/manifest.yamland generated family/index pages reflect the new classification.git diff --checkpasses.Notes
This issue is intentionally limited to these four operations. A broader semantic cleanup of the
T*namespace may still be needed later, but that should be tracked separately.