Python 为什么不用 doxygen 这种清晰明了的注释风格？

[SimbaPeng]

python 的注释:
def round(number, ndigits=None): # real signature unknown; restored from __doc__
"""
round(number[, ndigits]) -> number

Round a number to a given precision in decimal digits (default 0 digits).
This returns an int when called with one argument, otherwise the
same type as the number. ndigits may be negative.
"""
return 0

doxygen:
/**
* Checks if value is a member of the set stored at the key key.
*
* @param string $key
* @param string $value
* @return bool TRUE if value is a member of the set at key key, FALSE otherwise.
* @link http://redis.io/commands/sismember
* @example
* <pre>
* $redis->sAdd('key1' , 'set1');
* $redis->sAdd('key1' , 'set2');
* $redis->sAdd('key1' , 'set3'); // 'key1' => {'set1', 'set2', 'set3'}
*
* $redis->sIsMember('key1', 'set1'); // TRUE
* $redis->sIsMember('key1', 'setX'); // FALSE
* </pre>
*/

我感觉 doxygen 的注释风格非常清晰明了，一眼就看出参数类型，返回值类型。而 python 的注释却是使用大量文字来解释，而且没有一个规定的排版。这是为什么？

[NathanHu]

不同语言有不同注释，习惯就好，就算你知道了为什么也无法改变它，只能适应它。

[srlp]

楼主这是引战啊，明显是历史原因嘛。

另外，你想要的格式也是有的，numpy doc format：

[srlp]

https://github.com/numpy/numpy/blob/master/numpy/core/records.py#L83

[srlp]

呃，被称为 numpydoc： https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt