nim doc ignores doc comment

[GULPF]

nim doc doesn't find the doc comment for this proc:

proc foo*(x: int8): int =
  ## Doc comment
  x

It appears to be caused by a combination of the implicit int8->int conversion and the implicit return value, as changing either of these makes the issue disappear.

This causes some doc comments to disappear in the stdlib docs, here for example: https://nim-lang.github.io/Nim/times.html#nanoseconds%2CDuration

[narimiran]

Maybe it is related, so I'm posting it here:

From options.nim:

type
  Option*[T] = object
    ## An optional type that stores its value and state separately in a boolean.
    when T is SomePointer:
      val: T
    else:
      val: T
      has: bool

Doc produced:

Option[T] = object
  when T is SomePointer:
    val
  else:
      val
      has

  

(yes, with some empty lines at the bottom, and wrong indentation of else branch)

See here

[nc-x]

@narimiran
There is an issue open for that -> #9899