[Mlir-commits] [mlir] d7bf2bf - [NFC][mlir][ptr] Clarify pointer dialect semantics (#158484)

[llvmlistbot at llvm.org]

Author: Fabian Mora
Date: 2025-09-14T16:57:43Z
New Revision: d7bf2bf85f84977e4504322b61af3d5def211c51

URL: https://github.com/llvm/llvm-project/commit/d7bf2bf85f84977e4504322b61af3d5def211c51
DIFF: https://github.com/llvm/llvm-project/commit/d7bf2bf85f84977e4504322b61af3d5def211c51.diff

LOG: [NFC][mlir][ptr] Clarify pointer dialect semantics (#158484)

This patch adds the following description to the pointer dialect:
```
    The pointer dialect provides types and operations for representing and
    interacting with pointer values in MLIR, such as loading and storing values
    from/to memory addresses.

    The dialect's main type is an opaque pointer (`ptr`) that can be
    parameterized by a memory space. This type represents a handle to an object
    in memory, or target-dependent values like `nullptr`. Further, the dialect
    assumes that the minimum addressable unit by a pointer is a byte. However,
    the dialect does not make assumptions about the size of a byte, which is
    considered a target-specific property.
```

Added: 
    

Modified: 
    mlir/include/mlir/Dialect/Ptr/IR/PtrDialect.td

Removed: 
    


################################################################################
diff  --git a/mlir/include/mlir/Dialect/Ptr/IR/PtrDialect.td b/mlir/include/mlir/Dialect/Ptr/IR/PtrDialect.td
index 7407d74ce3a87..c98df5775195a 100644
--- a/mlir/include/mlir/Dialect/Ptr/IR/PtrDialect.td
+++ b/mlir/include/mlir/Dialect/Ptr/IR/PtrDialect.td
@@ -21,6 +21,18 @@ include "mlir/IR/OpBase.td"
 def Ptr_Dialect : Dialect {
   let name = "ptr";
   let summary = "Pointer dialect";
+  let description = [{
+    The pointer dialect provides types and operations for representing and
+    interacting with pointer values in MLIR, such as loading and storing values
+    from/to memory addresses.
+
+    The dialect's main type is an opaque pointer (`ptr`) that can be
+    parameterized by a memory space. This type represents a handle to an object
+    in memory, or target-dependent values like `nullptr`. Further, the dialect
+    assumes that the minimum addressable unit by a pointer is a byte. However,
+    the dialect does not make assumptions about the size of a byte, which is
+    considered a target-specific property.
+  }];
   let cppNamespace = "::mlir::ptr";
   let useDefaultTypePrinterParser = 1;
   let useDefaultAttributePrinterParser = 1;