summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README80
1 files changed, 42 insertions, 38 deletions
diff --git a/README b/README
index aa60b51..358868f 100644
--- a/README
+++ b/README
@@ -1,40 +1,44 @@
# How to Blacklist a package (adapted from [1]Parabola GNU/Linux-Libre Wiki)
-if you find a package that contains, uses or recommends nonfree
+If you find a package that contains, uses or recommends nonfree
software, it should be added to blacklist.txt until a way to free it
-is found. more generally, any package in violation to the [2]FSDG
-belongs in blacklist.txt
-
-other packages should be added to your-privacy-blacklist.txt,
-your-freedom_emu-blacklist.txt or both if they endanger privacy or
-only exist for the sake of using nonfree software; respectively. see
-[3] and [4] for more info.
-
-## Preferred method (blacklisting the package)
-
- * if you don't have [5]git access:
- * ask for it, or
- * send a patch produced using `git format-patch` to dev@lists.parabola.nu
- * if you do:
- 1. if possible, start by making a [6]replacement available for all
- the affected architectures (packages in
- your-freedom_emu-blacklist.txt are not meant to have a
- replacement), or [7]report a bug if the package could be
- changed to be free (read next section)
- 2. pull [8]blacklist.git
- 3. add package according to the SYNTAX file
- 4. push changes
- 5. ssh into repo.parabola.nu and run db-check-nonfree
- 6. pull [9]abslibre.git and make a new release of the
- corresponding blacklist package (e.g. your-freedom)
-
-## Alternative method (reporting an issue)
-
- * file a bug report on the [3]Parabola Issue Tracker
- * choose the project responsible for it, nearly always "Packages"
- * choose the "Freedom issue" type and priority
- * report separate issues for appropriate projects if the package is
- included with installation media.
+is found. More generally, any package in violation to the [2]FSDG
+belongs in blacklist.txt.
+
+Other packages should be added to your-privacy-blacklist.txt, if they
+endanger privacy, or to your-freedom_emu-blacklist.txt, if they
+exist only for the purpose of emulating non-free hardware,
+for running other non-free software. See [3] and [4] for more info.
+
+## Reporting a freedom issue
+
+ 1. Open a bug report on the [5]Parabola Issue Tracker
+ 2. Choose the project responsible for it (usually "Packages")
+ 3. Choose the "Freedom issue" issue concern and priority
+ 4. Include as much detail as possible, as to why the package has freedom issues.
+
+## Blacklisting a package
+
+ 1. If there is not an existing entry on the [6]LOSTDNRTFSDG wiki, or some other
+ detailed report which describes the known freedom issues with the package,
+ open a bug report on the [5]Parabola Issue Tracker as described in the
+ previous section, if there is not one already. Even if there is some external
+ bug report to reference, a Parabola ticket is preferred. This will serve as a
+ discussion thread and reference for the future regarding the package.
+ 2. If possible, start by making a useable liberated [7]replacement package
+ (packages in your-freedom_emu-blacklist.txt are not meant to have a replacement).
+ The end result should be a new PKGBUILD in [8]abslibre, and a newly released
+ replacement package in the repos (usually [libre]).
+ 3. If patching is infeasible, try to find some other program that accomplishes
+ the same task. There may already be suitable alternative programs in the repos.
+ 4. If no suitable replacement can be made or found, the last resort is to blacklist
+ the package without a replacement.
+ 5. Clone or pull the latest [9]blacklist.git
+ 6. Add an entry for the package according to the SYNTAX file.
+ 7. Run the ./validate script.
+ 8. Commit and push changes to the server - autobuilder will do the rest.
+ 9. if the push is rejected, you probably forgot step #7
+
## References:
@@ -42,8 +46,8 @@ only exist for the sake of using nonfree software; respectively. see
[2]: https://www.gnu.org/distros/free-system-distribution-guidelines.html
[3]: https://wiki.parabola.nu/Nonprism
[4]: https://wiki.parabola.nu/Emulator_licensing_issues
-[5]: https://git.parabola.nu
-[6]: https://wiki.parabola.nu/Creating_-libre_packages
-[7]: https://labs.parabola.nu
-[8]: https://git.parabola.nu/blacklist.git
+[5]: https://labs.parabola.nu
+[6]: http://libreplanet.org/wiki/List_of_software_that_does_not_respect_the_Free_System_Distribution_Guidelines#
+[7]: https://wiki.parabola.nu/Creating_-libre_packages
[9]: https://git.parabola.nu/abslibre.git
+[8]: https://git.parabola.nu/blacklist.git