Hacker News Reader

Seems pretty similar to nodiscard in C++17 and previously, GCC attribute warn_unused_result.

https://en.cppreference.com/w/cpp/language/attributes/nodisc...

https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attribute...

Oof, seems I got the camelcase wrong. It's `@mustuse`

Working on updating that.

I think the reason the documentation is cryptic is because it's a library-supplied User Data Attribute that is specially recognized by the compiler. The documentation generator is having trouble with it. In code it's pretty simple:

https://github.com/dlang/druntime/blob/705fb36e5fc4d930eed85...

Cryptic in what way?

I can fix it but the example given is clear, no?

I think the example is very clear.

I've always wondered if the Dlang docs are intentionally kept vague and cryptic.

Probably not. The ones creating the docs probably have a deep understanding of the language and can no longer see what information people need to understand the issue at hand.

It is definitely unintentional. It's called the curse of knowledge.