docs: 更新更新说明 #279
Merged
docs: 更新更新说明 #279
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
course/update/0.15.1-description.md
Outdated
| ## 系统最低版本要求 | ||
|
|
||
| ### aarch64 后端开发进展 | ||
| | 操作系统（Operating System） | 最低版本要求 （Minimum Version） | |
There was a problem hiding this comment.
🚫 [AutoCorrect Lint] <AutoCorrect> reported by reviewdog 🐶
Suggested change
| | 操作系统（Operating System） | 最低版本要求 （Minimum Version） | | |
| | 操作系统（Operating System） | 最低版本要求（Minimum Version） | |
course/update/0.15.1-description.md
Outdated
| }; | ||
| ``` | ||
|
|
||
| 替代写法基于前述的命名空间思想：其实**恰当的命名空间划分是好事**。Mixins 也可以用命名空间来组织。比如把 `incrementCounter` 和 `resetCounter` 名称中的 “counter” 前缀直接变成一个嵌套字段，这样 `foo.counter.increment()` 替代 `foo.incrementCounter()`，语义更直观。 |
There was a problem hiding this comment.
🚫 [AutoCorrect Lint] <AutoCorrect> reported by reviewdog 🐶
Suggested change
| 替代写法基于前述的命名空间思想：其实**恰当的命名空间划分是好事**。Mixins 也可以用命名空间来组织。比如把 `incrementCounter` 和 `resetCounter` 名称中的 “counter” 前缀直接变成一个嵌套字段，这样 `foo.counter.increment()` 替代 `foo.incrementCounter()`，语义更直观。 | |
| 替代写法基于前述的命名空间思想：其实**恰当的命名空间划分是好事*名称中的“counter”前缀直接变成一个嵌套字段，这样er` 和 `resetCounter` 名称中的 “counter” 前缀直接变成一个嵌套字段，这样 `foo.counter.increment()` 替代 `foo.incrementCounter()`，语义更直观。 |
course/update/0.15.1-description.md
Outdated
| }; | ||
| ``` | ||
|
|
||
| 这样写后，调用就是 `foo.counter.increment()`，不再是 `foo.incrementCounter()`。通过零位字段成功将 mixin “命名空间化”。 |
There was a problem hiding this comment.
🚫 [AutoCorrect Lint] <AutoCorrect> reported by reviewdog 🐶
Suggested change
| 这样写后，调用就是 `foo.counter.increment()`，不再是 `foo.incrementCounter()`。通过零位字段成功将 mixin “命名空间化”。 | |
| 这样写后，调用就是 `foo.counter.increment()`，不再��。通过零位字段成功将 mixin“命名空间化”。n “命名空间化”。 |
course/update/0.15.1-description.md
Outdated
| Web 界面本身主要显示所有构建步骤及其状态，同时有按钮可手动触发重新构建（所以可以作为 `zig build --watch` 流程的替代方式）。如果使用 `--fuzz`，则会暴露 [Fuzzer](https://ziglang.org/download/0.15.1/release-notes.html#Fuzzer) 相关界面，其内容与 0.14.0 基本一致。 | ||
| ### 环形缓冲区 | ||
| 此外，Web 界面新增了 “时间报告” 功能。只需为 `zig build` 传递 `--time-report`，即可在 Web 界面上展开查看构建图中各步骤的耗时信息。尤其是每个 `std.Build.Step.Compile`，都会有详细的子阶段统计：Zig 编译器各部分的快慢情况，以及哪些文件/声明在语义分析、生成机器码、链接阶段消耗的时间最多。 |
There was a problem hiding this comment.
🚫 [AutoCorrect Lint] <AutoCorrect> reported by reviewdog 🐶
Suggested change
| 此外，Web 界面新增了 “时间报告” 功能。只需为 `zig build` 传递 `--time-report`，即可在 Web 界面上展开查看构建图中各步骤的耗时信息。尤其是每个 `std.Build.Step.Compile`，都会有详细的子阶段统计：Zig 编译器各部分的快慢情况，以及哪些文件/声明在语义分析、生成机器码、链接阶段消耗的时间最多。 | |
| 此外，Web 界面新增了“时间报告”功能。只需为 `zig build` 传递 `--time-report`，即可在 Web 界面上展开查看构建图中各步骤的耗时信息。尤其是每个 `std.Build.Step.Compile`，都会有详细的子阶段统计：Zig 编译器各部分的快慢情况，以及哪些文件/声明在语义分析、生成机器码、链接阶段消耗的时间最多。 |
course/update/0.15.1-description.md
Outdated
| 启用自实现 x86_64 后端后，你将可以直接感受到 Zig 项目过去几年投入的成果：编译速度显著提升——大多数场景下比 LLVM 快了大约 5 倍。**而这还只是开始**；自实现 x86_64 后端是专为 [增量编译](https://ziglang.org/download/0.15.1/release-notes.html#Incremental-Compilation) 而设计的，这项功能足够稳定时，预计还会有极大加速。极致的编译速度一直是 Zig 项目的核心目标之一，我们已经默默推进多年，这次发布是阶段性成果的集中体现。 | ||
| ### Web 界面和时间报告 | ||
| 使用自实现 x86 后端，还能避免受上游 LLVM Bug 的影响（目前我们[正在跟踪 60 多个相关 Bug](https://github.com/ziglang/zig/issues?q=is%3Aissue%20state%3Aopen%20label%3Abackend-llvm%20label%3Aupstream)）。事实上，自实现 x86 后端在我们的 “行为测试集” 上，已能通过比 LLVM 后端更多的用例（1984/2008，相比 LLVM 的 1977/2008）。换句话说，该后端对 Zig 语言的实现更为完整和准确。 |
There was a problem hiding this comment.
🚫 [AutoCorrect Lint] <AutoCorrect> reported by reviewdog 🐶
Suggested change
| 使用自实现 x86 后端，还能避免受上游 LLVM Bug 的影响（目前我们[正在跟踪 60 多个相关 Bug](https://github.com/ziglang/zig/issues?q=is%3Aissue%20state%3Aopen%20label%3Abackend-llvm%20label%3Aupstream)）。事实上，自实现 x86 后端在我们的 “行为测试集” 上，已能通过比 LLVM 后端更多的用例（1984/2008，相比 LLVM 的 1977/2008）。换句话说，该后端对 Zig 语言的实现更为完整和准确。 | |
| 使用自实现 x86 后端，还能避免受上游 LLVM Bug 的影响（目前我们[正在跟踪 60 多个相关 Bug](https://github.com/ziglang/zig/issues?q=is%3Ai）。事实上，自实现 x86 后端在我们的“行为测试集”上，已能通过比 LLVM 后端更多的用例（1984/2008，相比 LLVM 的 1977/2008）。换句话说，该后端对 Zig 语言的实现更为完整和准确。说，该后端对 Zig 语言的实现更为完整和准确。 |
- 修改 `index.md` 和 `prologue.md` 中的封面图片路径，确保正确引用 - 在侧边栏中新增 Zig 0.15.1 升级指南和版本说明链接 - 更新 `0.15.1-description.md` 中的版本发布日期和相关内容，确保信息准确性
- 调整系统版本要求表格的对齐和间距 - 修正中文排版中不规范的空格和标点符号 - 统一嵌套列表项的缩进格式（4空格改为2空格） - 修复 Markdown 语法转义和标记符号 - 移除文档中的尾部空白和多余空行
- 新增工具链（Toolchain）章节，包括 LLVM 20、FreeBSD/NetBSD 交叉编译支持、glibc 2.42 等内容 - 新增路线图（Roadmap）章节，说明 0.16.0 版本的核心主题和重要里程碑 - 调整"本版本仍然存在已知缺陷"的标题级别从 h2 改为 h3
- 调整表头分隔符的长度 - 统一系统最低版本要求列各单元格的间距 - 改善表格的 Markdown 渲染一致性
- 移除临时的构建错误和输出日志 - 清理不必要的调试文件 - 简化项目文件结构
- 移除 0.15.1-description.md 中的冗余内容和重复说明 - 优化升级指南的章节组织和层级结构 - 简化示例代码并统一格式风格 - 提高文档的可读性和易用性
- 移除 usingnamespace 关键字的详细说明 - 删除相关的代码示例和使用演示 - 移除关于概念学习困难的提示说明
jinzhongjia
force-pushed
the
update/fix-0.15.1
branch
from
7f9a158 to
03f6d21
Compare
- 移除全局作用域中的 std 模块导入 - 在 One、Two、Three 结构体内部分别添加 std 导入 - 改进代码作用域和模块化组织
- 将线程安全内容拆分为多个独立段落 - 分离问题定义、解决方案和建议 - 提高文档的清晰度和可读性
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
index.md和prologue.md中的封面图片路径，确保正确引用0.15.1-description.md中的版本发布日期和相关内容，确保信息准确性