Make manual pages and usage messages more consistent

* Don't use angle brackets around parameters
* Show all options in manual page synopses if possible
* Make the usage summary line match the manual page synopsis,
  excluding the -h option
* List all options in usage messages
* Refer to manual pages from usage messages
* Include one blank line at start and end of usage messages

Signed-off-by: Ben Hutchings <ben@decadent.org.uk>

1 files changed, 10 insertions, 1 deletions

diff --git a/lsinitramfs b/lsinitramfs
index f86ad9c..03ee517 100755
--- a/lsinitramfs
+++ b/lsinitramfs
@@ -4,7 +4,16 @@ set -eu
 
 usage()
 {
-	echo "Usage: $(basename "$0") [-l] <initramfs file>"
+	cat << EOF
+
+Usage: lsinitramfs [-l] initramfs-file...
+
+Options:
+  -l   Display long and more verbose listing of initramfs content
+
+See lsinitramfs(8) for further details.
+
+EOF
 }
 
 if [ "$#" -eq 0 ] ; then