From 48bd8e8e0038e1356805cd4f30dc2b43cde728f3 Mon Sep 17 00:00:00 2001 From: Otto Liljalaakso Date: Sun, 27 Oct 2024 22:46:43 +0200 Subject: [PATCH] Document ways to declare sources and patches --- docs/manual/spec.md | 29 +++++++++++++++++++++++++---- 1 file changed, 25 insertions(+), 4 deletions(-) diff --git a/docs/manual/spec.md b/docs/manual/spec.md index 8be520c46c..5539c09d79 100644 --- a/docs/manual/spec.md +++ b/docs/manual/spec.md @@ -170,17 +170,26 @@ Short (< 70 characters) summary of the package. Used to declare source(s) used to build the package. All sources will will be packaged into source rpms. -Arbitrary number of sources may be declared, for example: +Arbitrary number of sources may be declared. A numbered source is +indexed by the given integer, while an unnumbered source is indexed by +the next available integer. +For example, these sources: ``` - Source0: mysoft-1.0.tar.gz - Source1: mysoft-data-1.0.zip + Source: mysoft-1.0.tar.gz + Source02: mysoft-data-1.0.zip + Source: next.txt + Source05: five.txt ``` +get indices 0, 2, 3, and 5. For clarity, mixing numbered and unnumbered +sources in one specfile is not recommended. + #### Patch Used to declare patches applied on top of sources. All patches declared -will be packaged into source rpms. +will be packaged into source rpms. Just like sources, patches can be +numbered or unnumbered and are indexed in the same way. #### Icon @@ -472,6 +481,18 @@ software). ### Sub-sections +#### `%sourcelist` + +List of sources, one per row. Handled like unnumbered Source tags. For +clarity, mixing Source tags and `%sourcelist` in one specfile is not +recommended. + +#### `%patchlist` + +List of patches, one per row. Handled like unnumbered Patch tags. For +clarity, mixing Patch tags and `%patchlist` in one specfile is not +recommended. + #### `%package [-n]` `%package ` starts a preamble section for a new sub-package.