Re: [Interest] Online doc URL improvement

2019-06-06 Thread Sze Howe Koh
On Thu, 6 Jun 2019 at 10:09, Christian Gagneraud  wrote:
>
> Hi there,
>
> I quite often read the documentation online, b/c the urls are quite
> short and simple i usually type them in directly in the URL bar.

I also use the online docs a lot, but I rarely edit the URL.

Instead, I use the Qt Doc Search browser extension for Chrome/Firefox:
https://forum.qt.io/topic/35616/web-browser-extension-for-improved-doc-searches
(Disclaimer: I wrote this extension)

I activate the URL bar and type [q] + [d] + [space] +  + [Enter]

If Google's "I'm Feeling Lucky" or DuckDuckGo's "Ducky" are enabled,
you'll be taken straight to the class reference page.

> One
> little thing is annoying me, the '.html extension.
> Wouldn't it be great if instead the url would be 'doc.qt.io/qt-5/qwidget'.
> That is shorter to type and easier to navigate to a class you know the
> name of. Currently you have to move the cursor around in the url field
> so that you replace the class name b/w '/' and '.html'. not having to
> deal with '.html' would make the process way faster/easier.

I don't feel strongly either way, but the final solution should be
consistent across all pages, not just C++ classes. What do you propose
for URLs like these?:

* https://doc.qt.io/qt-5/qwidget-members.html
* https://doc.qt.io/qt-5/qml-qtquick-item.html


> Of course to avoid breaking search engine, bookmarks, ... the url with
> '.html' would have to redirect to the one w/o.

(Off-tangent: The online docs broke things a few years ago when they
stopped supporting CamelCase. https://doc.qt.io/qt-5/QWidget.html used
to work, but now it gives Error 404... )

> Any thoughts?
>
> Chris

Thanks for thinking of new ways to improve the docs!


Regards,
Sze-Howe
___
Interest mailing list
Interest@qt-project.org
https://lists.qt-project.org/listinfo/interest


Re: [Interest] OpenGL — using glDispatchComputeGroupSizeARB

2019-06-06 Thread Giuseppe D'Angelo via Interest

Hi,

On 06/06/2019 17:05, Pieter Barendrecht wrote:
I'm trying to figure out exactly what to include to be able to use the 
OpenGL command glDispatchComputeGroupSizeARB (which I'm positive is 
supported on my machine/system). Unfortunately, the typical extension 
workflow (i.e. #include  in the relevant header file 
and QT += openglextensions in the .pro file) does not seem to work — it 
still results in an 'use of undeclared identifier' error upon compiling 
the code. Any thoughts? I'm on Linux (64bit), using Qt 5.12.


I believe the QtOpenGLExtensions hasn't been regenerated for quite a 
while, and thus does not cover this extension (Khronos changed the 
extension database format or somesuch).


An easy workaround is to resolve the entry point manually. Include 
qopengl.h and do something like this:



if (ctx->hasExtension("GL_ARB_compute_variable_group_size")) {
entry = 
reinterpret_cast(ctx->getProcAddress("glDispatchComputeGroupSizeARB");
// use it
}


HTH,

--
Giuseppe D'Angelo | giuseppe.dang...@kdab.com | Senior Software Engineer
KDAB (France) S.A.S., a KDAB Group company
Tel. France +33 (0)4 90 84 08 53, http://www.kdab.com
KDAB - The Qt, C++ and OpenGL Experts



smime.p7s
Description: S/MIME Cryptographic Signature
___
Interest mailing list
Interest@qt-project.org
https://lists.qt-project.org/listinfo/interest


[Interest] OpenGL — using glDispatchComputeGroupSizeARB

2019-06-06 Thread Pieter Barendrecht
Hi all,

I'm trying to figure out exactly what to include to be able to use the
OpenGL command glDispatchComputeGroupSizeARB (which I'm positive is
supported on my machine/system). Unfortunately, the typical extension
workflow (i.e. #include  in the relevant header file
and QT += openglextensions in the .pro file) does not seem to work — it
still results in an 'use of undeclared identifier' error upon compiling the
code. Any thoughts? I'm on Linux (64bit), using Qt 5.12.

Best,
Pieter
___
Interest mailing list
Interest@qt-project.org
https://lists.qt-project.org/listinfo/interest


Re: [Interest] Online doc URL improvement

2019-06-06 Thread Christian Gagneraud
On Thu, 6 Jun 2019 at 23:07, Konstantin Tokarev  wrote:
> 06.06.2019, 05:09, "Christian Gagneraud" :
> > Hi there,
> >
> > I quite often read the documentation online, b/c the urls are quite
> > short and simple i usually type them in directly in the URL bar.
>
> FWIW, you can get even better experience with local documentation

I don't see how having local documentation would simplify the url issue.
Sometimes you don't have local documentation, and sometimes you might
prefer to read it from the browser.
And yes, i use QtCreator integrated a lot, but i like to dedicate a
screen for "side" information, and that includes all sort of online
documentation, not just Qt, the the web browser is my preferred tool.

Chris
___
Interest mailing list
Interest@qt-project.org
https://lists.qt-project.org/listinfo/interest


Re: [Interest] Online doc URL improvement

2019-06-06 Thread Konstantin Tokarev


06.06.2019, 05:09, "Christian Gagneraud" :
> Hi there,
>
> I quite often read the documentation online, b/c the urls are quite
> short and simple i usually type them in directly in the URL bar.

FWIW, you can get even better experience with local documentation

> One
> little thing is annoying me, the '.html extension.
> Wouldn't it be great if instead the url would be 'doc.qt.io/qt-5/qwidget'.
> That is shorter to type and easier to navigate to a class you know the
> name of. Currently you have to move the cursor around in the url field
> so that you replace the class name b/w '/' and '.html'. not having to
> deal with '.html' would make the process way faster/easier.
> Of course to avoid breaking search engine, bookmarks, ... the url with
> '.html' would have to redirect to the one w/o.
>
> Any thoughts?
>
> Chris
> ___
> Interest mailing list
> Interest@qt-project.org
> https://lists.qt-project.org/listinfo/interest

-- 
Regards,
Konstantin

___
Interest mailing list
Interest@qt-project.org
https://lists.qt-project.org/listinfo/interest


Re: [Interest] Online doc URL improvement

2019-06-06 Thread Elvis Stansvik
Den tors 6 juni 2019 kl 04:09 skrev Christian Gagneraud :
>
> Hi there,
>
> I quite often read the documentation online, b/c the urls are quite
> short and simple i usually type them in directly in the URL bar. One
> little thing is annoying me, the '.html extension.
> Wouldn't it be great if instead the url would be 'doc.qt.io/qt-5/qwidget'.
> That is shorter to type and easier to navigate to a class you know the
> name of. Currently you have to move the cursor around in the url field
> so that you replace the class name b/w '/' and '.html'. not having to
> deal with '.html' would make the process way faster/easier.
> Of course to avoid breaking search engine, bookmarks, ... the url with
> '.html' would have to redirect to the one w/o.
>
> Any thoughts?

Not apart from +2 I've been thinking the exact same thing :)

Elvis

>
> Chris
> ___
> Interest mailing list
> Interest@qt-project.org
> https://lists.qt-project.org/listinfo/interest
___
Interest mailing list
Interest@qt-project.org
https://lists.qt-project.org/listinfo/interest