On 6/24/14, 12:39 PM, H. S. Teoh via Digitalmars-d wrote:
On Tue, Jun 24, 2014 at 12:36:12PM -0700, H. S. Teoh via Digitalmars-d wrote:
On Tue, Jun 24, 2014 at 02:07:20PM -0400, Etienne via Digitalmars-d wrote:
[...]
I think the documentation could use more code samples, and a smarter
table of contents. e.g. http://dlang.org/phobos/std_stdio.html
clicking on the "read" keyword redirects to... enum LockType.read
There's no mention about reading in the struct File; example
ugh :/
Please file a bug in the bugtracker so that we don't forget about this
issue.
[...]
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).
This has been a long-standing issue that I actually fixed a long time
ago in https://github.com/D-Programming-Language/dlang.org/pull/271. Of
course, it's now bit rotting in peace. -- Andrei
