[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