From e1ed7ffd9ffd0e16ea1c4770f8301d71d8caacba Mon Sep 17 00:00:00 2001
From: git <593+git@user.noreply.gitee.com>
Date: Wed, 6 Aug 2025 02:08:47 +0000
Subject: [PATCH 1/2] update src/backend/Assembly.zig.

Signed-off-by: git <593+git@user.noreply.gitee.com>
---
 src/backend/Assembly.zig | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/backend/Assembly.zig b/src/backend/Assembly.zig
index ec9d671..914bffb 100644
--- a/src/backend/Assembly.zig
+++ b/src/backend/Assembly.zig
@@ -11,7 +11,7 @@ pub fn deinit(self: *const Assembly, gpa: Allocator) void {
     gpa.free(self.text);
 }
 
-pub fn writeToFile(self: Assembly, file: std.fs.File) !void {
+pub fn writeToAllFile(self: Assembly, file: std.fs.File) !void {
     var vec: [2]std.posix.iovec_const = .{
         .{ .base = self.data.ptr, .len = self.data.len },
         .{ .base = self.text.ptr, .len = self.text.len },
-- 
Gitee


From 5aa15d55c85e93177d6351437641e8785d59b42a Mon Sep 17 00:00:00 2001
From: OpenCode Bot <bot@opencode.ai>
Date: Wed, 21 Jan 2026 07:35:42 +0000
Subject: [PATCH 2/2] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20Assembly.zig?=
 =?UTF-8?q?=20=E6=96=87=E6=A1=A3=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 为 deinit 函数添加文档注释
- 为 writeToAllFile 函数添加文档注释
---
 src/backend/Assembly.zig | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/src/backend/Assembly.zig b/src/backend/Assembly.zig
index 914bffb..33065af 100644
--- a/src/backend/Assembly.zig
+++ b/src/backend/Assembly.zig
@@ -6,11 +6,29 @@ text: []const u8,
 
 const Assembly = @This();
 
+/// 释放 Assembly 结构体占用的内存资源
+///
+/// 释放由 Assembly 结构体持有的 data 和 text 字段所占用的内存
+///
+/// Parameters:
+///   - self: 指向 Assembly 结构体的常量指针
+///   - gpa: 通用分配器，用于释放内存
 pub fn deinit(self: *const Assembly, gpa: Allocator) void {
     gpa.free(self.data);
     gpa.free(self.text);
 }
 
+/// 将 Assembly 的 data 和 text 字段写入到指定文件
+///
+/// 使用 scatter-gather I/O 方式同时写入 data 和 text 数据到文件
+///
+/// Parameters:
+///   - self: Assembly 结构体的值
+///   - file: 目标文件句柄
+///
+/// Returns:
+///   - void: 成功时返回
+///   - error: 文件写入错误时返回相应的错误码
 pub fn writeToAllFile(self: Assembly, file: std.fs.File) !void {
     var vec: [2]std.posix.iovec_const = .{
         .{ .base = self.data.ptr, .len = self.data.len },
-- 
Gitee