Important: Please read the Qt Code of Conduct - https://forum.qt.io/topic/113070/qt-code-of-conduct
[solved] Strange formatting in devnet doc
-
I have noticed a strange formatting in DOC of devnet.
!http://db.tt/mqj6eAGg(QSettings)!
If there would be two colons visible, it would make sense. This is the expanded view, where it looks really ackward.
In the Qt reference documentation it looks better.
-
Could you file a bugreport please?
-
Yes, I will. Was checking if it is just my browser. I am using Chrome on Windows 7.
What are you using?
-
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).
-
Thanks Volker
Here is the link to the "JIRA bug report":https://bugreports.qt.nokia.com/browse/QTWEBSITE-329
-
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 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. :)
-
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.
-
[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.
-
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.
-
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.
-
Was a BR filed against the broken spacing?
-
[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.
-
Should be all sorted now :)
-
[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 :(
-
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?
-
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
@
