Bug 15683 – broken link in DDoc

Status
RESOLVED
Resolution
FIXED
Severity
trivial
Priority
P1
Component
phobos
Product
D
Version
D2
Platform
All
OS
All
Creation time
2016-02-15T04:47:00Z
Last change time
2016-02-15T08:09:09Z
Assigned to
nobody
Creator
b2.temp

Comments

Comment #0 by b2.temp — 2016-02-15T04:47:21Z
http://dlang.org/phobos/std_algorithm_iteration.html#.cache after the first example, in the paragraph starting by "Tip:" link to "std.range.take" is broken.
Comment #1 by destructionator — 2016-02-15T04:49:55Z
We really should just remove that stupid "feature" from ddoc entirely.
Comment #2 by b2.temp — 2016-02-15T04:57:08Z
(In reply to Adam D. Ruppe from comment #1) > We really should just remove that stupid "feature" from ddoc entirely. Can you explain me why it generates a <i></i>, I should be able to fix it myself but instead lost 10 minutes...and finished by opening a ticket.
Comment #3 by destructionator — 2016-02-15T05:01:11Z
Check out the Emphasis header here: http://dlang.org/spec/ddoc.html (seriously, still not linked? ugh) What happens is ddoc thinks any name it recognizes in the current scope needs to be emphasized and wraps it in a DDOC_PSYMBOL macro, which the Phobos docs expand to <i>$0</i>. You can suppress it by prefixing the word with a _. That brings pain in other areas, but would work to fix this immediate problem. So replace the word "range" with "_range" in the Phobos source. We could also consider redefining the DDOC_PSYMBOL to be plain $0, kinda disabling this horrible misfeature site-wide.
Comment #4 by github-bugzilla — 2016-02-15T08:09:08Z