[PR PATCH] Manual.md: group documentation of license in one place

[voidlinux-github@inbox.vuxu.org]

[-- Attachment #1: Type: text/plain, Size: 351 bytes --]

There is a new pull request by Chocimier against master on the void-packages repository

https://github.com/Chocimier/void-packages-org license-doc
https://github.com/void-linux/void-packages/pull/14187

Manual.md: group documentation of license in one place


A patch file from https://github.com/void-linux/void-packages/pull/14187.patch is attached

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: github-pr-license-doc-14187.patch --]
[-- Type: text/x-diff, Size: 2607 bytes --]

From b73f24bc19262ce84d0f9ba70f2e2d6582d75f89 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Piotr=20W=C3=B3jcik?= <chocimier@tlen.pl>
Date: Tue, 3 Sep 2019 21:05:54 +0200
Subject: [PATCH] Manual.md: group documentation of license in one place

---
 Manual.md | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/Manual.md b/Manual.md
index d29afbd2cce..bd8830f8b46 100644
--- a/Manual.md
+++ b/Manual.md
@@ -310,9 +310,7 @@ The following functions are defined by `xbps-src` and can be used on any templat
 
 	Installs `file` into `usr/share/licenses/<pkgname>` in the pkg
 	`$DESTDIR`. The optional 2nd argument can be used to change the
-	`file name`. Note: Custom licenses,
-	non-`GPL` licenses, `MIT`, `BSD` and `ISC` require the
-	license file to	be supplied with the binary package.
+	`file name`. See [license](#var_license) for when to use it.
 
 - *vsv()* `vsv <service>`
 
@@ -401,10 +399,19 @@ The list of mandatory variables for a template:
 
 - `homepage` A string pointing to the `upstream` homepage.
 
-- `license` A string matching the license's [SPDX Short identifier](https://spdx.org/licenses),
-or string prefixed with `custom:` for licenses not listed there (see [vlicense](#vlicense)).
+
+- <a id="var_license"></a>
+`license` A string matching the license's [SPDX Short identifier](https://spdx.org/licenses),
+or string prefixed with `custom:` for licenses not listed there.
 Multiple licenses should be separated by commas, Example: `GPL-3.0-or-later, custom:Hugware`.
 
+Empty meta-packages that don't include any files
+which thus have and require no license, should have set
+`license="BSD-2-Clause"`.
+
+Note: `MIT`, `BSD`, `ISC` and custom licenses
+require the license file to be supplied with the binary package.
+
 - `maintainer` A string in the form of `name <user@domain>`.  The
   email for this field must be a valid email that you can be reached
   at.  Packages using `users.noreply.github.com` emails will not be
@@ -860,9 +867,7 @@ set in the body of the template.
 - `meta` For `meta-packages`, i.e packages that only install local files or simply
 depend on additional packages. This build style does not install
 dependencies to the root directory, and only checks if a binary package is
-available in repositories. If your meta-package doesn't include any files
-which thus have and require no license, then you should also set
-`license="BSD-2-Clause"`.
+available in repositories.
 
 - `R-cran` For packages that are available on The Comprehensive R Archive
 Network (CRAN). The build style requires the `pkgname` to start with