September 27, 2010 dcollection docs | ||||
---|---|---|---|---|
| ||||
Posted in reply to Steven Schveighoffer | On 27.09.2010 14:01, Steven Schveighoffer wrote: > > > Sorry about lack of online docs, I need to figure out how to automatically generate them (the D1 docs are auto-generated, but I haven't put in any time to figure out how to generate the D2 version). > > -Steve Yao has a nice ddoc template for D2. See for example http://d.yao.com.mx/datetime/core.html The ddoc file is available here: https://bitbucket.org/gomez/yao-library/src/da11956a6a6e/docs/ but I don't know about the license for that file, you might have to ask him about that. This doesn't generate an index though, if you meant that. -- Johannes Pfau |
September 27, 2010 Re: dcollection docs | ||||
---|---|---|---|---|
| ||||
Posted in reply to Johannes Pfau | On Mon, 27 Sep 2010 08:34:57 -0400, Johannes Pfau <spam@example.com> wrote:
> On 27.09.2010 14:01, Steven Schveighoffer wrote:
>>
>>
>> Sorry about lack of online docs, I need to figure out how to
>> automatically generate them (the D1 docs are auto-generated, but I
>> haven't put in any time to figure out how to generate the D2 version).
>>
>> -Steve
>
> Yao has a nice ddoc template for D2. See for example
> http://d.yao.com.mx/datetime/core.html
> The ddoc file is available here:
> https://bitbucket.org/gomez/yao-library/src/da11956a6a6e/docs/ but I
> don't know about the license for that file, you might have to ask him
> about that. This doesn't generate an index though, if you meant that.
Thanks,
Yao's seems similar to Phobos, which I'm not a big fan of. Particularly the munged-together list of constructs/functions at the top.
I used Tango's (old) doc generation templates to generate the D1 docs, and Brad of dsource set up my project to rebuild the D1 docs on every checkin. However, I don't think he's set up a D2 compiler, and even if he did, it's changing so frequently that he'd have to update it too often.
I dumped the Tango doc templates for the D2 version, and I want to rewrite them, but I just haven't had the time. In particular, I want a categorical index at the top or on the side (i.e. functions, members, etc.) Having everything munged together is super-confusing.
I really like the dil-generated docs that Tango uses, but I'm pretty sure dil isn't D2...
-Steve
|
September 27, 2010 Re: dcollection docs | ||||
---|---|---|---|---|
| ||||
Posted in reply to Johannes Pfau | On Mon, 27 Sep 2010 07:34:57 -0500, Johannes Pfau <spam@example.com> wrote: > Yao has a nice ddoc template for D2. See for example > http://d.yao.com.mx/datetime/core.html > The ddoc file is available here: > https://bitbucket.org/gomez/yao-library/src/da11956a6a6e/docs/ but I > don't know about the license for that file, you might have to ask him > about that. This doesn't generate an index though, if you meant that. That ddoc file is in, let's say, experimental stage, and I had to make some "hacks" to make the generated docs pass the HTML4 validator (see for example the UL or the D_CODE macros). They don't have licence because I didn't find an equivalent to the Boost Licence but for documentation, but they can be used freely for whatever need you have. I still have to make some improvements, for example create a tree of symbols, like the one in Kandil or CandyDoc. -- Yao G. |
September 27, 2010 Re: dcollection docs | ||||
---|---|---|---|---|
| ||||
Posted in reply to Steven Schveighoffer | On Mon, 27 Sep 2010 07:46:49 -0500, Steven Schveighoffer <schveiguy@yahoo.com> wrote: > Thanks, > > Yao's seems similar to Phobos, which I'm not a big fan of. Particularly the munged-together list of constructs/functions at the top. To be honest, I don't like it either :) I plan to improve it, and by improve it I mean to remove that cloud-like unordered list of symbols, and use a tree or something similar. CandyDoc sometimes hangs Opera, so I wanted to make a quick replacement, that also worked well without JavaScript. Maybe I'll switch to Kandil or just use the doc generator of Dil. -- Yao G. |
September 27, 2010 Re: intrusive linked list | ||||
---|---|---|---|---|
| ||||
Posted in reply to Denis Koroskin | > That's called intrusive linked list, and I find using it quite viable:
> zero-allocation O(1) add/removal is a very strong characteristics.
>
> They are very useful especially for lock-free algorithms.
That's for the info Denis. I got the idea from a friend who is interested in how to make games.
|
Copyright © 1999-2021 by the D Language Foundation