README.md doesn't describe how pdd handles multi lines comments

[php-coder]

The example on README.md seems outdated:

/**
 * @todo #234:15m/DEV This is something to do later
 *  in one of the next releases. I can't figure out
 *  how to implement it now, that's why the puzzle.
 */
void sendEmail() {
  throw new UnsupportedOperationException();
}

while it works, pdd doesn't require a leading space on the next paragraphs, so the following also works:

/**
 * @todo #234:15m/DEV This is something to do later
 * in one of the next releases. I can't figure out
 * how to implement it now, that's why the puzzle.
 */
void sendEmail() {
  throw new UnsupportedOperationException();
}

It would be nice:

1. update the example to remove a leading space as it isn't required anymore
2. describe pdd logic of handling multilines comments
3. provide an example of mixing a @todo comment and non-pdd comment