[Issue 17849] Documentation of align is incorrect

[d-bugmail at puremagic.com]

https://issues.dlang.org/show_bug.cgi?id=17849

--- Comment #2 from Peter Varo <hello at petervaro.com> ---
My confusion was coming from the fact, that the 'lexical' page is referencing
the 'iasm' when introducing the 'align' keyword.
(https://github.com/dlang/dlang.org/blob/master/spec/lex.dd#L942)

I think the fact alone, that we have a keyword that can be used in two ways,
yet the documentation fails to connect those two explaining the difference
between these scenarios is confusing, not to mention how hard it is to
follow/understand this for a new comer, who has no idea that D has a "built-in
mini-language" and the official documentation they are following is pointing at
the "lesser used feature"...

So I agree, the bug I reported is invalid, but the above case related to this
one is still something that needs attention IMO.

--