🎨 style(syntax): normalize naming conventions

Align all TSL syntax documentation examples with docs/tsl/naming.md:

- Classes/types: PascalCase, drop Hungarian prefix (THuman→Human)
- Parameters/locals: snake_case with meaningful names (isLeft→is_left, maxb→max_b)
- Private members: snake_case_ with trailing underscore (real_part_, imaginary_part_)
- Public members: PascalCase (value→Value)
- Top-level functions: PascalCase (test→Test)
- Module constants: kPascalCase (kernel_dll→kKernelDll)

Affected: 01-24 syntax docs (23 files)
Verified: 150+ code blocks locally tested, output unchanged
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
csh
2026-07-07 16:34:19 +08:00
co-authored by Claude Fable 5
parent 23c35fdfda
commit 014c23d386
23 changed files with 2009 additions and 352 deletions
@@ -170,6 +170,30 @@ writeLn(1);
- 输出 `1`
- 说明未命中的条件编译分支不会参与脚本编译
### `{$CompileOption}` 编译选项
`{$CompileOption}` 用于设置编译期开关,改变编译器的默认行为:
代码块身份:可直接照写示例
```tsl
{$CompileOption optimize=1}
echo 1 + 1;
```
代码块身份:输出片段
```text
2
```
说明:
- `{$CompileOption optimize=1}` 开启优化
- 编译选项从出现位置开始生效,直到源文件结束或被其他选项覆盖
- 常见选项包括 `optimize``buffermode``DebugInfo`
- 编译选项细节以项目工具链和实际编译命令为准。
### 参数默认传递开关
`{$varByRef-}``{$varByRef+}`
@@ -190,23 +214,23 @@ r := 1;
TouchRestored(r);
writeLn(r);
function TouchDefault(a);
function TouchDefault(value);
begin
a := 9;
value := 9;
end;
{$varByRef-}
function TouchValue(a);
function TouchValue(value);
begin
a := 8;
value := 8;
end;
function TouchForcedVar(var a);
function TouchForcedVar(var value);
begin
a := 7;
value := 7;
end;
{$varByRef+}
function TouchRestored(a);
function TouchRestored(value);
begin
a := 6;
value := 6;
end;
```