Also make sure each line is less than 100 chars wide. And place the starting of the paragraph on the 2nd line, e.g.

```scala
/**
 * Iterable whose iterator iterates...
 */
```