Index: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml =================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml @@ -2593,15 +2593,10 @@ 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 @@ 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 @@ + 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 @@ - 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 @@ - 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 @@ - - 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 @@ <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 @@ 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 @@ 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 @@ - 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 + + + + kdepim-addons + KDE PIM addons + + + + kdepim-apps-libs + KDE PIM mail related libraries + + + + kdepim-runtime5 + KDE PIM tools and services + + + + kdeplasma-addons + Plasma5 addons to improve the Plasma + experience + + + + kdesu + KF5 integration with su for elevated + privileges + + + + kdewebkit + KF5 library providing integration of + QtWebKit + + + + kgamma5 + Plasma5 monitor's gamma settings + + + + khtml + KF5 KTHML rendering engine + + + + kimageformats + KF5 library providing support for additional + image formats + + + + kio + KF5 resource and network access + abstraction + + + + kirigami2 + QtQuick based components set + + + + kitinerary + Data Model and Extraction System for Travel + Reservation information + + + + kmail + KDE mail client + + + + kmail + KDE mail client + + + + kmail-account-wizard + KDE mail account wizard + + + + kmenuedit + Plasma5 menu editor + + + + knotes + Popup notes + + + + kontact + KDE Personal Information Manager + + + + kontact + KDE Personal Information Manager + + + + kontactinterface + KDE glue for embedding KParts into + Kontact + + + + korganizer + Calendar and scheduling Program + + + + kpimdav + A DAV protocol implementation with KJobs + + + + kpkpass + Library to deal with Apple Wallet pass files - akonadi - Storage server for KDE PIM data + kross + KF5 multi-language application scripting - soprano - Library for Resource Description Framework - (RDF) + kscreen + Plasma5 screen management library - strigi - Strigi desktop search library + kscreenlocker + Plasma5 secure lock screen architecture + ksmtp + Job-based library to send email through an SMTP + server + + + + ksshaskpass + Plasma5 ssh-add frontend + + + + ksysguard + Plasma5 utility to track and control the running + processes + + + + kwallet-pam + Plasma5 KWallet PAM Integration + + + + kwayland-integration + Integration plugins for a Wayland-based + desktop + + + + kwin + Plasma5 window manager + + + + kwrited + Plasma5 daemon listening for wall and write + messages + + + + ldap + LDAP access API for KDE + + + libkcddb - KDE CDDB (compact disc database) library + KDE CDDB library @@ -3119,19 +3953,29 @@ - libkdeedu - Libraries used by educational - applications + libkdcraw + LibRaw interface for KDE - libkdcraw - KDE LibRaw library + libkdegames + Libraries used by KDE games + libkdepim + KDE PIM Libraries + + + + libkeduvocdocument + Library for reading and writing vocabulary + files + + + libkexiv2 - KDE Exiv2 library + Exiv2 library interface for KDE @@ -3140,96 +3984,349 @@ - libkonq - Konqueror core library + libkleo + Certificate manager for KDE libksane - KDE SANE ("Scanner Access Now Easy") - library + SANE library interface for KDE - pimlibs - Personal information management libraries + libkscreen + Plasma5 screen management library - kate - Advanced text editor framework + libksieve + Sieve libriares for KDEPim + libksysguard + Plasma5 library to track and control running + processes + + + + mailcommon + Common libriares for KDEPim + + + + mailimporter + Import mbox files to KMail + + + + mailtransport + KDE library to managing mail transport + + + marble - Virtual globe and world atlas + Virtual globe and world atlas for KDE + mbox + KDE library for accessing mail storages in MBox + format + + + + mbox-importer + Import mbox files to KMail + + + + mediaplayer + KF5 plugin interface for media player + features + + + + messagelib + Library for handling messages + + + + milou + Plasma5 Plasmoid for search + + + + mime + Library for handling MIME data + + + + newstuff + KF5 library for downloading application assets + from the network + + + + notifications + KF5 abstraction for system notifications + + + + notifyconfig + KF5 configuration system for KNotify + + + okular - Universal document viewer + KDE universal document viewer - korundum - KDE Ruby bindings + oxygen + Plasma5 Oxygen style - perlkde - KDE Perl bindings + oxygen-icons5 + The Oxygen icon theme for KDE - pykde4 - KDE Python bindings + package + KF5 library to load and install packages - pykdeuic4 - PyKDE user interface compiler + parts + KF5 document centric plugin system - smokekde - KDE SMOKE libraries + people + KF5 library providing access to contacts + + + pim-data-exporter + Import and export KDE PIM settings + + + + pimcommon + Common libriares for KDEPim + + + + pimtextedit + KDE library for PIM-specific text editing + utilities + + + + plasma-browser-integration + Plasma5 components to integrate browsers into the + desktop + + + + plasma-desktop + Plasma5 plasma desktop + + + + plasma-framework + KF5 plugin based UI runtime used to write user + interfaces + + + + plasma-integration + Qt Platform Theme integration plugins for the + Plasma workspaces + + + + plasma-pa + Plasma5 Plasma pulse audio mixer + + + + plasma-sdk + Plasma5 applications useful for Plasma + development + + + + plasma-workspace + Plasma5 Plasma workspace + + + + plasma-workspace-wallpapers + Plasma5 wallpapers + + + + plotting + KF5 lightweight plotting framework + + + + polkit-kde-agent-1 + Plasma5 daemon providing a polkit authentication + UI + + + + powerdevil + Plasma5 tool to manage the power consumption + settings + + + + prison + API to produce barcodes + + + + pty + KF5 pty abstraction + + + + purpose + Offers available actions for a specific + purpose + + + + qqc2-desktop-style + Qt QuickControl2 style for KDE + + + + runner + KF5 parallelized query system + + + + service + KF5 advanced plugin and service + introspection + + + + solid + KF5 hardware integration and detection + + + + sonnet + KF5 plugin-based spell checking library + + + + syndication + KDE RSS feed handling library + + + + syntaxhighlighting + KF5 syntax highlighting engine for structured + text and code + + + + systemsettings + Plasma5 system settings + + + + texteditor + KF5 advanced embeddable text editor + + + + textwidgets + KF5 advanced text editing widgets + + + + threadweaver + KF5 addons to QtDBus + + + + tnef + KDE API for the handling of TNEF data + + + + unitconversion + KF5 library for unit conversion + + + + user-manager + Plasma5 user manager + + + + wallet + KF5 secure and unified container for user + passwords + + + + wayland + KF5 Client and Server library wrapper for the + Wayland libraries + + + + widgetsaddons + KF5 addons to QtWidgets + + + + windowsystem + KF5 library for access to the windowing + system + + + + xmlgui + KF5 user configurable main windows + + + + xmlrpcclient + KF5 interaction with XMLRPC services +
- KDE 4 ports are installed into - KDE_PREFIX. This is - achieved by specifying the kdeprefix - component, which overrides the default - PREFIX. The ports, however, respect any - PREFIX set via the MAKEFLAGS - environment variable and/or make - arguments. Currently KDE_PREFIX - is identical to the default PREFIX, - ${LOCALBASE}. - - + <varname>USE_KDE</varname> Example - This is a simple example for a KDE 4 port. + This is a simple example for a KDE port. USES= cmake instructs the port to utilize CMake, a - configuration tool widely used by KDE 4 projects (see + configuration tool widely used by KDE projects (see for detailed usage). USE_KDE brings dependency on KDE - libraries and makes port using - automoc4 at build stage. - Required KDE components and other dependencies can be - determined through configure log. + libraries. Required KDE components and other dependencies + can be determined through the configure log. USE_KDE does not imply USE_QT. If a port requires some - Qt 4 components, specify them in + Qt components, specify them in USE_QT. - USES= cmake kde:4 qt:4 -USE_KDE= kdelibs kdeprefix automoc4 -USE_QT= moc_build qmake_build rcc_build uic_build + USES= cmake kde:5 qt:5 +USE_KDE= ecm +USE_QT= core buildtools_build qmake_build Index: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml =================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml @@ -1227,18 +1227,14 @@ <literal>grantlee</literal> - Possible arguments: 4, - 5, selfbuild + Possible arguments: 5, + selfbuild Handle dependency on Grantlee. - Specify 4 to depend on the - Qt4 based version, devel/grantlee. Specify - 5 to depend on the + Specify 5 to depend on the Qt5 based version, devel/grantlee5. selfbuild is used internally by devel/grantlee and devel/grantlee5 to get their versions numbers. @@ -1397,8 +1393,7 @@ <literal>kde</literal> - Possible arguments: 4, - 5 + Possible arguments: 5 Add dependency on KDE components. See for more information. @@ -2719,8 +2714,8 @@ <literal>qt</literal> - Possible arguments: 4, - 5, no_env + Possible arguments: 5, + no_env Add dependency on Qt components. no_env is passed directly to