[Development] Harmonizing the Qt 5.x Documentation

[Lisandro Damián Nicanor Pérez Meyer]

On Tuesday 11 March 2014 09:22:40 Thiago Macieira wrote:
> Em ter 11 mar 2014, às 17:17:46, Andre Somers escreveu:
> > I seriously don't see the benefit of this "harmonization". When I look
> > at the docs for a class, I often just look for method names that seem to
> > do what I need. That usually works very with Qt. Now, I will need to go
> > check for every method if it actually exists in the version of Qt I'm
> > on, by looking for a "since" tag. How is that helping me to become more
> > productive?
> 
> If you want to be productive with the exact docs for the version you're
> using and full, indexed text search, you should use Qt Assistant or the
> integrated Help in Qt Creator.

As long as you are building Qt from the one-in-all tarball. If you are 
building with submodules (or using Debian packages, for example) you will miss 
many links between different source packages because the docs are not 
available at build time.

We (Debian Qt maintainers) are doing our best to improve this situation, but 
we acknowledge we are not there yet, because the doc build system wasn't 
designed for this special case.

Of course, if anyone wants to implement it, we have some ideas and we welcome 
patches ;-)

-- 
LINUX KERNEL LIBERADO
DOS SECUESTRADORES MICROSOFTIANOS CAPTURADOS
OTRO SIGUE PROFUGO
*musiquita de cronica TV*

Ok, ok, ya me voy a hacer algo util, no me peguen :D

  Matias "Angasule" D'Ambrosio,
  sobre la liberación del kernel 2.6.23
  http://linux.org.ar/pipermail/bblug/2007-October/005405.html

Lisandro Damián Nicanor Pérez Meyer
http://perezmeyer.com.ar/
http://perezmeyer.blogspot.com/