aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorKaren Arutyunov <karen@codesynthesis.com>2021-10-06 22:16:46 +0300
committerKaren Arutyunov <karen@codesynthesis.com>2021-10-07 13:20:53 +0300
commite253cd97c6a8d55a5be19731d58769f4663ab2d1 (patch)
tree44a976e7b4ac4d55212cd0b7f2c52a5bf18d8516 /doc
parented3452457b33bb7a4b2f0abb3ae1fc53f826bc9e (diff)
Add support for applying backward compatibility workarounds to packages.manifest file generated by rep-create
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.cli45
1 files changed, 39 insertions, 6 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index cbca17d..86fe17f 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -1772,12 +1772,12 @@ The repository fragment id this repository belongs to.
terminology and semantics.
The repository list manifest (the \c{repositories.manifest} file found in the
-repository root directory) describes the repository. It is a sequence of
-repository manifests consisting of the base repository manifest (that is, the
-manifest for the repository that is being described) as well as manifests for
-its prerequisite and complement repositories. The individual repository
-manifests can appear in any order and the base repository manifest can be
-omitted.
+repository root directory) describes the repository. It starts with an
+optional header manifest optionally followed by a sequence of repository
+manifests consisting of the base repository manifest (that is, the manifest
+for the repository that is being described) as well as manifests for its
+prerequisite and complement repositories. The individual repository manifests
+can appear in any order and the base repository manifest can be omitted.
The \c{fragment} values can only be present in a merged
\c{repositories.manifest} file for a multi-fragment repository.
@@ -1789,6 +1789,8 @@ repository could look like this:
# math/testing
#
: 1
+min-bpkg-version: 0.14.0
+:
email: math-pkg@example.org
summary: Math package repository
:
@@ -1814,6 +1816,37 @@ Then the completement's location would be:
https://pkg.example.org/1/math/stable
\
+The header manifest synopsis is presented next followed by the detailed
+description of each value in subsequent sections.
+
+\
+[min-bpkg-version]: <ver>
+[compression]: <compressions>
+\
+
+\h2#manifest-repository-list-header-min-bpkg-version|\c{min-bpkg-version}|
+
+\
+[min-bpkg-version]: <ver>
+\
+
+The earliest version of \cb{bpkg} that is compatible with this repository.
+Note that if specified, it must be the first value in the header.
+
+
+\h2#manifest-repository-list-header-compression|\c{compression}|
+
+\
+[compression]: <compressions>
+
+<compressions> = <compression> [ <compression>]*
+\
+
+Available compressed variants of the \c{packages.manifest} file. The format is
+a space-separated list of the compression methods. The \c{none} method means
+no compression. Absent \c{compression} value is equivalent to specifying it
+with the \c{none} value.
+
\h#manifest-signature-pkg|Signature Manifest for \cb{pkg} Repositories|