diff options
-rw-r--r-- | SYNTAX | 16 |
1 files changed, 8 insertions, 8 deletions
@@ -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 |