LaTeX3 box模块中尺寸参数类型的文档修正

在LaTeX3的box模块中，\box_scale:Nnn函数的文档描述存在一个参数类型错误。该函数实际上接受浮点表达式作为参数，但文档中错误地描述为整数表达式。

问题分析

\box_scale:Nnn函数用于对盒子内容进行缩放操作，其实现代码明确使用了浮点变量来存储缩放因子：

\cs_new_protected:Npn \__box_scale:NnnN #1#2#3#4
  {
    #4 #1
      {
        \fp_set:Nn \l__box_scale_x_fp {#2}
        \fp_set:Nn \l__box_scale_y_fp {#3}
        \__box_scale:N #1
      }
  }

从实现可以看出，该函数接受两个浮点表达式作为水平和垂直缩放因子，而不是文档中描述的整数表达式。

相关函数的一致性检查

在检查box模块的其他相关函数时，我们发现：

1. 缩放相关函数：如\box_resize_to_wd:Nn等确实需要维度参数
2. 自动调整大小函数：如\box_autosize_to_wd_and_ht:Nnn接受浮点表达式
3. 旋转函数：\box_rotate:Nn也接受浮点表达式作为旋转角度

这种参数类型的差异反映了不同函数的设计意图：直接尺寸调整通常需要明确的维度值，而涉及比例变换或角度变换的操作则更适合使用浮点表达式。

技术影响

对于LaTeX3用户来说，理解参数类型的正确性非常重要：

1. 浮点表达式允许更灵活的数学运算，如sin(30)或pi/2
2. 维度表达式则需要明确单位，如10pt或5cm
3. 错误使用参数类型会导致编译错误或不预期的结果

最佳实践建议

在使用LaTeX3的box模块时，建议：

1. 仔细查阅函数文档，确认参数类型要求
2. 对于需要浮点参数的函数，可以利用LaTeX3的浮点运算功能
3. 当需要明确尺寸时，使用维度表达式并确保包含单位
4. 在不确定时，可以通过\dim_eval:n或\fp_eval:n进行显式转换

结论

本次文档修正确保了LaTeX3接口文档的准确性，帮助用户正确理解和使用box模块的缩放功能。作为LaTeX3用户，理解不同函数对参数类型的要求是编写健壮代码的重要基础。