From bc8c51749c68f03b78e885dc54af64f41940023d Mon Sep 17 00:00:00 2001
From: Levente Polyak <anthraxx@archlinux.org>
Date: Thu, 21 Oct 2021 20:17:09 +0200
Subject: [PATCH] chore(doc): improve import usage section exmaples

---
 README.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 9b07a25..ea7c0ac 100644
--- a/README.md
+++ b/README.md
@@ -20,25 +20,25 @@ from the provided data structure and to install it:
 
 ## Usage
 
-Import of a new packager key
+### Import
 
+Import a new packager key by deriving the username from the filename.
 ```bash
 ./keyringctl import <username>.asc
-# alternatively override the username otherwise derived from the filename
-./keyringctl import --name <username> <file>
 ```
 
-Updates to existing packager keys
-
+Alternatively import a file or directory and override the username
 ```bash
-# username is automatically derived from the fingerprint
-./keyringctl import <file_or_directory>...
+./keyringctl import --name <username> <file_or_directory>
 ```
 
-Import of a new main key
-
+Updates to existing keys will automatically derive the username from the known fingerprint.
+```bash
+./keyringctl import <file_or_directory>
+```
+
+Main key imports support the same options plus a mandatory `--main`
 ```bash
-# same options as packager key except mandatory --main
 ./keyringctl import --main <username>.asc
 ```