[200_61] 更新 README 文档,移除 Scala data pipeline 相关内容#662
Conversation
- 移除 Scala-like functional collection 特性描述 - 移除 Functional Data Pipeline 示例代码和 case class 示例 - 移除 (liii lang) 相关内容和 Unicode Support 示例 - 移除 Scala-like collections 表格 - 移除 GNU/Linux 安装说明 - 更新模式选项,移除 (liii oop) 预加载 - 新增 (liii http) 和 (liii json) 标准库介绍 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Greptile Summary本 PR 主要清理已弃用的 Scala data pipeline 相关内容(包括
Confidence Score: 2/5PR contains an undocumented breaking behavioral change in script execution default mode; not safe to merge without addressing. Two logic-level issues were found: the
Important Files Changed
Flowchart%%{init: {'theme': 'neutral'}}%%
flowchart TD
A[gf command invoked] --> B{parse_startup_cli_options}
B --> C{command type?}
C -- "repl / load" --> D[default_mode = liii]
C -- "eval / run / script" --> E[default_mode = r7rs\n⚠️ Changed from 'default']
D --> F[parse_mode_option with default=liii]
E --> G[parse_mode_option with default=r7rs]
F --> H{-m flag present?}
G --> H
H -- yes --> I[use specified mode]
H -- no --> J[use default_mode]
I --> K[customize_goldfish_by_mode]
J --> K
K -- "liii / default" --> L["import (liii base)\n(liii error)\n(liii string)"]
K -- "scheme" --> M["import (liii base)\n(liii error)"]
K -- "r7rs" --> N["import (scheme base)"]
K -- "sicp" --> O["import (scheme base)\n(srfi sicp)"]
Reviews (1): Last reviewed commit: "[200_61] 更新 README 文档,移除 Scala data pipe..." | Re-trigger Greptile |
| @@ -232,7 +162,7 @@ You can also load and evaluate a Scheme file directly: | |||
| `-m` or `--mode` helps you specify the standard library mode: | |||
There was a problem hiding this comment.
README 描述 liii 模式仅预加载 (liii base) 和 (liii error),但 src/goldfish.hpp 中 customize_goldfish_by_mode(第 4104–4105 行)的实际代码为:
s7_eval_c_string (sc, "(import (liii base) (liii error) (liii string))");新增的 REPL 欢迎消息(第 4554 行)也已正确反映了这三个库,但 README 的说明遗漏了 (liii string)。
建议修正为:
| `-m` or `--mode` helps you specify the standard library mode: | |
| + `liii`: Goldfish Scheme with `(liii base)`, `(liii error)` and `(liii string)` |
| @@ -238,7 +167,7 @@ based on S7 Scheme 11.5 (22-Sep-2025) | |||
| `-m` 或 `--mode` 帮助您指定标准库模式: | |||
There was a problem hiding this comment.
| // 根据命令类型确定默认模式: | ||
| // - repl/load 命令默认使用 liii 模式 | ||
| // - 其他命令(eval, run, 直接执行脚本)默认使用 r7rs 模式 | ||
| string default_mode= "r7rs"; | ||
| if (command == "repl" || command == "load") { | ||
| default_mode= "liii"; | ||
| } | ||
| string mode= parse_mode_option (argc, argv, default_mode); |
There was a problem hiding this comment.
此更改将 eval/run/直接执行脚本命令的默认模式从 "default"(等价于 liii,会预加载 (liii base) (liii error) (liii string))改为 "r7rs"(仅预加载 (scheme base))。
之前依赖默认模式运行的脚本(如使用 gf run script.scm,脚本内使用了 (liii base) 中的 ==、display* 等函数)将无法找到这些绑定,可能在运行时直接报错。
此外,README 中仍描述 default: -m default is the equiv of -m liii,但对于脚本命令,新的实际默认值已是 r7rs,文档与行为不符,需要同步更新。
如这是有意为之的设计决策,建议:
- 在 README 中明确记录此行为差异(REPL 和
load默认使用liii,脚本执行默认使用r7rs) - 评估是否会对现有用户脚本造成破坏性影响
- README.md: 新增 AI Coding friendly 特性 - README_ZH.md: 新增 AI 编程友好 特性 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- 命令行示例统一使用 gf 而非 bin/gf - 添加说明:手动编译可在 bin/gf 找到可执行文件 - 移除 Demo Code 部分 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- AI Coding friendly 简化描述 - default 模式改为等价于 r7rs Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
摘要
更新 README.md 和 README_ZH.md,移除已弃用的 Scala data pipeline 相关内容,并新增标准库介绍。
变更内容
移除 Scala data pipeline 相关内容
移除 (liii lang) 相关内容
(liii lang))(liii lang)行简化安装说明
更新模式选项
(liii oop)预加载项liii模式现在只预加载(liii base)和(liii error)新增标准库
(liii http):HTTP 客户端库(liii json):JSON 解析和操作库开发文档
详见
devel/200_61.md🤖 Generated with Claude Code