[PATCH 3/3] losetup: (man) put the synopses in a better order, the name-giver first

Benno Schulenberg <[email protected]> Wed, 29 Oct 2025 12:03:58 +0100
Newsgroups org.kernel.vger.util-linux
Message-ID <[email protected]>
Also, condense the synopsis for setting up a loop device to just the
essentials -- it had become so long that it was incomprehensible.

Signed-off-by: Benno Schulenberg <[email protected]>
---
 sys-utils/losetup.8.adoc | 30 +++++++++++++-----------------
 1 file changed, 13 insertions(+), 17 deletions(-)

diff --git a/sys-utils/losetup.8.adoc b/sys-utils/losetup.8.adoc
index 131ebfa56..cecc09618 100644
--- a/sys-utils/losetup.8.adoc
+++ b/sys-utils/losetup.8.adoc
@@ -12,31 +12,27 @@ losetup - set up and control loop devices
 
 == SYNOPSIS
 
+Set up a loop device:
+
+*losetup* [options] *-f*|_loopdev file_
+
 Get info:
 
-*losetup* [_loopdev_]
-
-*losetup* *-l* [*-a*]
+*losetup* [*-l*] [*-a*|_loopdev_]
 
 *losetup* *-j* _file_ [*-o* _offset_]
 
-Detach a loop device:
-
-*losetup* *-d* _loopdev_ ...
-
-Detach all associated loop devices:
-
-*losetup* *-D*
-
-Set up a loop device:
-
-*losetup* [*-o* _offset_] [*--sizelimit* _size_] [*--sector-size* _size_] [*--loop-ref* _name_] [*-Pr*] [*--show*] *-f*|_loopdev file_
-
-Resize a loop device:
+Recalibrate the size of a loop device:
 
 *losetup* *-c* _loopdev_
 
-Remove a loop device:
+Detach loop devices:
+
+*losetup* *-d* _loopdev_ ...
+
+*losetup* *-D*
+
+Prevent loop devices from getting listed:
 
 *losetup* *--remove* _loopdev_ ...
 
-- 
2.51.2