弱类型语言的 API 文档，这种情况怎么写？

[cheneydog]

因为通常用中括号表示某个参数是可选的：

```
bus.error([eventname],callback)
```

但是又想用用括号表示参数应该是数组的。


```
bus.line([e1,e2,[e3,...]])

```

于是导致混淆，这种情况通常是怎么区分的？

[tabris17]

参考 PHP 文档 http://php.net/manual/zh/function.next.php

[InkStone]

参数是数组你就在下面的参数详解当中注明呀

或者你想表达的意思是可变参数列表? 那就是 foobar(arg1, arg2, arg3...) 或者干脆 foobar(*args)

[msg7086]

别用中括号表示可选呗。
别的语言里一般是用默认值来表示可选项的，比如
bus.error(eventname = 'Nothing', callback)
这种。

[heliumhgy]

这叫动态类型吧