From: Benno Schulenberg <bensberg@telfort.nl>
Date: Wed, 29 Oct 2025 11:03:58 +0000 (+0100)
Subject: losetup: (man) put the synopses in a better order, the name-giver first
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=3cd29d861d69b70ca5390596425d4906adbf0082;p=thirdparty%2Futil-linux.git

losetup: (man) put the synopses in a better order, the name-giver first

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 <bensberg@telfort.nl>
---

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
 
-Get info:
-
-*losetup* [_loopdev_]
+Set up a loop device:
 
-*losetup* *-l* [*-a*]
+*losetup* [options] *-f*|_loopdev file_
 
-*losetup* *-j* _file_ [*-o* _offset_]
-
-Detach a loop device:
+Get info:
 
-*losetup* *-d* _loopdev_ ...
+*losetup* [*-l*] [*-a*|_loopdev_]
 
-Detach all associated loop devices:
+*losetup* *-j* _file_ [*-o* _offset_]
 
-*losetup* *-D*
+Recalibrate the size of a loop device:
 
-Set up a loop device:
+*losetup* *-c* _loopdev_
 
-*losetup* [*-o* _offset_] [*--sizelimit* _size_] [*--sector-size* _size_] [*--loop-ref* _name_] [*-Pr*] [*--show*] *-f*|_loopdev file_
+Detach loop devices:
 
-Resize a loop device:
+*losetup* *-d* _loopdev_ ...
 
-*losetup* *-c* _loopdev_
+*losetup* *-D*
 
-Remove a loop device:
+Prevent loop devices from getting listed:
 
 *losetup* *--remove* _loopdev_ ...