diff --git a/README.md b/README.md
index 19730cf..dff94df 100644
--- a/README.md
+++ b/README.md
@@ -124,7 +124,7 @@ Shell completion scripts for Bash, Fish and Zsh can be found in respective subdi
       -d, --delete [N]     delete bookmark at DB index N
                            delete all bookmarks, if no arguments
       --url keyword        specify url, works with -u
-      --tag [...]          specify comma-separated tags, works with -u
+      --tag [...]          set comma-separated tags, works with -a, -u
                            clears tag, if no arguments
       -t, --title [...]    manually set title, works with -a, -u
                            if no arguments:
diff --git a/buku b/buku
index 7bed925..92d99fa 100755
--- a/buku
+++ b/buku
@@ -1274,12 +1274,11 @@ general_group = argparser.add_argument_group(title="general options",
 -d, --delete [N]     delete bookmark at DB index N
                      delete all bookmarks, if no arguments
 --url keyword        specify url, works with -u
---tag [...]          specify comma-separated tags, works with -u
+--tag [...]          set comma-separated tags, works with -a, -u
                      clears tag, if no arguments
 -t, --title [...]    manually set title, works with -a, -u
                      if no arguments:
                      -a: do not set title, -u: clear title
-                     set (-a) or clear (-u) title, if no arguments
 -c, --comment [...]  description of the bookmark, works with
                      -a, -u; clears comment, if no arguments
 -h, --help           show this information''')
diff --git a/buku.1 b/buku.1
index 489d5fa..077bc48 100644
--- a/buku.1
+++ b/buku.1
@@ -71,10 +71,10 @@ in DB (from -p output). The last record is moved to the removed index. If
 is omitted, all records are deleted from the DB.
 .TP
 .BI \--url " [...]"
-Manually specify the URL. Fetches and updates title if --title is not used.
+Specify the URL, works with -u. Fetches and updates title if --title is not used.
 .TP
 .BI \--tag " [...]"
-Specify comma separated tags. Clears the tags, if no arguments passed.
+Specify comma separated tags, works with -a, -u. Clears the tags, if no arguments passed.
 .TP
 .BI \-t " " \--title " [...]"
 Manually specify the title, works with -a, -u. Omits or clears the title, if no arguments passed.