[solved] Strange formatting in devnet doc

? Offline

For anyone wanting to check too, the link to the page: http://developer.qt.nokia.com/doc/qt-4.7/qsettings.html :-)

It's the same on the Mac with Chrome, Safari and Camino (Firefox engine).

koahnig

Thanks Volker

Here is the link to the "JIRA bug report":https://bugreports.qt.nokia.com/browse/QTWEBSITE-329

? Offline

Also the spacing between the return type and currently the class name is very small, and one could see these two words as a single word.
E.g. in the previous page, bool is right next to QSettings

? Offline

[quote author="alban.lefebvre" date="1323966305"]Also the spacing between the return type and currently the class name is very small, and one could see these two words as a single word.
E.g. in the previous page, bool is right next to QSettings[/quote]

That is indeed a bit stupid. I filed a bug and it will hopefully be fixed soon. Thanks for pointing it out. :)

? Offline

Main issue reported in this topic works fine in browsers IE, FF and chrome on windows7 , I will test it other browsers and if found I will fix that.

About
[quote author="alban.lefebvre" date="1323966305"]Also the spacing between the return type and currently the class name is very small, and one could see these two words as a single word.
E.g. in the previous page, bool is right next to QSettings[/quote]

This will be fixed, thank you for reporting this.

koahnig

[quote author="Gurudutt" date="1323975673"]Main issue reported in this topic works fine in browsers IE, FF and chrome on windows7 , I will test it other browsers and if found I will fix that.
[/quote]

Hi Gurudutt,
are you sure? Doesn't it look like on the image?
The text sais "QSettings QSettings (..." for the constructors. Also for other methods is a greyed QSettings added. That does not make sense.

? Offline

Looks fine here in my all browser, on linux and windows 7

I will try on other computers and different browsers, since it is issue for many people then for sure this is issue, I am trying to reproduce it.

!http://i.imgur.com/W7ko0.png!

koahnig

But it sais also
@
QSettings QSettings
@
"Here":http://doc.qt.nokia.com/4.7/qsettings.html it just sais
@
QSettings
@
or a little further down
@
QSettings :: QSettings
@

Both versions are ok, because they are syntactilly correct.

But in "here":http://developer.qt.nokia.com/doc/qt-4.8/qsettings.html it is not correct. If you go down further it looks like this:

!http://dl.dropbox.com/u/3833524/Qt-posts/QSettings-snip2.PNG(QSettings method list)!

I would at least prefer to have it with a correct syntax.

dangelog

Was a BR filed against the broken spacing?

koahnig

[quote author="peppe" date="1324303748"]Was a BR filed against the broken spacing?[/quote]

You mean about that the return values have no space to QSettings?
I have added a comment to the already filed original "bug report":https://bugreports.qt.nokia.com/browse/QTWEBSITE-329 on JIRA.

? Offline

Should be all sorted now :)

koahnig

[quote author="mariusg" date="1324567922"]Should be all sorted now :)[/quote]

Looks definitely much better now. Only a minor thing with the iniCodec() return value remains.

:( I am feeling so sorry for bothering you so much before the holidays start :(

? Offline

Not to worry, we want the doc to be awesome before we get to open the presents :)

Could you elaborate on the iniCodec() return value issue?

koahnig

It looks like this here

!http://db.tt/Y2uZoQJg(iniCodec example)!

The extra line with the asterix is not what one would expect. Probably column with issue I can imagine. This would be perfect:
@
QString group () const
QTextCodec * iniCodec () const
bool isWritable () const
QString organizationName () const
@