From 869340952389eb41135e824e3f4c4d8c9bf1fe8b Mon Sep 17 00:00:00 2001 From: bill-auger Date: Sun, 10 Feb 2019 21:13:24 -0500 Subject: specify long description reference to be mandatory --- SYNTAX | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/SYNTAX b/SYNTAX index 4ff4e62..9da71ab 100644 --- a/SYNTAX +++ b/SYNTAX @@ -1,8 +1,6 @@ The *blacklist.txt files consist of lines in the following format: - original-package:[libre-replacement]:[ref]:[id]:short-description - -where something within [] is optional. + original-package:[libre-replacement]:ref:id:short-description * 'original-package' is the name of the binary package from Arch @@ -22,8 +20,8 @@ where something within [] is optional. parabola : https://labs.parabola.nu/issues/ The URL in the second column in above table, when concatenated with - the value of the 'id' field should form a valid URL pointing to an issue - reporting/describing the reason for the package being blacklisted. + the value of the 'id' field should form a valid URL pointing to an + associated ticket on the web. We should prefer FSF refs, since they are easily available for other distros. Hopefully some lines will move from parabola:X to fsf:Y with @@ -31,8 +29,10 @@ where something within [] is optional. * 'id' refers to a reported bug on the tracker indicated in the 'ref' column The URL in the second column in 'ref' table, when concatenated with - the value of this 'id' field should form a valid URL pointing to an issue - reporting/describing the reason for the package being blacklisted. + the value of this 'id' field should form a valid URL pointing to a + ticket on the web that describes the reason for the package being blacklisted, + and when applicable, whatever liberation procedure was used + to create a replacement package. * 'short-description' categorizes original-package with some tags, followed by a short verbal explanation. Popular tags are: @@ -68,7 +68,7 @@ where something within [] is optional. [FIXME:description] Someone needs to fix the description in blacklist.txt - To make reporting issues to gnu-linux-libre easier, we should explain + To make reporting issues to gnu-linux-libre easier, we should indicate in the description if the package is blacklisted due to an upstream FSDG issue, problem introduced by Arch (e.g. not including required license text, adding optional dependency on a non-free package), or just -- cgit v1.2.2