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

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

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.

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.

> 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.