Re: [Development] QDataStream: blackbox or document all versions?

2016-09-25 Thread Martin Smith
Do we need a way to tie A specific qdoc comment to the result of a specific autotest? martin From: Development on behalf of Thiago Macieira Sent: Sunday, September 25, 2016 5:58:38 AM To: development@qt-project.org Subject: [Development] QDataStream: blackbox

Re: [Development] QDataStream: blackbox or document all versions?

2016-09-25 Thread Jędrzej Nowacki
On lørdag 24. september 2016 20.58.38 CEST Thiago Macieira wrote: > A thread[1] on the interest mailing list started when someone asked for the > docs for the current format of the QDataStream wire protocol, to which I > replied that it doesn't exist as we don't maintain such docs. > > Long story

Re: [Development] QDataStream: blackbox or document all versions?

2016-09-25 Thread Giuseppe D'Angelo
Il 25/09/2016 23:42, Konstantin Tokarev ha scritto: > I think there is also > > Option 3: restore documentation of version 12 and declare that it's the only > format version that is meant for use with 3rd party encoders and decoders. > What is the rationale be for this? Cheers, -- Giuseppe D'

Re: [Development] QDataStream: blackbox or document all versions?

2016-09-25 Thread Konstantin Tokarev
25.09.2016, 06:58, "Thiago Macieira" : > A thread[1] on the interest mailing list started when someone asked for the > docs for the current format of the QDataStream wire protocol, to which I > replied that it doesn't exist as we don't maintain such docs. > > Long story short, we have two options

Re: [Development] QDataStream: blackbox or document all versions?

2016-09-25 Thread Konstantin Tokarev
26.09.2016, 00:12, "Konstantin Tokarev" : > 25.09.2016, 06:58, "Thiago Macieira" : >>  A thread[1] on the interest mailing list started when someone asked for the >>  docs for the current format of the QDataStream wire protocol, to which I >>  replied that it doesn't exist as we don't maintain su

Re: [Development] QDataStream: blackbox or document all versions?

2016-09-25 Thread Konstantin Tokarev
25.09.2016, 06:58, "Thiago Macieira" : > A thread[1] on the interest mailing list started when someone asked for the > docs for the current format of the QDataStream wire protocol, to which I > replied that it doesn't exist as we don't maintain such docs. > > Long story short, we have two options

Re: [Development] QDataStream: blackbox or document all versions?

2016-09-25 Thread Thiago Macieira
On domingo, 25 de setembro de 2016 14:24:29 PDT Eric Lemanisser wrote: > 2/ as easy to use : QDataStream is able to serialize any type with the help > of qRegisterMetaTypeStreamOperators You only need that if you use QVariant. Regular QDataStream with non-type- erased types doesn't require that ca

Re: [Development] QDataStream: blackbox or document all versions?

2016-09-25 Thread Eric Lemanisser
You could choose to turn QDataStream into a black-box, but I think there should be a white-box alternative which has to be 1/ as efficient : binary format 2/ as easy to use : QDataStream is able to serialize any type with the help of qRegisterMetaTypeStreamOperators 3/ as generic : it should be abl