www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - Documentation of std.math: FloatingPointControl

The enum members of FloatingPointControl are not documented individually at 
http://dlang.org/phobos/std_math.html and I would like to submit a PR for 
that. In connection with this, a few queries:

I note that there are already a few sparse ddoc comments such as at: 
https://github.com/D-Programming-Language/phobos/blob/master/std/math.d#L4539
but they do not seem to be 
reflected in the generated documentation, presumably because they do not 
directly precede a symbol definition. This needs to be fixed. I propose to 
move it before the struct itself.

Finally I am looking at the enum value subnormalException at 
https://github.com/D-Programming-Language/phobos/blob/master/std/math.d#L4580
which seems to be enabled in 
architectures other than PPC. The standard seems to define only 5 
exceptions: 
https://en.wikipedia.org/wiki/IEEE_floating_point#Exception_handling. So 
it's not clear what subnormalException refers to. Is it the "denormal 
operand exception" mentioned at 
https://docs.oracle.com/cd/E19957-01/806-3568/ncg_handle.html?

Thanks.

-- 

Dec 10 2015