I woul like to reference method's parameters in the documentation text,
 but have no idea how to do it.  

In .NET world we use tag [paramref](https://learn.microsoft.com/en-us/dotnet/csharp/programming-guide/xmldoc/paramref)  

Just as an example:

```
/** Send email with the specified @paramref body to the addesses given in @paramref to.
@param body Just a plain text or teamplate-aware text.*/ 
def SendEmail(body: EmailBody, to: EmailAddress*) = ???

```

How is it done in Scala?