std.file read with start position

[H. S. Teoh via Digitalmars-d]

On Tue, Jun 24, 2014 at 10:23:45PM +0200, Jonathan M Davis via Digitalmars-d wrote:
[...]
> > From: "H. S. Teoh via Digitalmars-d" <digitalmars-d at puremagic.com>
[...]
> > P.S. the problem with the table of contents links pointing to the
> > wrong place is a known bug:
> > 
> > 	https://issues.dlang.org/show_bug.cgi?id=11575
> > 
> > This badly needs to be fixed; as things stand, it makes ddoc look
> > like a joke (it generates non-unique HTML element ID's, which both
> > violates the HTML spec and causes erratic browser behaviour when you
> > click on said links).
> 
> ddoc is very useful, but with regards to links, it _is_ a joke. It has
> no understanding of code hierarchy whatsoever, making it just plain
> stupid when it generates links.
[...]

Actually, that's not entirely true:

	https://github.com/D-Programming-Language/dmd/pull/1174

Qualified anchor names have been with us for a while; it's just that the
std.algorithm docs haven't been properly updated to reference them
correctly.

However, pull 1174 leaves out something:

	https://issues.dlang.org/show_bug.cgi?id=10366

But, have no fear! I've managed to figure out how to fix it:

	https://github.com/D-Programming-Language/dmd/pull/3693

Once this goes in, ddoc anchors should be *much* saner. While I don't
have the confidence this is the last we'll hear of ddoc anchor issues, I
think it should improve the situation significantly.


T

-- 
They pretend to pay us, and we pretend to work. -- Russian saying