Apologies if this is a "generic D" question, but I can't find an answer
in any of the D documentation, and folks on this list are quite helpful.
The precompiled-library-and-header paradigm is very common in C. Is
there a similar one in D? I've used wxd, which is a port of wxWidgets to
D, and it builds a static .a library, which gets you half there, but
there is no equivalent header file that gets included - just the wx.d
file. Basically, if I'm linking against a D library, from where does the
user-readable documentation for that library come? Is it incumbent upon
the provider to provide Doxygen-style documentation?
(This came out of a lunchtime discussion at work - the statement was
made that "at least the C headers keep you honest. You can't use it
without something that a human can read". Not technically true, but the
point is well taken. While complete source code availability doesn't
matter for many cases (purely open source or purely internal
commercial), it does matter when you have a company writing a library to
be used by a client and they want a binary library + an API definition
exposed via a header file).
Thanks in advance.
--
Matthew Caron, Software Build Engineer
Sixnet, a Red Lion business | www.sixnet.com
+1 (518) 877-5173 x138 office
