diff options
authorLuke Shumaker <>2017-03-20 13:18:11 -0400
committerLuke Shumaker <>2017-03-20 13:18:11 -0400
commit03741d4c2a972986f3c3f3b239e17039ceab445b (patch)
parentb9f39c896ea23a4387899b8698786720e077160f (diff)
SYNTAX: clarify tag meanings.
1 files changed, 35 insertions, 5 deletions
diff --git a/SYNTAX b/SYNTAX
index 20b3855..04eae36 100644
--- a/SYNTAX
+++ b/SYNTAX
@@ -32,11 +32,41 @@ where something within [] is optional.
* short-description categorizes original-package with some tags,
followed by a short verbal explanation. Popular tags are:
- [nonfree] for blatantly nonfree packages
- [semifree] mostly free packages with some nonfree additions
- [uses-nonfree] for depending upon, or recommending nonfree software
- [branding] Arch instead of Parabola, Linux instead of GNU/Linux, etc.
- [technical] patched to build from sources. various innocent circumstances
+ [nonfree]·······This package is blatently nonfree software.
+ [semifree]······This package is mostly free, but contains some nonfree
+ software.
+ [uses-nonfree]··This package depends on, recommends, or otherwise
+ inappropriately integrates with other nonfree software
+ or services.
+ [branding]······This package has branding needs adjusted; it refers to
+ "Arch" instead of "Parabola", or "Linux" instead of
+ "GNU/Linux", etc.
+ [technical]·····This package cannot be imported from Arch because of
+ technical reasons, rather than freedom reasons; this is
+ NOT to do with freedom of privacy issues in the
+ package. This usually comes down to two things: it
+ must be recompiled against our version of a depenency
+ package, or it must be compiled from source, as we are
+ stricter about that than Arch is.
+ Either thethe original-package and the
+ libre-replacement should match; or the
+ libre-replacement should be empty, and it also have
+ [FIXME:package] on it. If neither of those are true,
+ then you are using this tag wrong. If this is the only
+ tag, and "nonfree" appears in the description, you are
+ using this tag wrong.
+ [FIXME:package] This package has a free replacement, or could be built
+ in a way that is acceptable, but no one has done so
+ yet.
+ [FIXME:description] Someone needs to fix the description in
+ blacklist.txt
To make reporting issues to gnu-linux-libre easier, we should explain
in the description if the package is blacklisted due to an upstream FSDG