Skip to content

Commit

Permalink
pkgbuild: forgot the msys2_ prefix for some keys
Browse files Browse the repository at this point in the history
  • Loading branch information
lazka committed Sep 18, 2023
1 parent 4e6441b commit cea72a9
Showing 1 changed file with 41 additions and 41 deletions.
82 changes: 41 additions & 41 deletions web/dev/pkgbuild.md
Original file line number Diff line number Diff line change
@@ -1,41 +1,41 @@
# PKGBUILD

PKGBUILD is the Arch Linux package build description file, which we inherit by
using pacman. See https://man.archlinux.org/man/PKGBUILD.5 for details on the
format.

We have some minor extensions to the format, which are documented here.

## Extra Metadata

Variables starting with `msys2_` and `mingw_` can be used to add additional metadata to a package, which will be read and used by our tools. The following datatypes are supported:

* Strings: `msys2_myvar="example"` πŸ † `{"myvar": "example"}`
* Arrays of strings: `msys2_myvar=("example1" "example2")` πŸ † `{"myvar": ["example1", "example2"]}`
* Mappings of strings to an optional string, separated by `":"`, values are
stripped: `msys2_myvar=("example1: value1" "example2")` πŸ † `{"myvar": {"example1": "value1", "example2": null}}`
* Booleans (either `true` or `false`): `msys2_myvar=true` πŸ † `{"myvar": true}`

The following variables are recognized:

* `mingw_arch` - array - a list of MSYS2 environments the package is built
for. Defaults to an empty list.
* `msys2_internal` - boolean - whether the package is an internal or meta
package, and shouldn't be linked to external sources. Defaults to `false`.
* `msys2_references` - mapping - maps the package to external resources, for
example other package repositories. Defining a key without a value means there
is no mapping. The following keys exist:
* `archlinux` - the Arch Linux package name: https://archlinux.org/packages/
* `aur` - the AUR package name: https://aur.archlinux.org/packages
* `cygwin` - the cygwin package name: https://cygwin.com/packages/src_package_list.html
* `cygwin-mingw64` -
the cygwin package name for all packages starting with "mingw64-x86_64-",
minus that prefix: https://cygwin.com/packages/src_package_list.html
* `pypi` - the PyPI project name: https://pypi.org/search/
* `changelog_url` - string - NEWS file in git or the github releases page. In
case there are multiple, the one that is more useful for packagers
* `documentation_url` - string - Documentation for the API, tools, etc. provided,
in case it's a different website than the homepage.
* `repository_url` - string - Web view of the repository, e.g. on github or gitlab
* `issue_tracker_url` - string - The bug tracker, mailing list, etc.
* `pgp_keys_url` - string - A website containing which keys are used to sign releases
# PKGBUILD

PKGBUILD is the Arch Linux package build description file, which we inherit by
using pacman. See https://man.archlinux.org/man/PKGBUILD.5 for details on the
format.

We have some minor extensions to the format, which are documented here.

## Extra Metadata

Variables starting with `msys2_` and `mingw_` can be used to add additional metadata to a package, which will be read and used by our tools. The following datatypes are supported:

* Strings: `msys2_myvar="example"` πŸ † `{"myvar": "example"}`
* Arrays of strings: `msys2_myvar=("example1" "example2")` πŸ † `{"myvar": ["example1", "example2"]}`
* Mappings of strings to an optional string, separated by `":"`, values are
stripped: `msys2_myvar=("example1: value1" "example2")` πŸ † `{"myvar": {"example1": "value1", "example2": null}}`
* Booleans (either `true` or `false`): `msys2_myvar=true` πŸ † `{"myvar": true}`

The following variables are recognized:

* `mingw_arch` - array - a list of MSYS2 environments the package is built
for. Defaults to an empty list.
* `msys2_internal` - boolean - whether the package is an internal or meta
package, and shouldn't be linked to external sources. Defaults to `false`.
* `msys2_references` - mapping - maps the package to external resources, for
example other package repositories. Defining a key without a value means there
is no mapping. The following keys exist:
* `archlinux` - the Arch Linux package name: https://archlinux.org/packages/
* `aur` - the AUR package name: https://aur.archlinux.org/packages
* `cygwin` - the cygwin package name: https://cygwin.com/packages/src_package_list.html
* `cygwin-mingw64` -
the cygwin package name for all packages starting with "mingw64-x86_64-",
minus that prefix: https://cygwin.com/packages/src_package_list.html
* `pypi` - the PyPI project name: https://pypi.org/search/
* `msys2_changelog_url` - string - NEWS file in git or the github releases page. In
case there are multiple, the one that is more useful for packagers
* `msys2_documentation_url` - string - Documentation for the API, tools, etc. provided,
in case it's a different website than the homepage.
* `msys2_repository_url` - string - Web view of the repository, e.g. on github or gitlab
* `msys2_issue_tracker_url` - string - The bug tracker, mailing list, etc.
* `msys2_pgp_keys_url` - string - A website containing which keys are used to sign releases

0 comments on commit cea72a9

Please sign in to comment.