From nobody Sun Mar 05 10:14:32 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4PTyHY0FSRz3wJgc for ; Sun, 5 Mar 2023 10:14:33 +0000 (UTC) (envelope-from git@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) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4PTyHX6sykz4GNZ; Sun, 5 Mar 2023 10:14:32 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1678011273; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=mVXqoT4X/xj/geBJcAT6eXwdcPsVLK8wwK2Qc4lYJ1Y=; b=nf4lK6CWgprxQVwJs3krPXC/0xC58iK5jIXFMJJrW9XQUGb8I8eq6RIjXGD14yqf5Vt9QO 4FLvPwV1quz9lf02U40w1DgsNr5VjvuI0xc/OCKYg8DLoeve2NPOCc3bDs3O7y82iLUvrK AOtuOCXemxBKLUFYvG7/RXW7601ltY5zKg25sxvSMz8OYk45Dg6rKYhLSdkZDVPEJGZbht JIISCz/uPAlv0ruxtqkeLRVrRIfDlxgL5weAZqhgINsP6CoZWrxVbMdkHB3qIwIj8VQSQd L7lNC/gIm/qLr9cpbmEm/+dpxdwV0+xB8JcHYyfeiVbzkMXQdaBfHFl4N7mW8Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1678011273; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=mVXqoT4X/xj/geBJcAT6eXwdcPsVLK8wwK2Qc4lYJ1Y=; b=tC4poE4n5N060RLGaotg6xEwfJsUj/8w0ec0eaZlvyr1NvaH8GyEqbIypzuMMTygBgTXOA LEYeephXUM+iDw4mbf4WfwdGyLcATzmizWkS7jGOyMahZodK5SNPZCrySec2C7ftwA9roR rLEpvQPt/K02XAb7G2+mFcJb8hiGgFCkZFy7VewHwNUKWN7kckCb6Ve833fYdzwca3gxLu JLaANQaudVE9S5L9vUftUmKgVrE/hn/XSumS3/brZfItectGCKiEbNxS2eiVYxr6MYbHFC 3irq40yiIZjvSHLrgsS0HZ2DcJi460B5O5hILXwxq7IVJogJPHCXq6EtA/3qcQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1678011273; a=rsa-sha256; cv=none; b=rpllBsjnOXA+Unir7uHXVG/e3YqKcJhrxzaSB5zNZL7x5NK18fBkpIaT4A6MYAxJgNeb11 +wxjwcXbkswYgCIT+Jd350pp362werTFmiUPywkirOmLjmWPqedUXr2nC2DuaxNmYkbgQX GlkzeTOfQ9Sm4cl1wlW8YTFo9473Hdusek6GBFSz0IB23LnPqSlB5U6Y9tAWekzEeZCXHi HCt8Ixl/da2GocmQxPb/yT6JYi7OP/SD0HcWb2/wxDJNlamdmnKi3HP16B+NJrNYKbcK20 DYPudt/b2NuvLUODARwHc1YkeNlUqiuOqvMj9SZnoxJbyXNV4otdt0TxfQUG5g== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4PTyHX5dlSzHVs; Sun, 5 Mar 2023 10:14:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 325AEWDi037651; Sun, 5 Mar 2023 10:14:32 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 325AEWDb037650; Sun, 5 Mar 2023 10:14:32 GMT (envelope-from git) Date: Sun, 5 Mar 2023 10:14:32 GMT Message-Id: <202303051014.325AEWDb037650@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 689f1b026a - main - Add support of USES= budgie in Porters Handbook List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 689f1b026a02bf6d7039bdfec59353196d83ccef Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=689f1b026a02bf6d7039bdfec59353196d83ccef commit 689f1b026a02bf6d7039bdfec59353196d83ccef Author: Olivier Duchateau AuthorDate: 2023-03-05 10:12:58 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2023-03-05 10:12:58 +0000 Add support of USES= budgie in Porters Handbook With a minor tweak to improve the render from carlavilla@ Reviewed by: pauamma@, carlavilla@ Differential Revision: https://reviews.freebsd.org/D37286 --- .../en/books/porters-handbook/special/_index.adoc | 44 ++++++++++++++++++++++ .../en/books/porters-handbook/uses/_index.adoc | 9 +++++ 2 files changed, 53 insertions(+) diff --git a/documentation/content/en/books/porters-handbook/special/_index.adoc b/documentation/content/en/books/porters-handbook/special/_index.adoc index d31179deca..4ebeb7f84e 100644 --- a/documentation/content/en/books/porters-handbook/special/_index.adoc +++ b/documentation/content/en/books/porters-handbook/special/_index.adoc @@ -4431,6 +4431,50 @@ However, Xfce components and non-Xfce dependencies of the port must be included Do not count on an Xfce component to provide a sub-dependency other than itself for the main port. ==== +[[using-budgie]] +== Using Budgie + +Applications or libraries depending on the Budgie desktop should set `USES= budgie` and set `USE_BUDGIE` to the list of required components. + +[cols="1,1", frame="none", options="header"] +|=== +| Name +| Description + +| `libbudgie` +| Desktop core (library) + +| `raven` +| All-in-one center in panel for accessing different applications widgets + +| `screensaver` +| Desktop-specific screensaver + +|=== + +[NOTE] +==== +All application widgets communicate through the *org.budgie_desktop.Raven* service. + +The default dependency is lib- and run-time, it can be changed with `:build` or `:run`, for example: + +[.programlisting] +.... +USES= budgie +USE_BUDGIE= screensaver:build +.... +==== + +[[budgie-components-example]] +.`USE_BUDGIE` Example +[example] +==== +[.programlisting] +.... +USES= budgie gettext gnome meson pkgconfig +USE_BUDGIE= libbudgie +.... +==== [[using-databases]] == Using Databases diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index 58bfeedff5..bf02331dd4 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -179,6 +179,15 @@ Possible arguments: (none), `build`, `run`, `both` Uses package:devel/bison[] By default, with no arguments or with the `build` argument, it implies `bison` is a build-time dependency, `run` implies a run-time dependency, and `both` implies both run-time and build-time dependencies. +[[uses-budgie]] +== `budgie` + +Possible arguments: (none) + +Provide support for the Budgie desktop environment. +Use `USE_BUDGIE` to select the components needed for the port. +See crossref:special[using-budgie,Using Budgie] for more information. + [[uses-cabal]] == `cabal`