[Issue 17849] Documentation of align is incorrect

2017-09-22 Thread d-bugmail--- via Digitalmars-d-bugs
https://issues.dlang.org/show_bug.cgi?id=17849

--- Comment #2 from Peter Varo  ---
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.

--


[Issue 17849] Documentation of align is incorrect

2017-09-22 Thread d-bugmail--- via Digitalmars-d-bugs
https://issues.dlang.org/show_bug.cgi?id=17849

ag0ae...@gmail.com changed:

   What|Removed |Added

 Status|NEW |RESOLVED
 CC||ag0ae...@gmail.com
 Resolution|--- |INVALID

--- Comment #1 from ag0ae...@gmail.com ---
The iasm.html page is only about asm blocks. In an asm block, `align 64;` is
correct.

The documentation for the align attribute is here:
https://dlang.org/spec/attribute.html#align

Closing as invalid.

--