Thread overview | |||||||||
---|---|---|---|---|---|---|---|---|---|
|
January 22, 2018 [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos? | ||||
---|---|---|---|---|
| ||||
It seems that std library documentation lives in two different directories. https://dlang.org/phobos/ https://dlang.org/library/ Maybe it's due to historical reasons. Problem is, when I search for a library function in Google, sometimes it points me to library directory, and sometimes it points me to phobos directory. In fact, when I search "dlang writef", it shows me two urls most relevant. 1. https://dlang.org/library/std/stdio/writef.html 2. https://dlang.org/phobos/std_stdio.html Clicking "format string" hyperlink on first url gives a 404 error. https://dlang.org/library/std/stdio/std_format.html#format-string The second url is correct. https://dlang.org/phobos/std_format.html#format-string Is https://dlang.org/library/ deprecated? If so, is it possible to remove it so that it won't confuse noobs like me? Or if both directories are intented to be used, I'll file a bug instead. |
January 22, 2018 Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Johann | On Monday, 22 January 2018 at 15:18:38 UTC, Johann wrote: > Maybe it's due to historical reasons. It's actually "future" reasons... the /phobos is the original one, and /library was supposed to replace it, but now many years later, /library is still kinda neglected and they both just exist. This is a reason why I forked the d docs to my site dpldocs.info. Check out its search: http://dpldocs.info/writef But yeah, the link in the original source is hardcoded for the /phobos path... but is also a relative link. So when generated on /library, it is just a 404. On my fork, I just fixed it, but /library tries to build from the master branch so they can't really just fix things without making sure it still works in both generators. what a mess. > Or if both directories are intented to be used, I'll file a bug instead. yeah that is prolly best |
January 22, 2018 Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | On Monday, 22 January 2018 at 15:32:29 UTC, Adam D. Ruppe wrote: > http://dpldocs.info/writef Thanks for your good work. I will file a bug report then. Not related to this thread, but is something missing from this page? Only "index" is shown on this page. http://dpldocs.info/experimental-docs/ |
January 22, 2018 Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Johann | On Monday, 22 January 2018 at 16:08:38 UTC, Johann wrote:
> Not related to this thread, but is something missing from this page? Only "index" is shown on this page.
No, that's just a random file. If something isn't linked from another page, it isn't supported... I have a lot of files in that directory from various steps in my development process (it is still called "experimental" cuz it isn't done yet) and I haven't cleaned them all up.
|
January 22, 2018 Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | On Monday, 22 January 2018 at 15:32:29 UTC, Adam D. Ruppe wrote: > On Monday, 22 January 2018 at 15:18:38 UTC, Johann wrote: >> Maybe it's due to historical reasons. > > It's actually "future" reasons... the /phobos is the original one, and /library was supposed to replace it, but now many years later, /library is still kinda neglected and they both just exist. What's needed to remove the "/phobos" one? Is it a decision from on-high, or is there a lot of editing of hardcoded links required? > This is a reason why I forked the d docs to my site dpldocs.info. Check out its search: > > http://dpldocs.info/writef > > But yeah, the link in the original source is hardcoded for the /phobos path... but is also a relative link. So when generated on /library, it is just a 404. On my fork, I just fixed it, but /library tries to build from the master branch so they can't really just fix things without making sure it still works in both generators. what a mess. I'm not sure I understand. What would it take to make the "/library" pages good enough that you wouldn't need <http://dpldocs.info/writef>? |
January 23, 2018 Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos? | ||||
---|---|---|---|---|
| ||||
Posted in reply to John Gabriele | On Monday, 22 January 2018 at 19:38:45 UTC, John Gabriele wrote: > On Monday, 22 January 2018 at 15:32:29 UTC, Adam D. Ruppe wrote: >> On Monday, 22 January 2018 at 15:18:38 UTC, Johann wrote: >>> Maybe it's due to historical reasons. >> >> It's actually "future" reasons... the /phobos is the original one, and /library was supposed to replace it, but now many years later, /library is still kinda neglected and they both just exist. > > What's needed to remove the "/phobos" one? Is it a decision from on-high, or is there a lot of editing of hardcoded links required? This discussion and the referenced news group thread should give insights: https://github.com/dlang/dlang.org/pull/1526 BTW the fix for your issue is here: https://github.com/dlang/phobos/pull/6055 |
January 24, 2018 Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Seb | On Tuesday, 23 January 2018 at 19:05:21 UTC, Seb wrote:
> On Monday, 22 January 2018 at 19:38:45 UTC, John Gabriele wrote:
>> On Monday, 22 January 2018 at 15:32:29 UTC, Adam D. Ruppe wrote:
>>> On Monday, 22 January 2018 at 15:18:38 UTC, Johann wrote:
>>>> Maybe it's due to historical reasons.
>>>
>>> It's actually "future" reasons... the /phobos is the original one, and /library was supposed to replace it, but now many years later, /library is still kinda neglected and they both just exist.
>>
>> What's needed to remove the "/phobos" one? Is it a decision from on-high, or is there a lot of editing of hardcoded links required?
>
> This discussion and the referenced news group thread should give insights:
>
> https://github.com/dlang/dlang.org/pull/1526
>
Thank you!
|
Copyright © 1999-2021 by the D Language Foundation