From d561681cc14e1338aa9f7e0a8b7138941c1465cf Mon Sep 17 00:00:00 2001 From: Robert Jordens Date: Thu, 31 Mar 2016 10:25:39 +0200 Subject: [PATCH] doc: add note about xcb (closes #361) --- doc/manual/installing.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/manual/installing.rst b/doc/manual/installing.rst index df86e309f..c44069fca 100644 --- a/doc/manual/installing.rst +++ b/doc/manual/installing.rst @@ -88,6 +88,12 @@ the existing environments using:: $ conda env list +.. note:: + The ``qt5`` package requires (on Linux only) libraries not packaged in the ``m-labs`` conda channels. + Those need to be installed through the Linux distribution's mechanism. + If ``artiq_gui`` does not start because ``it could not find or load the Qt platform plugin "xcb"``, install the various ``libxcb-*`` packages through your distribution's mechanism. + The names of the libraries missing can be obtained from the output of a command like ``ldd [path-to-conda-installation]/envs/artiq-[date]/lib/qt5/plugins/platform/libqxcb.so``. + Preparing the core device FPGA board ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^