Cross-platform documentation

Jacob Carlborg via Digitalmars-d digitalmars-d at puremagic.com
Tue May 31 00:12:06 PDT 2016


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

-- 
/Jacob Carlborg


More information about the Digitalmars-d mailing list