Package policies - Revision history

Prabuanand: updated wikilink

2025-10-03T14:53:18Z

updated wikilink

← Older revision		Revision as of 14:53, 3 October 2025
Line 1:		Line 1:
	~~The Alpine Linux Package Policies~~ page ~~describe some of~~ the policies when creating packages based on the following references:		This page documents the policies to be followed by [[Package Maintainers]] when creating or updating packages. These instructions are based on the following references:
	* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/CODINGSTYLE.md?ref_type=heads aports/CODINGSTYLE.md]		* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/CODINGSTYLE.md?ref_type=heads aports/CODINGSTYLE.md]
	* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/COMMITSTYLE.md?ref_type=heads aports/COMMITSTYLE.md]		* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/COMMITSTYLE.md?ref_type=heads aports/COMMITSTYLE.md]

Prabuanand: reworded for added clarity

2025-02-25T16:41:30Z

reworded for added clarity

← Older revision		Revision as of 16:41, 25 February 2025
Line 1:		Line 1:
	The Alpine Linux Package Policies page describe some of the policies when creating packages ~~from~~ the following references:		The Alpine Linux Package Policies page describe some of the policies when creating packages based on the following references:
	* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/CODINGSTYLE.md?ref_type=heads aports/CODINGSTYLE.md]		* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/CODINGSTYLE.md?ref_type=heads aports/CODINGSTYLE.md]
	* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/COMMITSTYLE.md?ref_type=heads aports/COMMITSTYLE.md]		* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/COMMITSTYLE.md?ref_type=heads aports/COMMITSTYLE.md]

Prabuanand: rephrased sentence

2025-02-25T16:40:51Z

rephrased sentence

← Older revision		Revision as of 16:40, 25 February 2025
Line 1:		Line 1:
	The Alpine Linux Package Policies page describe some of the policies when creating packages~~. The policies are based on~~ the following ~~two~~ references:		The Alpine Linux Package Policies page describe some of the policies when creating packages from the following references:
	* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/CODINGSTYLE.md?ref_type=heads aports/CODINGSTYLE.md]		* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/CODINGSTYLE.md?ref_type=heads aports/CODINGSTYLE.md]
	* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/COMMITSTYLE.md?ref_type=heads aports/COMMITSTYLE.md]		* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/COMMITSTYLE.md?ref_type=heads aports/COMMITSTYLE.md]

Prabuanand: rearranged the list

2025-02-25T15:58:26Z

rearranged the list

← Older revision		Revision as of 15:58, 25 February 2025
Line 1:		Line 1:
	The Alpine Linux Package Policies page describe some of the policies when creating packages. The policies are based on the following two references:		The Alpine Linux Package Policies page describe some of the policies when creating packages. The policies are based on the following two references:
			* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/CODINGSTYLE.md?ref_type=heads aports/CODINGSTYLE.md]
	* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/COMMITSTYLE.md?ref_type=heads aports/COMMITSTYLE.md]		* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/COMMITSTYLE.md?ref_type=heads aports/COMMITSTYLE.md]
	* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/CODINGSTYLE.md?ref_type=heads aports/CODINGSTYLE.md]

	== Package Names ==		== Package Names ==

Prabuanand: added reference to COMMITSTYLE.md and CODINGSTYLE.md

2025-02-25T15:34:25Z

added reference to COMMITSTYLE.md and CODINGSTYLE.md

← Older revision		Revision as of 15:34, 25 February 2025
Line 1:		Line 1:
	The Alpine Linux Package Policies describe some of the policies when creating packages.		The Alpine Linux Package Policies page describe some of the policies when creating packages. The policies are based on the following two references:
			* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/COMMITSTYLE.md?ref_type=heads aports/COMMITSTYLE.md]
			* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/CODINGSTYLE.md?ref_type=heads aports/CODINGSTYLE.md]

	== Package Names ==		== Package Names ==

	* All package names should be lowercase.		* All package names should be lowercase.
	* Development files are placed in subpackages with ''-dev'' suffix (e.g. uclibc-dev)		* Development files are placed in subpackages with ''-dev'' suffix (e.g. uclibc-dev)
Line 14:		Line 17:

	== Package versions ==		== Package versions ==

	* Package versions are similar to gentoo or other distributions, e.g. 10.2.33, 4.5_alpha, 20200712-r0:		* Package versions are similar to gentoo or other distributions, e.g. 10.2.33, 4.5_alpha, 20200712-r0:
	# See [https://semver.org Semantic Versioning]		# See [https://semver.org Semantic Versioning]
