Package policies: Difference between revisions

From Alpine Linux
(Category:Development)
(7 intermediate revisions by 7 users not shown)
Line 3: Line 3:
== 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 (i.e uclibc-dev)
* Development files are placed in subpackages with ''-dev'' suffix (e.g. uclibc-dev)
* Documentation files are placed in subpackages with ''-doc'' suffix (i.e expat-doc)
* Documentation files (incl. man pages) are placed in subpackages with ''-doc'' suffix (e.g. expat-doc)
* Lua modules (not applications) are prefixed with ''lua-''. (i.e lua-posix)
* Lua modules (not applications) are prefixed with ''lua-''. (e.g. lua-posix)
* Perl modules (not applications) are prefixed with ''perl-''. (i.e perl-xml-parser)
* Perl modules (not applications) are prefixed with ''perl-''. (e.g. perl-xml-parser)
* Python modules (not applications) are prefixed with ''py-''. (i.e py-libxml2)
* Python 2 modules (not applications) are prefixed with ''py2-''. (e.g. py2-libxml2)
* Kernels and 3rdparty modules should be suffixed with the kernel flavor. (i.e ''-grsec'' or ''-vserver'')
* [[TODO:py3 packages|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'').
# Don't use ''-'' sign in kernel flavor name.
# Specify ''KERNEL_FLAVOR_DEFAULT'' as your kernel flavor if you want boot your kernel by default.


== Package versions ==
== Package versions ==
Line 14: Line 17:


== Licensing ==
== Licensing ==
* 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]]

Revision as of 03:40, 25 May 2019

The Alpine Linux Package Policies describe some of the policies when creating packages.

Package Names

  • All package names should be lowercase.
  • Development files are placed in subpackages with -dev suffix (e.g. uclibc-dev)
  • Documentation files (incl. man pages) are placed in subpackages with -doc suffix (e.g. expat-doc)
  • 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)
  • Python 2 modules (not applications) are prefixed with py2-. (e.g. py2-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).
  1. Don't use - sign in kernel flavor name.
  2. Specify KERNEL_FLAVOR_DEFAULT as your kernel flavor if you want boot your kernel by default.

Package versions

  • Package versions are similar to gentoo.

Licensing

  • The license identifier used is the short-identifier SPDX.
  • The license of the program should be based on the licenses approved by the Free Software Foundation or OSI.
  • If you are unsure about the license, please ask in our IRC channel.