From b293a8e35437bf3bc791e69fe0bb6cbe0f40ce25 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pablo=20Correa=20G=C3=B3mez?= Date: Fri, 8 May 2026 15:28:02 +0200 Subject: [PATCH] docs: place the provides section of the packaging guidelines at the end MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit It is quite massive, and therefore let's put the simpler things first. If things keep growing, at some point it would make sense to move it out to a subpage. Signed-off-by: Pablo Correa Gómez Part-of: --- docs/packaging-guidelines.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/packaging-guidelines.md b/docs/packaging-guidelines.md index 77611881a..c6edcd005 100644 --- a/docs/packaging-guidelines.md +++ b/docs/packaging-guidelines.md @@ -1,5 +1,15 @@ # Packaging Guidelines +## Meta packages + +### Package versioning (pkgver, pkgrel) + +Packages without upstream sources are a bit special. These are `device-*` +packages and other packages like `main/postmarketos-base`, where the source +files are included in the package directory. For these packages, the `pkgver` +should always be incremented instead of the `pkgrel` (so that `pkgrel` always +is `0`). + ## Provides, priorities, alternatives, and forking packages The APK concepts around selecting conflicting packages for a same purpose, e.g: @@ -264,13 +274,3 @@ only in some specific circumstances? In those situations we have to: versioned provider to disambiguate (e.g: `provides="audio-conf=$pkgver-r$pkgrel"`), or to force the forked packages to provide a lower version than the other package. - -## Meta packages - -### Package versioning (pkgver, pkgrel) - -Packages without upstream sources are a bit special. These are `device-*` -packages and other packages like `main/postmarketos-base`, where the source -files are included in the package directory. For these packages, the `pkgver` -should always be incremented instead of the `pkgrel` (so that `pkgrel` always -is `0`).