From 55554f032c59ffeeb03234c3a3d5c9ad75b842d0 Mon Sep 17 00:00:00 2001
From: 3np <3np@example.com>
Date: Sun, 29 Jun 2025 11:55:39 +0000
Subject: [PATCH] feat(sys-print): no netvm by default

- doc(sys-print): update README.md
---
 salt/sys-print/README.md  | 22 ++++++++++++++++++++--
 salt/sys-print/create.sls |  6 +++---
 2 files changed, 23 insertions(+), 5 deletions(-)

diff --git a/salt/sys-print/README.md b/salt/sys-print/README.md
index 71bae89..eacfc04 100644
--- a/salt/sys-print/README.md
+++ b/salt/sys-print/README.md
@@ -10,7 +10,10 @@ Printer environment in Qubes OS.
 *   [Access Control](#access-control)
 *   [Usage](#usage)
     *   [Add a printer](#add-a-printer)
+        *   [Network printers](#attaching-network-printers)
+        *   [USB printers](#attaching-usb-printers)
     *   [Print](#print)
+        *   [USB multi-function printers](#usb-multi-function-printers)
 *   [Credits](#credits)
 
 ## Description
@@ -109,21 +112,36 @@ qusal.Print * @tag:print-client @anyvm   deny
 
 ### Add a printer
 
-You will configure your printer from `sys-print` or `disp-sys-print`, it can
+You will configure your printer from `sys-print` or `disp-sys-print`. It can
 connect over the network or USB. If you do not want to save printing
 configuration, use `disp-sys-print`.
 
-On `sys-print` or `disp-sys-print`, add your printer:
+On `sys-print` or `disp-sys-print`, to add a printer after attaching it:
 
 ```sh
 system-config-printer
 ```
 
+#### Attaching network printers
+
+By default, `sys-print` and `disp-sys-print` have no NetVM.
+To access a network printer, attach a NetVM on its network to `sys-print`.
+
+#### Attaching USB printers
+
+Use `sys-usb` or `disp-sys-usb`. Identify the device by running `qvm-usb ls`
+in dom0 and attach it with `qvm-usb attach`.
+
 ### Print
 
 On the client, select the file to print, open it with an editor, viewer or
 browser and target the desired printer.
 
+### USB multi-function printers
+
+USB printers with both printing and scanning function can run into situations
+where [either scanning or printing does not work](https://fitzcarraldoblog.wordpress.com/2015/07/20/the-problem-of-scanning-using-usb-multi-function-printers-in-linux/).
+
 ## Credits
 
 *   [Unman](https://github.com/unman/shaker/tree/main/sys-print)
diff --git a/salt/sys-print/create.sls b/salt/sys-print/create.sls
index 3d2a102..341eec7 100644
--- a/salt/sys-print/create.sls
+++ b/salt/sys-print/create.sls
@@ -35,7 +35,7 @@ present:
 prefs:
 - template: tpl-{{ slsdotpath }}
 - label: red
-- netvm: "*default*"
+- netvm: ""
 - audiovm: ""
 - vcpus: 1
 - memory: 300
@@ -70,7 +70,7 @@ present:
 prefs:
 - template: dvm-{{ slsdotpath }}
 - label: red
-- netvm: "*default*"
+- netvm: ""
 - audiovm: ""
 - vcpus: 1
 - memory: 300
@@ -105,7 +105,7 @@ present:
 prefs:
 - template: tpl-{{ slsdotpath }}
 - label: red
-- netvm: "*default*"
+- netvm: ""
 - audiovm: ""
 - vcpus: 1
 - memory: 300