std.file docs

[Regan Heath]

> A related doc note ...  I find that the docs make it difficult to distinguish
> the methods associated with a class when there multiple classes on a single
> page.  Again, I'd call it visual formatting.

I find the same thing.

> Another issue I found is that I didn't get a definitive answer on whether
> reading files automatically treats them as UTF-8 or not.

I believe;  std.file.read simply reads bytes, it doesn't do any 
conversion, it doesn't handle UTF-8, 16, or 32 BOM or anything else.

>> P.S. It's none of my business, but is IBM interested in D now? :)
> 
> I can't speak for the company, but I personally find the core language more
> pleasant than C++.  If it offers better performance than java then it becomes
> more interesting to me :-)

D offers similar if not better performance than C/C++ in some cases.

Regan