从另一个文件中的另一个方法显示文档

Question

是否有可能在驻留在不同文件中的另一个函数的文档中显示一个函数的文档?宏只在它们自己的文件中有效。

在Flutter源代码中，他们使用了这样的东西，但它似乎没有任何效果:

/// {@macro flutter.widgets.editableText.keyboardType}

Answer 1

宏文档就是你要找的。它们在这里已经解释过了，但总的来说，可以让你做你想做的事情:把文档从一个地方复制到另一个地方，而不需要重写。

Answer 2

最好是链接到所引用的函数。

file_a.dart

/// Also see [functionB].
void functionA() {}

file_b.dart

/// Another function.
void functionB() {}

https://dart.dev/guides/language/language-tour文档注释