From owner-svn-doc-all@freebsd.org Sun Mar 17 10:22:33 2019 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 0A4A51533588; Sun, 17 Mar 2019 10:22:33 +0000 (UTC) (envelope-from tobik@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id AF07D71201; Sun, 17 Mar 2019 10:22:32 +0000 (UTC) (envelope-from tobik@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id A59F587E9; Sun, 17 Mar 2019 10:22:32 +0000 (UTC) (envelope-from tobik@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id x2HAMWOq074880; Sun, 17 Mar 2019 10:22:32 GMT (envelope-from tobik@FreeBSD.org) Received: (from tobik@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id x2HAMW6r074878; Sun, 17 Mar 2019 10:22:32 GMT (envelope-from tobik@FreeBSD.org) Message-Id: <201903171022.x2HAMW6r074878@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: tobik set sender to tobik@FreeBSD.org using -f From: Tobias Kortkamp Date: Sun, 17 Mar 2019 10:22:32 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r52873 - in head/en_US.ISO8859-1/books/porters-handbook: special uses X-SVN-Group: doc-head X-SVN-Commit-Author: tobik X-SVN-Commit-Paths: in head/en_US.ISO8859-1/books/porters-handbook: special uses X-SVN-Commit-Revision: 52873 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: AF07D71201 X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org X-Spamd-Result: default: False [-2.98 / 15.00]; local_wl_from(0.00)[FreeBSD.org]; NEURAL_HAM_MEDIUM(-1.00)[-0.998,0]; NEURAL_HAM_SHORT(-0.98)[-0.978,0]; ASN(0.00)[asn:11403, ipnet:2610:1c1:1::/48, country:US]; NEURAL_HAM_LONG(-1.00)[-1.000,0] X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 17 Mar 2019 10:22:33 -0000 Author: tobik (ports committer) Date: Sun Mar 17 10:22:32 2019 New Revision: 52873 URL: https://svnweb.freebsd.org/changeset/doc/52873 Log: Porter's Handbook: Update KDE and Qt sections - Remove mention of KDE/Qt 4 - Update examples to use KDE/Qt 5 - Update USE_KDE, USE_QT component lists Approved by: mat, tcberner Differential Revision: https://reviews.freebsd.org/D19605 Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Sat Mar 16 15:52:47 2019 (r52872) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Sun Mar 17 10:22:32 2019 (r52873) @@ -2593,15 +2593,10 @@ GLIB_SCHEMAS= org.regexxer.gschema.xml Ports That Require Qt - The Ports Collection provides support for Qt 4 and Qt 5 - frameworks with - USES+=qt:x, - where x is - 4 or 5. - Set USE_QT to the list of required - Qt components (libraries, tools, plugins). The Qt 4 - and Qt 5 frameworks are quite similar. The main - difference is the set of supported components. + The Ports Collection provides support for Qt 5 with + USES+=qt:5. Set USE_QT + to the list of required Qt components (libraries, tools, + plugins). The Qt framework exports a number of variables which can be used by ports, some of them listed below: @@ -2673,8 +2668,7 @@ GLIB_SCHEMAS= org.regexxer.gschema.xml and plugin components are specified with the _run suffix. The most commonly used components are listed below (all available components are - listed in _USE_QT_ALL, - _USE_QT4_ONLY, and + listed in _USE_QT_ALL, and _USE_QT5_ONLY in /usr/ports/Mk/Uses/qt.mk): @@ -2691,59 +2685,368 @@ GLIB_SCHEMAS= org.regexxer.gschema.xml + 3d + Qt3D module + + + + assistant + Qt 5 documentation browser + + + + canvas3d + Qt canvas3d module + + + + charts + Qt 5 charts module + + + + concurrent + Qt multi-threading module + + + + connectivity + Qt connectivity (Bluetooth/NFC) module + + + core - core library (Qt 5 only) + Qt core non-graphical module - corelib - core library (Qt 4 only) + datavis3d + Qt 5 3D data visualization module dbus - Qt DBus library + Qt D-Bus inter-process communication + module + declarative + Qt declarative framework for dynamic user + interfaces + + + + designer + Qt 5 graphical user interface designer + + + + diag + Tool for reporting diagnostic information about + Qt and its environment + + + + doc + Qt 5 documentation + + + + examples + Qt 5 examples sourcecode + + + + gamepad + Qt 5 Gamepad Module + + + + graphicaleffects + Qt Quick graphical effects + + + gui - graphical user interface library + Qt graphical user interface module + help + Qt online help integration module + + + + l10n + Qt localized messages + + + + linguist + Qt 5 translation tool + + + + location + Qt location module + + + + multimedia + Qt audio, video, radio and camera support + module + + + network - network library + Qt network module + networkauth + Qt network auth module + + + opengl - Qt OpenGL library + Qt 5-compatible OpenGL support module + paths + Command line client to QStandardPaths + + + + phonon4 + KDE multimedia framework + + + + pixeltool + Qt 5 screen magnifier + + + + plugininfo + Qt5 plugin metadata dumper + + + + printsupport + Qt print support module + + + + qdbus + Qt command-line interface to D-Bus + + + + qdbusviewer + Qt 5 graphical interface to D-Bus + + + + qdoc + Qt documentation generator + + + + qdoc-data + QDoc configuration files + + + + qev + Qt QWidget events introspection tool + + + + qmake + Qt Makefile generator + + + + quickcontrols + Set of controls for building complete interfaces + in Qt Quick + + + + quickcontrols2 + Set of controls for building complete interfaces + in Qt Quick + + + + remoteobjects + Qt5 SXCML module + + + script - script library + Qt 4-compatible scripting module + scripttools + Qt Script additional components + + + + scxml + Qt5 SXCML module + + + + sensors + Qt sensors module + + + + serialbus + Qt functions to access industrial bus + systems + + + + serialport + Qt functions to access serial ports + + + + speech + Accessibilty features for Qt5 + + + sql - SQL library + Qt SQL database integration module + sql-ibase + Qt InterBase/Firebird database plugin + + + + sql-mysql + Qt MySQL database plugin + + + + sql-odbc + Qt Open Database Connectivity plugin + + + + sql-pgsql + Qt PostgreSQL database plugin + + + + sql-sqlite2 + Qt SQLite 2 database plugin + + + + sql-sqlite3 + Qt SQLite 3 database plugin + + + + sql-tds + Qt TDS Database Connectivity database + plugin + + + + svg + Qt SVG support module + + + testlib - unit testing library + Qt unit testing module + uiplugin + Custom Qt widget plugin interface for Qt + Designer + + + + uitools + Qt Designer UI forms support module + + + + virtualkeyboard + Qt 5 Virtual Keyboard Module + + + + wayland + Qt5 wrapper for Wayland + + + + webchannel + Qt 5 library for integration of C++/QML with + HTML/js clients + + + + webengine + Qt 5 library to render web content + + + webkit - Qt WebKit library + QtWebKit with a more modern WebKit code + base + websockets + Qt implementation of WebSocket protocol + + + + websockets-qml + Qt implementation of WebSocket protocol (QML + bindings) + + + + webview + Qt component for displaying web content + + + + widgets + Qt C++ widgets module + + + + x11extras + Qt platform-specific features for X11-based + systems + + + xml - Qt XML library + Qt SAX and DOM implementations + + + xmlpatterns + Qt support for XPath, XQuery, XSLT and XML + Schema + @@ -2765,49 +3068,22 @@ GLIB_SCHEMAS= org.regexxer.gschema.xml - qmake - Makefile generator/build utility - - - buildtools build tools (moc, - rcc), needed for almost - every Qt application (Qt 5 only) + rcc), needed for almost every + Qt application. linguisttools localization tools: lrelease, - lupdate (Qt 5 only) + lupdate - linguist - localization tools: lrelease, - lupdate (Qt 4 only) + qmake + Makefile generator/build utility - - - moc - meta object compiler, needed for almost - every Qt application at buildtime (Qt 4 only) - - - - rcc - resource compiler, needed if the application - comes with *.rc or - *.qrc files (Qt 4 only) - - - - uic - user interface compiler, needed if the - application comes with *.ui - files, in practice, every Qt - application with a GUI (Qt 4 only) - @@ -2825,12 +3101,6 @@ GLIB_SCHEMAS= org.regexxer.gschema.xml - iconengines - SVG icon engine plugin, needed if the application - ships SVG icons (Qt 4 only) - - - imageformats plugins for TGA, TIFF, and MNG image formats @@ -2839,23 +3109,23 @@ GLIB_SCHEMAS= org.regexxer.gschema.xml - - Selecting Qt 4 Components + + Selecting Qt 5 Components - In this example, the ported application uses the Qt 4 - graphical user interface library, the Qt 4 core library, - all of the Qt 4 code generation tools and Qt 4's Makefile + In this example, the ported application uses the Qt 5 + graphical user interface library, the Qt 5 core library, + all of the Qt 5 code generation tools and Qt 5's Makefile generator. Since the gui library implies a dependency on the core library, - corelib does not need to be specified. - The Qt 4 code generation tools moc, - uic and rcc, as well - as the Makefile generator qmake are + core does not need to be specified. + The Qt 5 code generation tools moc, + uic and rcc, as well + as the Makefile generator qmake are only needed at buildtime, thus they are specified with the _build suffix: - USES= qt:4 -USE_QT= gui moc_build qmake_build rcc_build uic_build + USES= qt:5 +USE_QT= gui buildtools_build qmake_build @@ -2992,12 +3262,8 @@ PLIST_SUB+= QT_INCDIR=${QT_INCDIR_REL} \ <literal>USES= qmake</literal> Example This snippet demonstrates the use of - qmake for a Qt 4 port: + qmake for a Qt 5 port: - USES= qmake:outsource qt:4 -USE_QT= moc_build - - For a Qt 5 port: USES= qmake:outsource qt:5 USE_QT= buildtools_build @@ -3040,11 +3306,11 @@ USE_QT= buildtools_build Using KDE - - KDE 4 Variable Definitions + + KDE Variable Definitions - If the application depends on KDE 4, set - USES+=kde:4 and + If the application depends on KDE, set + USES+=kde:5 and USE_KDE to the list of required components. _build and _run suffixes can be used to force @@ -3052,13 +3318,12 @@ USE_QT= buildtools_build baseapps_run). If no suffix is set, a default dependency type will be used. To force both types, add the component twice with both suffixes (for example, - automoc4_build automoc4_run). The most - commonly used components are listed below (up-to-date - components are documented at the top of - /usr/ports/Mk/bsd.kde4.mk): + ecm_build ecm_run). Available components + are listed below (up-to-date components are also listed in + /usr/ports/Mk/Uses/kde.mk): - Available KDE 4 Components + Available KDE Components @@ -3070,46 +3335,615 @@ USE_QT= buildtools_build - kdehier - Hierarchy of common KDE directories + activities + KF5 runtime and library to organize work in + separate activities - kdelibs - KDE core libraries + activities-stats + KF5 statistics for activities - kdeprefix - If set, port will be installed into - ${KDE_PREFIX} + activitymanagerd + System service to manage user's activities, track + the usage patterns - automoc4 - Build tool to automatically generate moc + akonadi + Storage server for KDE-Pim + + + + akonadicalendar + Akonadi Calendar Integration + + + + akonadiconsole + Akonadi management and debugging console + + + + akonadicontacts + Libraries and daemons to implement Contact + Management in Akonadi + + + + akonadiimportwizard + Import data from other mail clients to + KMail + + + + akonadimime + Libraries and daemons to implement basic email + handling + + + + akonadinotes + KDE library for accessing mail storages in MBox + format + + + + akonadisearch + Libraries and daemons to implement searching in + Akonadi + + + + akregator + A Feed Reader by KDE + + + + alarmcalendar + KDE API for KAlarm alarms + + + + apidox + KF5 API Documentation Tools + + + + archive + KF5 library that provides classes for handling + archive formats + + + + attica + Open Collaboration Services API library KDE5 + version + + + + attica5 + Open Collaboration Services API library KDE5 + version + + + + auth + KF5 abstraction to system policy and + authentication features + + + + baloo + KF5 Framework for searching and managing user + metadata + + + + baloo-widgets + BalooWidgets library + + + + baloo5 + KF5 Framework for searching and managing user + metadata + + + + blog + KDE API for weblogging access + + + + bookmarks + KF5 library for bookmarks and the XBEL + format + + + + breeze + Plasma5 artwork, styles and assets for the Breeze + visual style + + + + breeze-gtk + Plasma5 Breeze visual style for Gtk + + + + breeze-icons + Breeze icon theme for KDE + + + + calendarcore + KDE calendar access library + + + + calendarsupport + Calendar support libraries for KDEPim + + + + calendarutils + KDE utility and user interface functions for + accessing calendar + + + + codecs + KF5 library for string manipulation + + + + completion + KF5 text completion helpers and widgets + + + + config + KF5 widgets for configuration dialogs + + + + configwidgets + KF5 widgets for configuration dialogs + + + + contacts + KDE api to manage contact information + + + + coreaddons + KF5 addons to QtCore + + + + crash + KF5 library to handle crash analysis and bug + report from apps + + + + dbusaddons + KF5 addons to QtDBus + + + + decoration + Plasma5 library to create window + decorations + + + + designerplugin + KF5 integration of Frameworks widgets in Qt + Designer/Creator + + + + discover + Plasma5 package management tools + + + + dnssd + KF5 abstraction to system DNSSD features + + + + doctools + KF5 documentation generation from docbook + + + + drkonqi + Plasma5 crash handler + + + + ecm + Extra modules and scripts for CMake + + + + emoticons + KF5 library to convert emoticons + + + + eventviews + Event view libriares for KDEPim + + + + filemetadata + KF5 library for extracting file metadata + + + + frameworkintegration + KF5 workspace and cross-framework integration + plugins + + + + gapi + KDE based library to access google + services + + + + globalaccel + KF5 library to add support for global workspace + shortcuts + + + + grantlee-editor + Editor for Grantlee themes + + + + grantleetheme + KDE PIM grantleetheme + + + + gravatar + Library for gravatar support + + + + guiaddons + KF5 addons to QtGui + + + + holidays + KDE library for calendar holidays + + + + hotkeys + Plasma5 library for hotkeys + + + + i18n + KF5 advanced internationalization + framework + + + + iconthemes + KF5 library for handling icons in + applications + + + + identitymanagement + KDE pim identities + + + + idletime + KF5 library for monitoring user activity + + + + imap + KDE API for IMAP support + + + + incidenceeditor + Incidence editor libriares for KDEPim + + + + infocenter + Plasma5 utility providing system + information + + + + init + KF5 process launcher to speed up launching KDE + applications + + + + itemmodels + KF5 models for Qt Model/View system + + + + itemviews + KF5 widget addons for Qt Model/View + + + + jobwidgets + KF5 widgets for tracking KJob instance + + + + js + KF5 library providing an ECMAScript + interpreter + + + + jsembed + KF5 library for binding JavaScript objects to + QObjects + + + + kaddressbook + KDE contact manager + + + + kalarm + Personal alarm scheduler + + + + kalarm + Personal alarm scheduler + + + + kate + Basic editor framework for the KDE system + + + + kcmutils + KF5 utilities for working with KCModules + + + + kde-cli-tools + Plasma5 non-interactive system tools + + + + kde-gtk-config + Plasma5 GTK2 and GTK3 configurator + + + + kdeclarative + KF5 library providing integration of QML and KDE + Frameworks + + + + kded + KF5 extensible daemon for providing system level + services + + + + kdelibs4support + KF5 porting aid from KDELibs4 + *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***