Mockup of my doc dream ideas

Adam D. Ruppe via Digitalmars-d digitalmars-d at puremagic.com
Sat Dec 26 13:38:23 PST 2015


On Saturday, 26 December 2015 at 20:43:18 UTC, Brian Schott wrote:
> The name lookup code is here: 
> https://github.com/Hackerpilot/dsymbol.

Aye, I'm still just working on figuring out how to use it :)

But since DCD does I should be able to borrow a lil code from 
there to make it happen.

> If you haven't seen it already, I recommend that you take a 
> look at this: https://github.com/economicmodeling/harbored

Actually, while I have heard of it before, I forgot all about it 
here. Probably would have been a nicer starting point for this 
than the dscanner modules I used as guides into dparse.

Oh well. I might steal some from it now! But I still want to do 
things a little differently. See, I kinda sorta like ddoc and it 
isn't *fatally* flawed... but it is *fundamentally* flawed and I 
actually want to get away from it, not implement it again.

I want to have a slightly longer summary. I want to have 
semantic, properly encoded output. I want pasted links to 
magically become <a> tags and rich automatic linking.

I do NOT want arbitrary foo: strings at the beginning of a line 
to start a new section. I do NOT want the current symbol to be 
highlighted. I do NOT want $1 appearing in the text to do weird 
things.


So that's going to put a limit on my compatibility with Phobos.

Though maybe, just maybe, I'll use your libddoc on modules that 
start with std. and core. then do my own things on my modules.....


More information about the Digitalmars-d mailing list