losetup.8: Clarify --direct-io

See e.g. https://github.com/containers/bootc/pull/375#issuecomment-1981109022

The phrasing here was in my opinion technically correct but quite confusing and easy to misunderstand.

Let's be very clear:

- The default is *off*
- You can turn it on in two ways
- You can also explicitly turn it off

Signed-off-by: Colin Walters <walters@verbum.org>

diff --git a/sys-utils/losetup.8.adoc b/sys-utils/losetup.8.adoc
index 0d4ad74a985d699d5ce9b617e8e3eeb73628bf0f..9ea9451ce0b1e968377ed444e73c2bda90ad4db3 100644 (file)
--- a/sys-utils/losetup.8.adoc
+++ b/sys-utils/losetup.8.adoc
@@ -93,7 +93,7 @@ Force the kernel to scan the partition table on a newly created loop device. Not
 Set up a read-only loop device.
 
 *--direct-io*[**=on**|*off*]::
-Enable or disable direct I/O for the backing file. The optional argument can be either *on* or *off*. If the optional argument is omitted, it defaults to *on*.
+Enable or disable direct I/O for the backing file. The default is *off*. Specifying either *--direct-io* or *--direct-io=on* will enable it. But, *--direct-io=off* can be provided to explicitly turn it off.
 
 *-v*, *--verbose*::
 Verbose mode.