Proposal for Deimos documentation

[Jens Mueller]

Jens Mueller wrote:
> 1100110 wrote:
> > On 03/20/2013 05:04 PM, Jens Mueller wrote:
> > >Hi,
> > >
> > >I wrote some guidelines for writing a Deimos interface. It's still very
> > >rough but it's a start. I'd like to add it to dlang.org to give
> > >contributors better guidance, ultimately hoping to see more
> > >contributions to Deimos.
> > >Besides comments to improve my poor phrasing I'd especially seek to get
> > >a complete list of recommendations to follow. Please comment.
> > >
> > >http://jkm.github.com/phobos/deimos.html
> > >
> > >Jens
> > """
> > In particular,
> > 
> >     Replace C's include
> > 
> >     Each #include needs to have a corresponding import path.to.header;
> > """
> > 
> > That has certainly not been my experience.  Often one D import will
> > map to a couple of c includes.
> > 
> > I would suggest amending that statement.  It sounds too much like a
> > hard rule(necessary to be considered for inclusion into Deimos) to
> > me.  YMMV.
> 
> Do you have any examples where one import handles many C headers. I
> haven't seen such cases and I wonder why you should need them.

Please ignore this. I now see what you are saying.
In general it'll be nice to have a list of these replacements for
standard C headers.

Jens