Gentoo Development Guide

QT4-R2.ECLASS

Section: portage (5)
Updated: May 2013
Index Return to Main Contents

NAME

qt4-r2.eclass - Eclass for Qt4-based packages, second edition.

DESCRIPTION

This eclass contains various functions that may be useful when dealing with packages using Qt4 libraries. Requires EAPI=2 or later.

FUNCTIONS

qt4-r2_src_unpack: Default src_unpack function for packages that depend on qt4. If you have to override src_unpack in your ebuild (probably you don't need to), call qt4-r2_src_unpack in it.
qt4-r2_src_prepare: Default src_prepare function for packages that depend on qt4. If you have to override src_prepare in your ebuild, you should call qt4-r2_src_prepare in it, otherwise autopatcher will not work!
qt4-r2_src_configure: Default src_configure function for packages that depend on qt4. If you have to override src_configure in your ebuild, call qt4-r2_src_configure in it.
qt4-r2_src_compile: Default src_compile function for packages that depend on qt4. If you have to override src_compile in your ebuild (probably you don't need to), call qt4-r2_src_compile in it.
qt4-r2_src_install: Default src_install function for qt4-based packages. Installs compiled code, documentation (via DOCS and HTML_DOCS variables).
eqmake4 [project_file] [parameters to qmake]: Wrapper for Qt4's qmake. If project_file isn't specified, eqmake4 will look for it in the current directory (${S}, non-recursively). If more than one project file are found, then ${PN}.pro is processed, provided that it exists. Otherwise eqmake4 fails.
All other arguments are appended unmodified to qmake command line. For recursive build systems, i.e. those based on the subdirs template, you should run eqmake4 on the top-level project file only, unless you have strong reasons to do things differently. During the building, qmake will be automatically re-invoked with the right arguments on every directory specified inside the top-level project file.

ECLASS VARIABLES

DOCS

Array containing documents passed to dodoc command. Paths can be absolute or relative to ${S}.

Example: DOCS=( ChangeLog README "${WORKDIR}/doc_folder/" )

HTML_DOCS

Array containing documents passed to dohtml command. Paths can be absolute or relative to ${S}.

Example: HTML_DOCS=( "doc/document.html" "${WORKDIR}/html_folder/" )

LANGS

In case your Qt4 application provides various translations, use this variable to specify them in order to populate "linguas_*" IUSE automatically. Make sure that you set this variable before inheriting qt4-r2 eclass.

Example: LANGS="de el it ja"

LANGSLONG

Same as LANGS, but this variable is for LINGUAS that must be in long format. Remember to set this variable before inheriting qt4-r2 eclass. Look at ${PORTDIR}/profiles/desc/linguas.desc for details.

Example: LANGSLONG="en_GB ru_RU"

PATCHES

Array variable containing all the patches to be applied. This variable is expected to be defined in the global scope of ebuilds. Make sure to specify the full path. This variable is used in src_prepare phase.

Example:

  PATCHES=(
      "${FILESDIR}/mypatch.patch"
      "${FILESDIR}/mypatch2.patch"
  )

MAINTAINERS

Qt herd <qt@gentoo.org>

REPORTING BUGS

Please report bugs via http://bugs.gentoo.org/

FILES

/usr/portage/eclass/qt4-r2.eclass

This document was created by man2html, using the manual pages.
Time: 03:25:02 GMT, May 21, 2013