On Tuesday, 31 May 2016 at 07:12:06 UTC, Jacob Carlborg wrote:
Currently the documentation for Phobos and druntime is
generated on (I'm guessing) Linux. This can sometimes cause
problems when platform specific declarations are removed due to
them not being available on Linux. Sometimes it looks even
worse when none of the declarations are available on Linux [1].
How feasible would it be to generate cross-platform
documentation by generating the docs on all platforms. For a
given module, diff the all versions generated by the different
platforms. If there's a difference, generate a button for each
version. The button will show the documentation for that
particular platform.
[1] http://dlang.org/phobos/core_attribute.html
I just ran into this yesterday wondering why the official
documentation doesn't list any of the Windows stuff, then it hit
me. It's definitely annoying.
