www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 17849] New: Documentation of align is incorrect


          Issue ID: 17849
           Summary: Documentation of align is incorrect
           Product: D
           Version: D2
          Hardware: x86
                OS: Linux
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: dlang.org
          Assignee: nobody puremagic.com
          Reporter: hello petervaro.com

The documentation of the https://dlang.org/spec/iasm.html#align keyword is
incorrect. It is suggesting here:
https://github.com/dlang/dlang.org/blob/master/spec/iasm.dd#L74, that this
should be the correct way of using it:

struct S
    align 64 ubyte b;

instead of the one, that can actually be compiled:

struct S
    align(64) ubyte b;

Therefore further action is required:

- If the documented usage is the desired one, then this is a different issue,
and that behaviour needs to be implemented.

- If the keyword requires parenthesis, then the documentation should be updated
according to that.

Sep 22 2017