summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorbill-auger <mr.j.spam.me@gmail.com>2019-02-10 21:13:24 -0500
committerbill-auger <mr.j.spam.me@gmail.com>2019-02-10 23:13:04 -0500
commit869340952389eb41135e824e3f4c4d8c9bf1fe8b (patch)
tree627c8625d994dfb6f4c9d6b5286fd8f7bbf3f76b
parentf7c74823246a762f1dc7f7ca828bd5874d6427df (diff)
specify long description reference to be mandatory
-rw-r--r--SYNTAX16
1 files 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