Are there any default dmd optimizations

pjmlp pjmlp at progtools.org
Wed Feb 27 00:05:36 PST 2013


On Tuesday, 26 February 2013 at 23:44:32 UTC, Walter Bright wrote:
> On 2/26/2013 2:10 PM, foobar wrote:
>> All of the above describes the benefits of having standardized 
>> documentation and
>> I agree with that. That has nothing to do with DDoc's specific 
>> design compared
>> to other similar efforts. A quick survey of languages shows 
>> that Ruby, Python,
>> Java, C#, and many others all have the same benefits but non 
>> has the doc
>> generator built into the compiler/vm with all the problems 
>> this entails.
>
> Building ddoc into the compiler means it has access to the 
> semantic information that compiler provides, and it uses that 
> information. If it is not built in to the compiler, then the 
> options are:
>
> 1. require the user to type the information in twice
> 2. add parsing and semantic analysis capability to the doc 
> generator
>
> I find (1) to be an unacceptable user experience, and (2) to be 
> not viable given our limited resources.
>
> BTW, Javadoc apparently can only generate HTML. As Andrei has 
> demonstrated, Ddoc can generate html, pdf, and ebooks without 
> changing the Ddoc comments. I'm curious what fundamental 
> advantage you believe Javadoc has over Ddoc.

This is not true.

Javadoc uses a plugin architecture known as doclet.

http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/doclet/overview.html

There are quite a few plugins available, this one for example 
generates UML diagrams from JavaDoc comments.

http://code.google.com/p/apiviz/

--
Paulo



More information about the Digitalmars-d mailing list