provision: document become

Fixes: #2484
Signed-off-by: Carlos Rodriguez-Fernandez <[email protected]>

spec/plans/provision.fmf

@@ -36,6 +36,22 @@ example: |
         testcloud (libvirt). Testcloud takes care of downloading
         an image and making necessary changes to it for optimal
         experience (such as disabling UseDNS and GSSAPI for SSH).
+
+        image
+            qcov image name or url
+        user
+            user name to log in
+        become
+            whether to run scripts with ``sudo``, ``false`` by default
+        memory
+            memory size for vm
+        disk
+            disk size for vm
+        connection
+            either session (default) or system, to be passed to qemu
+        arch
+            architecture for the VM, host arch is the default
+
     example: |
         provision:
             how: virtual
@@ -62,6 +78,16 @@ example: |
     description:
         Download (if necessary) and start a new container using
         podman or docker.
+
+        image
+            image to use
+        user
+            user name to be used to log in, ``root`` by default
+        become
+            whether to run scripts with ``sudo``, ``false`` by default
+        force_pull
+            whether to always pull the image, ``false`` by default
+
     example: |
         provision:
             how: container
@@ -137,6 +163,8 @@ example: |
             hostname or ip address of the box
         user
             user name to be used to log in, ``root`` by default
+        become
+            whether to run scripts with ``sudo``, ``false`` by default
         password
             user password to be used to log in
         key
@@ -147,18 +175,21 @@ example: |
       - implemented-by: /tmt/steps/provision/connect.py
 
     example: |
+        # Connect to existing box with username and password
         provision:
             how: connect
             guest: hostname or ip address
             user: username
             password: password
 
+        # Connect with user ``fedora`` using a key, and ``sudo`` to run scripts
         provision:
             how: connect
             guest: hostname or ip address
+            user: fedora
+            become: true
             key: private-key-path
 
-
 /multihost:
     summary: Multihost testing specification