playbook/docs/tsl/syntax/coverage_map.md

40 lines
3.9 KiB
Markdown

# Coverage Map
文档类型:检索页
是否可直接用于生成代码:否
是否含已验证可执行示例:否
是否含已验证反例:否
遇到不确定时跳转到:[index.md](index.md)(优先)、[02_quickstart.md](02_quickstart.md)、[12_pitfalls.md](12_pitfalls.md)
这一页只回答一个问题:旧 8 章语法手册里的语言章节,现在在新的正式语法手册里分别落到哪里。
## 怎么使用这页
- 想系统读手册,先按 `01``16` 主线走。
- 想补齐深水专题,再按需进入 `18``32`
- 想知道旧书某一章今天应该拆到哪里看,直接查下面的映射表。
## 8 章吸收总表
| 旧章节 | 主线页 | 专题页 | 说明 |
| --- | --- | --- | --- |
| `01_language_basics.md` | [01_introduction.md](01_introduction.md), [03_core_model.md](03_core_model.md), [04_values_and_literals.md](04_values_and_literals.md), [05_variables_and_constants.md](05_variables_and_constants.md), [07_expressions_and_operators.md](07_expressions_and_operators.md), [11_runtime_context_and_with.md](11_runtime_context_and_with.md), [13_matrix_and_collections.md](13_matrix_and_collections.md) | [18_lexical_structure_and_compile_options.md](18_lexical_structure_and_compile_options.md), [19_types_and_conversions.md](19_types_and_conversions.md), [20_strings_and_text.md](20_strings_and_text.md) | 语言基础主干在主线,词法 / 类型 / 字符串边界放进深水专题 |
| `02_control_flow.md` | [08_control_flow.md](08_control_flow.md) | [16_debug_and_profiler.md](16_debug_and_profiler.md) | 控制流在主线,调试与 profiler 单列专题 |
| `03_functions.md` | [06_functions_and_calls.md](06_functions_and_calls.md) | [21_external_calls_and_threads.md](21_external_calls_and_threads.md) | 普通函数在主线,`external` / 动态库 / 线程放进专题 |
| `04_modules_and_namespace.md` | [10_units_and_scope.md](10_units_and_scope.md) | [22_namespace_libpath_and_unit_runtime.md](22_namespace_libpath_and_unit_runtime.md) | `unit` / `uses` 在主线,运行时查找路径与 `Libpath` 放进专题 |
| `05_object_model.md` | [09_objects_and_classes.md](09_objects_and_classes.md) | [23_object_runtime_and_introspection.md](23_object_runtime_and_introspection.md), [24_builtin_runtime_objects.md](24_builtin_runtime_objects.md), [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md) | 类基础语法在主线,运行时 / 内置对象 / 重载能力拆到专题 |
| `06_extended_syntax.md` | [13_matrix_and_collections.md](13_matrix_and_collections.md), [14_resultset_and_filters.md](14_resultset_and_filters.md), [15_ts_sql.md](15_ts_sql.md) | [25_set_operations.md](25_set_operations.md), [26_matrix_deep_dive.md](26_matrix_deep_dive.md), [27_fmarray.md](27_fmarray.md), [28_ts_sql_core.md](28_ts_sql_core.md), [29_ts_sql_advanced.md](29_ts_sql_advanced.md) | 主线先建立数组 / 结果集 / TS-SQL 入口,集合 / 矩阵 / FMArray / TS-SQL 深水内容进入专题 |
| `07_debug_and_profiler.md` | [16_debug_and_profiler.md](16_debug_and_profiler.md) | [30_runtime_services_and_global_cache.md](30_runtime_services_and_global_cache.md) | 调试入口在主线,运行时服务与全局缓存单列专题 |
| `08_new_generation.md` | [07_expressions_and_operators.md](07_expressions_and_operators.md), [09_objects_and_classes.md](09_objects_and_classes.md) | [31_complex_and_weakref.md](31_complex_and_weakref.md), [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md) | 较新语法相关内容已分散吸收到表达式 / 对象主线,复数 / 弱引用 / 对象重载保留在专题 |
## 读取原则
- 新 session 不需要再回旧 8 章语法手册建立语言主干。
- `01``16` 负责从介绍到进阶的顺序阅读。
- `18``32` 负责把旧 8 章里剩余的深水内容补齐。
- 当前正式手册没有 `17_xxx.md`;主线是 `01-16`,深水专题是 `18-32`
## 跳转
- 回到语法入口:见 [index.md](index.md)