docs(printing): reduce default drivers

docs/printing.md

@@ -0,0 +1,57 @@
+# Printing
+
+This repo enables the CUPS printing service via `modules/system/printer.nix`, but it does **not** bundle any
+printer driver packages by default.
+
+## Opt into drivers from a host file
+
+Add driver packages to `services.printing.drivers` in your host module. Example:
+
+```nix
+# hosts/my-host.nix
+{ pkgs, ... }:
+
+{
+  services.printing.drivers = [
+    pkgs.gutenprint
+  ];
+}
+```
+
+## Driver packages (cheat sheet)
+
+Generic / common:
+
+- `pkgs.gutenprint` — various printer drivers
+- `pkgs.gutenprintBin` — various binary printer drivers
+- `pkgs.cups-filters`
+- `pkgs.cups-browsed`
+
+Brother:
+
+- `pkgs.brgenml1cupswrapper`
+- `pkgs.brgenml1lpr`
+- `pkgs.brlaser`
+
+Canon:
+
+- `pkgs.cnijfilter2` — Canon Pixma drivers
+
+Epson:
+
+- `pkgs.epson-escpr`
+- `pkgs.epson-escpr2`
+
+HP:
+
+- `pkgs.hplip`
+- `pkgs.hplipWithPlugin` — proprietary plug-ins
+
+Lexmark:
+
+- `pkgs.postscript-lexmark`
+
+Samsung:
+
+- `pkgs.samsung-unified-linux-driver`
+- `pkgs.splix` — drivers for Samsung Printer Language printers

modules/system/printer.nix

@@ -1,27 +1,5 @@
 { pkgs, ... }:
 
 {
-  services.printing = {
+  services.printing.enable = true;
-    enable = true;
-    drivers = [
-      # The generic CUPS and Gutenprint drivers usually suffice for most printers
-      # Uncomment the drivers for your printer brand in case these don't work
-
-      # pkgs.brgenml1cupswrapper # Brother printer drivers
-      # pkgs.brgenml1lpr # Brother printer drivers
-      # pkgs.brlaser # Brother laser printer drivers
-      # pkgs.cnijfilter2 # Canon Pixma drivers
-      pkgs.cups-filters
-      pkgs.cups-browsed
-      # pkgs.epson-escpr # Epson printer drivers
-      # pkgs.epson-escpr2 # Newer Epson printer drivers
-      pkgs.gutenprint # Various printer drivers
-      pkgs.gutenprintBin # Various binary printer drivers
-      # pkgs.hplip # HP printer drivers
-      # pkgs.hplipWithPlugin # HP printer drivers with proprietary plug-ins
-      # pkgs.postscript-lexmark # Lexmark printer drivers
-      # pkgs.samsung-unified-linux-driver # Samsung printer drivers
-      # pkgs.splix # Drivers for Samsung Printer Language printers
-    ];
-  };
 }