www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - How does one get to the root of a package in ddox?

reply Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> writes:
Say you're on https://dlang.org/library/std/range/primitives.html and 
try to find your way to https://dlang.org/library/std/range.html.

Clicking on "range" in the navigation panel doesn't help - it just 
collapses/expands the tree branch.

What's the design here?


Thanks,

Andrei
Apr 15 2016
parent reply =?UTF-8?Q?S=c3=b6nke_Ludwig?= <sludwig outerproduct.org> writes:
Am 15.04.2016 um 22:38 schrieb Andrei Alexandrescu:
 Say you're on https://dlang.org/library/std/range/primitives.html and
 try to find your way to https://dlang.org/library/std/range.html.

 Clicking on "range" in the navigation panel doesn't help - it just
 collapses/expands the tree branch.

 What's the design here?


 Thanks,

 Andrei
Oh yeah, this is something that has been bugging me for a while, but I haven't got around to fix. The problem is that due to the way the navigation menu currently works, there need to be two entries for packages that have a package.d (the upper one will snap in/out while the bottom one will open the package documentation). We'd have to change the UI to be more like a classical tree control with a +/- box at the left.
Apr 15 2016
next sibling parent reply =?UTF-8?Q?S=c3=b6nke_Ludwig?= <sludwig outerproduct.org> writes:
Am 16.04.2016 um 07:38 schrieb Sönke Ludwig:
 Am 15.04.2016 um 22:38 schrieb Andrei Alexandrescu:
 Say you're on https://dlang.org/library/std/range/primitives.html and
 try to find your way to https://dlang.org/library/std/range.html.

 Clicking on "range" in the navigation panel doesn't help - it just
 collapses/expands the tree branch.

 What's the design here?


 Thanks,

 Andrei
Oh yeah, this is something that has been bugging me for a while, but I haven't got around to fix. The problem is that due to the way the navigation menu currently works, there need to be two entries for packages that have a package.d (the upper one will snap in/out while the bottom one will open the package documentation). We'd have to change the UI to be more like a classical tree control with a +/- box at the left.
Alternatively, the package.d entry could be put as the first child item of its package and get a special name (e.g. "Package documentation").
Apr 15 2016
parent Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> writes:
On 4/16/16 1:49 AM, Sönke Ludwig wrote:
 Alternatively, the package.d entry could be put as the first child item
 of its package and get a special name (e.g. "Package documentation").
That sounds good! -- Andrei
Apr 16 2016
prev sibling parent Martin Nowak <code+news.digitalmars dawg.eu> writes:
On 04/16/2016 07:38 AM, Sönke Ludwig wrote:
 Am 15.04.2016 um 22:38 schrieb Andrei Alexandrescu:
 Say you're on https://dlang.org/library/std/range/primitives.html and
 try to find your way to https://dlang.org/library/std/range.html.

 Clicking on "range" in the navigation panel doesn't help - it just
 collapses/expands the tree branch.
Also the links in the fully qualified name (at the top) should include links to the package. Module std.range.primitives (https://dlang.org/library/std/range/primitives.html) range -> std/range.html Enum member std.range.primitives.isOutputRange (https://dlang.org/library/std/range/primitives/is_output_range.html) range -> std/range.html primitives -> std/range/primitives.html
Jun 11 2016