summaryrefslogtreecommitdiff
path: root/SYNTAX
diff options
context:
space:
mode:
Diffstat (limited to 'SYNTAX')
-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