Thread overview
[Issue 15656] ddox should recognize special meaning of '_' in ddoc, else may generate broken links.
[Issue 15656] broken link in datetime.d documentation
Feb 08, 2016
ag0aep6g@gmail.com
Feb 08, 2016
Gerald Jansen
Feb 08, 2016
ag0aep6g@gmail.com
Feb 12, 2016
ag0aep6g@gmail.com
Feb 17, 2016
ag0aep6g@gmail.com
Jun 02, 2016
Sönke Ludwig
February 08, 2016
https://issues.dlang.org/show_bug.cgi?id=15656

ag0aep6g@gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |ag0aep6g@gmail.com

--- Comment #1 from ag0aep6g@gmail.com ---
I suppose this is about the ddox pages [1], right? The link is broken there, but it's fine on the ddoc pages [2].

The underscore is there for a reason: Without it, "datetime" would be highlighted by ddoc, which would garble the URL, breaking the link.

That ddox carries over the underscore literally seems to be a bug, or at least an incompatibility between ddox and ddoc.

So, fixing this will be more complicated than just removing the underscore, unfortunately.


[1] <http://dlang.org/library/std/datetime.html>,
<http://dlang.org/library-prerelease/std/datetime.html>
[2] <http://dlang.org/phobos/std_datetime.html>,
<http://dlang.org/phobos-prerelease/std_datetime.html>

--
February 08, 2016
https://issues.dlang.org/show_bug.cgi?id=15656

Gerald Jansen <jansen.gerald@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|---                         |INVALID

--- Comment #2 from Gerald Jansen <jansen.gerald@gmail.com> ---
(In reply to ag0aep6g from comment #1)
> I suppose this is about the ddox pages [1], right?

Yes. Okay so this is a ddox issue and presumably it is well known so I'll close this issue.

--
February 08, 2016
https://issues.dlang.org/show_bug.cgi?id=15656

ag0aep6g@gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|RESOLVED                    |REOPENED
         Resolution|INVALID                     |---

--- Comment #3 from ag0aep6g@gmail.com ---
(In reply to Gerald Jansen from comment #2)
> Yes. Okay so this is a ddox issue and presumably it is well known so I'll close this issue.

I don't think it's well known. At least, this is the first time it's been pointed out to me. This may have to be fixed in ddox, but the broken links are an issue for phobos/dlang.org. So this is definitely not invalid. Reopening.

--
February 12, 2016
https://issues.dlang.org/show_bug.cgi?id=15656

hsteoh@quickfur.ath.cx changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |hsteoh@quickfur.ath.cx
            Summary|broken link in datetime.d   |ddox should recognize
                   |documentation               |special meaning of '_' in
                   |                            |ddoc, else may generate
                   |                            |broken links.
           Severity|minor                       |normal

--
February 12, 2016
https://issues.dlang.org/show_bug.cgi?id=15656

--- Comment #4 from ag0aep6g@gmail.com ---
I've filed an issue against ddox: https://github.com/rejectedsoftware/ddox/issues/117

--
February 17, 2016
https://issues.dlang.org/show_bug.cgi?id=15656

--- Comment #5 from ag0aep6g@gmail.com ---
(In reply to ag0aep6g from comment #4)
> I've filed an issue against ddox: https://github.com/rejectedsoftware/ddox/issues/117

The ddox issue has been fixed. For the fix to reach dlang.org there will have to be a ddox release, and the dlang.org repository will have to be updated to use it.

--
February 22, 2016
https://issues.dlang.org/show_bug.cgi?id=15656

hsteoh@quickfur.ath.cx changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
          Component|phobos                      |dlang.org

--
June 02, 2016
https://issues.dlang.org/show_bug.cgi?id=15656

Sönke Ludwig <sludwig@outerproduct.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|REOPENED                    |RESOLVED
                 CC|                            |sludwig@outerproduct.org
         Resolution|---                         |FIXED

--- Comment #6 from Sönke Ludwig <sludwig@outerproduct.org> ---
The fixed version of the documentation has been deployed. I've opened a separate issue for the "improve this page" link bug: https://issues.dlang.org/show_bug.cgi?id=16114

--