docs: Update outdated offline-updates.txt

docs/offline-updates.txt

@@ -1,9 +1,11 @@
            OFFLINE UPDATES USING PACKAGEKIT AND SYSTEMD
 
 This functionality adds the offline updates feature to PackageKit as
-described in http://freedesktop.org/wiki/Software/systemd/OSUpgrade
+described in the following URL:
 
-What do do if you're a backend:
+https://www.freedesktop.org/software/systemd/man/systemd.offline-updates.html
+
+What to do if you're a backend:
 
  * If the transaction_flags contain PREPARE then download all the
    metadata and packages for the transaction, but don't actually apply
@@ -13,24 +15,24 @@ What to do if you're a frontend:
 
  * If the /var/lib/PackageKit/prepared-update file exists then offer
    the user to:
-    - _Install updates and restart
-    - _Suspend
+    - Restart & Install Updates
+    - Suspend
    rather than just:
-    - _Suspend
- * If the user clicks "Install updates and restart" then execute
-   pkexec /usr/libexec/pk-trigger-offline-update and then restart the
-   computer the usual way.
+    - Suspend
+ * If the user clicks "Restart & Install Updates" then execute
+   'pkcon offline-trigger' and then restart the computer the usual
+   way.
 
-The next reboot will happen, the updates will be installed, and the
-computer will be restarted again.
+On the next reboot, the updates will be installed, and the computer
+will be restarted again.
 
 The /var/lib/PackageKit/prepared-update file will be automatically
 removed if the offline update succeeded, but the offline update will
 only be attempted once.
 
 The /var/lib/PackageKit/offline-update-competed file will be created
-once the pk-offline-update program has been run by systemd. For failure,
-the file will contain the following:
+once the '/usr/libexec/pk-offline-update' program has been run by
+systemd. For failure, the file will contain the following:
 
 """
 [PackageKit Offline Update Results]
@@ -44,42 +46,43 @@ For success, the file will contain the following:
 """
 [PackageKit Offline Update Results]
 Success=true
-Packages=upower;0.9.16-1.fc17;x86_64;updates,zif;0.3.0-1.fc17;x86_64;updates
+Role=update-packages
+Packages=gimp;2.10.34-1.fc38;x86_64;updates,bash;5.2.15-3.fc38;x86_64;updates
 """
 
 ________________________________________________________________________
 
                     TESTING OFFLINE UPDATES
 
  *  Ensure powertop and colorhug-client are installed and the system is
-    othewise up to date. Ensure PackageKit 0.8.1-3 or later is installed.
+    othewise up to date. Ensure PackageKit-1.0.0 or later is installed.
  *  Downgrade the powertop and colorhug-client packages on your system so
-    that you have exactly two updates when you do "pkcon get-updates"
+    that you have exactly two updates when you do 'pkcon get-updates'
  *  Download the new powertop update with:
     pkcon --only-download update powertop
- *  Observe there are no PolicyKit dialogs shown as the command completes
+ *  Observe there are no PolicyKit "Authentication Required" dialogs
+    shown as the command completes.
  *  Ensure /var/lib/PackageKit/prepared-update contains just the powertop
-    package on a single line
+    package in "prepared_ids" variable.
     [You can also use 'pkcon offline-get-prepared' to do the same thing]
  *  Download the new colorhug-client update with:
     pkcon --only-download update colorhug-client
  *  Ensure /var/lib/PackageKit/prepared-update contains both powertop and
-    colorhug-client on two lines
- *  Run pkexec /usr/libexec/pk-trigger-offline-update and confirm that
-    the system-update symlink exists on '/'.
-    [You can also use 'pkcon offline-trigger' to do the same thing]
+    colorhug-client packages in "prepared_ids" variable.
+ *  Run 'pkcon offline-trigger' and confirm that the "/system-update"
+    symlink exists.
  *  Check that /var/lib/PackageKit/offline-update-action is "reboot"
- *  Observe that pkexec ran without showing a PolicyKit dialog
- *  Run sudo PK_OFFLINE_UPDATE_TEST=1 /usr/libexec/pk-offline-update and
-    observe that the two updates are applied
+ *  Run 'sudo PK_OFFLINE_UPDATE_TEST=1 /usr/libexec/pk-offline-update'
+    and observe that the two updates are applied
  *  Confirm that /var/lib/PackageKit/prepared-update has been deleted
- *  Confirm that /var/lib/PackageKit/offline-update-competed exists
-    and no error messages have been logged.
+ *  Confirm that /var/lib/PackageKit/offline-update-competed exists,
+    contains the 2 updated packages in "Packages" variable, and no error
+    messages have been logged.
     [You can also use 'pkcon offline-status' to do the same thing]
  *  Downgrade powertop and colorhug-client again, and do:
     pkcon --only-download update powertop colorhug-client
-    pkexec /usr/libexec/pk-trigger-offline-update
+ *  Run 'pkcon offline-trigger'
  *  Reboot, and observe that the updates are applied in the special
-    system-update.service with plymouth going from 0% to 100%
+    packagekit-offline-update.service with plymouth going from 0% to 100%
  *  Confirm that the system is rebooted into a running system that has
     has the updates applied.