From owner-freebsd-doc@FreeBSD.ORG Fri Aug 28 19:10:03 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6BDF91065679 for ; Fri, 28 Aug 2009 19:10:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 49A6A8FC26 for ; Fri, 28 Aug 2009 19:10:03 +0000 (UTC) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n7SJA3GU026956 for ; Fri, 28 Aug 2009 19:10:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n7SJA36U026955; Fri, 28 Aug 2009 19:10:03 GMT (envelope-from gnats) Resent-Date: Fri, 28 Aug 2009 19:10:03 GMT Resent-Message-Id: <200908281910.n7SJA36U026955@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Max Brazhnikov Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D6617106566C for ; Fri, 28 Aug 2009 19:02:34 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id C61508FC14 for ; Fri, 28 Aug 2009 19:02:34 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n7SJ2YX4082728 for ; Fri, 28 Aug 2009 19:02:34 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id n7SJ2YHs082727; Fri, 28 Aug 2009 19:02:34 GMT (envelope-from nobody) Message-Id: <200908281902.n7SJ2YHs082727@www.freebsd.org> Date: Fri, 28 Aug 2009 19:02:34 GMT From: Max Brazhnikov To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/138283: [patch] Porter's Handbook: add entry for KDE 4 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 28 Aug 2009 19:10:03 -0000 >Number: 138283 >Category: docs >Synopsis: [patch] Porter's Handbook: add entry for KDE 4 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Fri Aug 28 19:10:02 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Max Brazhnikov >Release: FreeBSD 7.2-STABLE i386 >Organization: >Environment: FreeBSD luna.dio.ru 7.2-STABLE FreeBSD 7.2-STABLE #2: Fri Jun 26 21:57:33 MSD 2009 root@luna.dio.ru:/usr/obj/usr/freebsd/7/src/sys/LUNA i386 >Description: split Qt and KDE sections, add some notes about KDE 4. >How-To-Repeat: >Fix: Patch attached with submission follows: Index: book.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.1025 diff -u -r1.1025 book.sgml --- book.sgml 25 Aug 2009 08:48:29 -0000 1.1025 +++ book.sgml 28 Aug 2009 18:48:02 -0000 @@ -5427,42 +5427,10 @@ - - Using KDE - - - Variable definitions - - - Variables for ports that use KDE - - - - - USE_KDELIBS_VER - - The port uses KDE libraries. It specifies the - major version of KDE to use and implies - USE_QT_VER of the appropriate - version. The only possible value is - 3. - - - - USE_KDEBASE_VER - - The port uses KDE base. It specifies the major - version of KDE to use and implies - USE_QT_VER of the appropriate version. - The only possible value is 3. - - - -
- - + + Using Qt - + Ports that require Qt @@ -5809,6 +5777,141 @@ + + Using KDE + + + Variable definitions (KDE 3.x only) + +
+ Variables for ports that use KDE 3.x + + + + + USE_KDELIBS_VER + + The port uses KDE libraries. It specifies the + major version of KDE to use and implies + USE_QT_VER of the appropriate + version. The only possible value is + 3. + + + + USE_KDEBASE_VER + + The port uses KDE base. It specifies the major + version of KDE to use and implies + USE_QT_VER of the appropriate version. + The only possible value is 3. + + + +
+ + + + + KDE 4 components + + If your application depends on KDE 4.x, set USE_KDE4 + to the list of required components. The most commonly used components are listed below + (up-to-date components are listed in _USE_KDE4_ALL in + /usr/ports/Mk/bsd.kde4.mk): + + + Available KDE4 components + + + + + Name + Description + + + + + + akonadi + Personal information management (PIM) storage service + + + + automoc4 + automoc4 build tool + + + + kdebase + Basic KDE applications (Konqueror, Dolphin, Konsole) + + + + kdeexp + Experimental KDE libraries (with non-stable API) + + + + kdehier + Provides common KDE directories + + + + kdelibs + The base set of KDE libraries + + + + kdeprefix + If set, port will be installed into + ${KDE4_PREFIX} + instead of ${LOCALBASE} + + + + pimlibs + PIM libraries + + + + workspace + Applications and libraries which form desktop (Plasma, KWin) + + + + +
+ + KDE 4.x ports are installed into ${KDE4_PREFIX}, + which is /usr/local/kde4 currently, to avoid conflicts + with KDE 3.x ports. This is achieved by specifying kdeprefix + component, which overrides default PREFIX. The ports however + respect PREFIX set via MAKEFLAGS environment + variable and/or make arguments. + + + <makevar>USE_KDE4</makevar> example + + This is a simple example for KDE 4 port. USE_CMAKE + instructs port to utilize CMake — + configuration tool widely spread among KDE 4 projects. + USE_KDE4 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. + USE_KDE4 does not imply USE_QT_VER. + If port requires some of Qt4 components, USE_QT_VER should be set + and then needed components can be specified. + + USE_CMAKE= yes +USE_KDE4= automoc4 kdelibs kdeprefix +USE_QT_VER= 4 +QT_COMPONENTS= qmake_build moc_build rcc_build uic_build + + + + + Using Java >Release-Note: >Audit-Trail: >Unformatted: