html documentation should show public imports

H. S. Teoh hsteoh at quickfur.ath.cx
Thu Jul 18 09:49:17 PDT 2013


On Wed, Jul 17, 2013 at 09:21:08PM -0700, Jonathan M Davis wrote:
> On Wednesday, July 17, 2013 17:39:19 Timothee Cour wrote:
> > std.range shouldn't contain public import std.array.
> 
> It's done because otherwise std.range is useless with arrays, and
> arrays are probably the most frequently used type of range. We lose
> nothing by having that public import. Now, documenting public imports
> is a good idea, but I don't understand why you think that having
> std.range publicly import std.array is a problem.
[...]

We should document public imports.

But the whole point of publically importing std.array in std.range is so
that you can endow arrays with the range API by importing just
std.range. I think we should keep it. Just add it to the documentation.


T

-- 
Just because you can, doesn't mean you should.


More information about the Digitalmars-d-learn mailing list