View mode: basic / threaded / horizontal-split · Log in · Help
September 30, 2005
DDOC not honoring alias names
'bool' comes out as 'bit, 'size_t' comes out as 'uint', etc...

If I wanted 'bit' and 'uint' that's what I would have used in the code.

-- 
Derek
(skype: derek.j.parnell)
Melbourne, Australia
30/09/2005 1:46:51 PM
September 30, 2005
Re: DDOC not honoring alias names
"Derek Parnell" <derek@psych.ward> wrote in message
news:1dtllrhs1qmvi.6mpzy3mejzpa$.dlg@40tude.net...
> 'bool' comes out as 'bit, 'size_t' comes out as 'uint', etc...
>
> If I wanted 'bit' and 'uint' that's what I would have used in the code.

I know. It's on the list to fix.
September 30, 2005
Re: DDOC not honoring alias names
On Thu, 29 Sep 2005 21:48:27 -0700, Walter Bright wrote:

> "Derek Parnell" <derek@psych.ward> wrote in message
> news:1dtllrhs1qmvi.6mpzy3mejzpa$.dlg@40tude.net...
>> 'bool' comes out as 'bit, 'size_t' comes out as 'uint', etc...
>>
>> If I wanted 'bit' and 'uint' that's what I would have used in the code.
> 
> I know. It's on the list to fix.

I'm sorry if I'm sounding a little gruff; its not personal. 

I think you've done yourself, and all D users, a great service by
developing DDoc. Sure, I have a couple ideas for enhancing it but I'll hold
fire until it stabilizes and gets some real-world usage.

-- 
Derek
(skype: derek.j.parnell)
Melbourne, Australia
30/09/2005 3:07:40 PM
September 30, 2005
Re: DDOC not honoring alias names
"Derek Parnell" <derek@psych.ward> wrote in message
news:14ay57k5sdkh4$.1asfa5x4l2m0b$.dlg@40tude.net...
> On Thu, 29 Sep 2005 21:48:27 -0700, Walter Bright wrote:
>
> > "Derek Parnell" <derek@psych.ward> wrote in message
> > news:1dtllrhs1qmvi.6mpzy3mejzpa$.dlg@40tude.net...
> >> 'bool' comes out as 'bit, 'size_t' comes out as 'uint', etc...
> >>
> >> If I wanted 'bit' and 'uint' that's what I would have used in the code.
> >
> > I know. It's on the list to fix.
>
> I'm sorry if I'm sounding a little gruff; its not personal.
>
> I think you've done yourself, and all D users, a great service by
> developing DDoc. Sure, I have a couple ideas for enhancing it but I'll
hold
> fire until it stabilizes and gets some real-world usage.

Hey, no prob. The reason for the alias problem is the semantic pass has
already been run, and aliases have been replaced by their real types.
Running Ddoc before the semantic pass means that things like class
heirarchies will be unknown. So a copy will have to be saved of the original
type.

Right now I'm working on adding color syntax highlighting for code sections.
It's actually easier than I thought. I just hook the highlighter into the
lexer, and voila! It gives me accurate start/stop for each token type. I've
never seen a C++ syntax colorer that gets it 100% right, because it requires
a C++ compiler and compliant preprocessor to do all the edge cases
correctly. But Ddoc will do it 100%, by leveraging the actual D lexer.

The irony in all this is that if I wasn't so lazy, I'd never write Ddoc. I'm
too lazy to do the meticulous and boring work of tweaking all the docs by
hand, and let's face it, HTML is just not pretty, so I write a program to do
the dirty work for me. And it is kinda fun watching it turn routine code
comments into eye candy <g>.
Top | Discussion index | About this forum | D home