[Development] Request: Mark classes with \module in documentation

lars.knoll at nokia.com lars.knoll at nokia.com
Fri Aug 24 21:07:19 CEST 2012


On Aug 24, 2012, at 11:21 AM, ext Oswald Buddenhagen <oswald.buddenhagen at nokia.com> wrote:

> On Fri, Aug 24, 2012 at 11:13:49AM +0200, Vandonderen Casper (Nokia-MP/Oslo) wrote:
>> What I want to do in QDoc is to automatically set the module to the value
>> of the "project" variable in the qdocconf file (if no \inmodule command is
>> specified).
>> 
> that sounds about right.
> 
>> This means that currently around 80% of the classes in the monolithic
>> build would suddenly belong to the "Qt" module.
>> 
> the point is that the idea of a truly monolithic build is fundamentally
> flawed when modules are supposed to be stand-alone.
> a "monolithic" build should be achieved via aggregation of the modules,
> not a different build mode. everything else will instantly result in a
> packaging failure.

You might be right in theory, but we are currently simply not able to build the docs in a modular way. What Casper asks for is a relatively simple workaround to get decent docs *now* for the beta.

Lars




More information about the Development mailing list