DIAG: add haddock comment