Line 22:		Line 26:

	== Licensing ==		== Licensing ==

	* The license identifier used is the short-identifier [https://spdx.org/licenses/ SPDX].		* The license identifier used is the short-identifier [https://spdx.org/licenses/ SPDX].
	* The license of the program should be based on the licenses approved by the [https://www.gnu.org/philosophy/license-list.html#GPLCompatibleLicenses Free Software Foundation] or [https://www.opensource.org/licenses/ OSI].		* The license of the program should be based on the licenses approved by the [https://www.gnu.org/philosophy/license-list.html#GPLCompatibleLicenses Free Software Foundation] or [https://www.opensource.org/licenses/ OSI].
	* If you are unsure about the license, please ask in our [[IRC]] channel.		* If you are unsure about the license, please ask in our [[IRC]] channel.

			== See also ==

			* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/COMMITSTYLE.md?ref_type=heads aports/COMMITSTYLE.md]
			* [https://gitlab.alpinelinux.org/alpine/aports/-/blob/master/CODINGSTYLE.md?ref_type=heads aports/CODINGSTYLE.md]

	[[Category:Development]]		[[Category:Development]]

Zcrayfish: /* Package Names */ Remove reference to RfD article.

2023-08-26T05:25:09Z

Package Names: Remove reference to RfD article.

← Older revision		Revision as of 05:25, 26 August 2023
Line 7:		Line 7:
	* Lua modules (not applications) are prefixed with ''lua-''. (e.g. lua-posix)		* Lua modules (not applications) are prefixed with ''lua-''. (e.g. lua-posix)
	* Perl modules (not applications) are prefixed with ''perl-''. (e.g. perl-xml-parser)		* Perl modules (not applications) are prefixed with ''perl-''. (e.g. perl-xml-parser)
	* Python 2 modules (not applications) are prefixed with ''py2-''. (e.g. py2-libxml2)		* Python 2 modules (not applications) are prefixed with ''py2-''. (e.g. py2-libxml2) (Python3 is used exclusively in current alpine versions)
	* ~~[[TODO:py3 packages\|~~Python 3]] modules (not applications) are prefixed with ''py3-''. (e.g. py3-libxml2)		* Python 3 modules (not applications) are prefixed with ''py3-''. (e.g. py3-libxml2)
	* Kernels and third party modules should be suffixed with the kernel flavor. (e.g., ''-grsec'', ''-vserver'').		* Kernels and third party modules should be suffixed with the kernel flavor. (e.g., ''-grsec'', ''-vserver'').
	# Don't use ''-'' sign in kernel flavor name.		# Don't use ''-'' sign in kernel flavor name.

Sertonix: use https links

2023-08-25T02:40:54Z

use https links

← Older revision		Revision as of 02:40, 25 August 2023
Line 23:		Line 23:
	== Licensing ==		== Licensing ==
	* The license identifier used is the short-identifier [https://spdx.org/licenses/ SPDX].		* The license identifier used is the short-identifier [https://spdx.org/licenses/ SPDX].
	* The license of the program should be based on the licenses approved by the [~~http~~://www.gnu.org/philosophy/license-list.html#GPLCompatibleLicenses Free Software Foundation] or [~~http~~://www.opensource.org/licenses/ OSI].		* The license of the program should be based on the licenses approved by the [https://www.gnu.org/philosophy/license-list.html#GPLCompatibleLicenses Free Software Foundation] or [https://www.opensource.org/licenses/ OSI].
	* If you are unsure about the license, please ask in our [[IRC]] channel.		* If you are unsure about the license, please ask in our [[IRC]] channel.

	[[Category:Development]]		[[Category:Development]]

Bitminer at 15:25, 13 May 2021

2021-05-13T15:25:26Z

← Older revision		Revision as of 15:25, 13 May 2021
Line 17:		Line 17:
	# See [https://semver.org Semantic Versioning]		# See [https://semver.org Semantic Versioning]
	# Alpha, release candidates (_rc2), etc are prefixed with underscore ''_'' not a hyphen.		# Alpha, release candidates (_rc2), etc are prefixed with underscore ''_'' not a hyphen.
	# Subsequent ~~fixes~~ are ''-r0'', ''-r1'', and so on, ~~if they don~~'~~t change the version~~.		# Subsequent package versions are ''-r0'', ''-r1'', and so on; the number is from $pkgver.
			# Subsequent package fixes are ''_p0'', ''_p1''.
	# Test your proposed version with ''apk'', for example ''apk version --check 3.2.1-rcN''. The result is nothing if it is valid.		# Test your proposed version with ''apk'', for example ''apk version --check 3.2.1-rcN''. The result is nothing if it is valid.

Bitminer: Explain versioning in more detail; remind how to check with apk

2021-05-12T19:41:33Z

Explain versioning in more detail; remind how to check with apk

← Older revision		Revision as of 19:41, 12 May 2021
Line 14:		Line 14:

	== Package versions ==		== Package versions ==
	* Package versions are similar to gentoo.		* Package versions are similar to gentoo or other distributions, e.g. 10.2.33, 4.5_alpha, 20200712-r0:
			# See [https://semver.org Semantic Versioning]
			# Alpha, release candidates (_rc2), etc are prefixed with underscore ''_'' not a hyphen.
			# Subsequent fixes are ''-r0'', ''-r1'', and so on, if they don't change the version.
			# Test your proposed version with ''apk'', for example ''apk version --check 3.2.1-rcN''. The result is nothing if it is valid.

	== Licensing ==		== Licensing ==

Leo: /* Licensing */

2019-05-25T03:40:00Z

Licensing

← Older revision		Revision as of 03:40, 25 May 2019
Line 17:		Line 17:

	== Licensing ==		== Licensing ==
	* The license identifier used is [https://spdx.org/licenses/ SPDX].		* The license identifier used is the short-identifier [https://spdx.org/licenses/ SPDX].
	* The license of the program should be based on the licenses approved by the [http://www.gnu.org/philosophy/license-list.html#GPLCompatibleLicenses Free Software Foundation] or [http://www.opensource.org/licenses/ OSI].		* The license of the program should be based on the licenses approved by the [http://www.gnu.org/philosophy/license-list.html#GPLCompatibleLicenses Free Software Foundation] or [http://www.opensource.org/licenses/ OSI].
	* If you are unsure about the license, please ask in our [[IRC]] channel.		* If you are unsure about the license, please ask in our [[IRC]] channel.

	[[Category:Development]]		[[Category:Development]]