Re: [Development] Documentation and Modularization

2012-09-24 Thread Frederik Gladhorn
On Monday 24. September 2012 13.36.10 Konstantin Tokarev wrote: > 23.09.2012, 14:25, "Frederik Gladhorn" : > > Hi, > > since we were discussing how to maintain QDoc and how to fix issues, I > > poked at doxygen again. > > I also sent a mail to it's maintainer who responded quickly and friendly. > >

Re: [Development] Documentation and Modularization

2012-09-24 Thread Konstantin Tokarev
23.09.2012, 14:25, "Frederik Gladhorn" : > Hi, > since we were discussing how to maintain QDoc and how to fix issues, I poked > at > doxygen again. > I also sent a mail to it's maintainer who responded quickly and friendly. > I'm not sure if we want to go down this route, but it seems an option

[Development] Documentation and Modularization

2012-09-24 Thread Martin Smith
>I'm not sure if we want to go down this route (doxygen), but it seems an >option to me. We have discussed it many times. The management decision has always been to proceed with qdoc. I don't feel strongly either way, but if I'm asked I would say we should stay with qdoc and just move qdoc grad

Re: [Development] Documentation and Modularization

2012-09-23 Thread Frederik Gladhorn
Hi, since we were discussing how to maintain QDoc and how to fix issues, I poked at doxygen again. I also sent a mail to it's maintainer who responded quickly and friendly. I'm not sure if we want to go down this route, but it seems an option to me. It means a lot of work, but so does maintaining

Re: [Development] Documentation and Modularization

2012-09-20 Thread Saether Jan-Arve
g Emne: Re: [Development] Documentation and Modularization On Wednesday September 19 2012, Gladhorn Frederik wrote: [...] > Since we don't see a way to fix the modularized build of the docs without > big issues (predictive links seem hard to get right and we couldn't show > warnings a

Re: [Development] Documentation and Modularization

2012-09-19 Thread Marc Mutz
On Wednesday September 19 2012, Gladhorn Frederik wrote: [...] > Since we don't see a way to fix the modularized build of the docs without > big issues (predictive links seem hard to get right and we couldn't show > warnings about them easily), we propose to actually make use of a mixed > approach

[Development] Documentation and Modularization

2012-09-19 Thread Gladhorn Frederik
Hi, while we all love our documentation we also need to work on polishing it some more ;) Today there was a discussion in Oslo about the "how to link between modules" problems we're facing with qdoc. I'll try to illustrate the problem and show the solution we would like to propose. We have two