commit 4f7fe71a69e872546a5355d91e178b0a03a87ef5
from: Omar Polo <op@omarpolo.com>
date: Sun Aug 02 07:32:48 2020 UTC

improving wording and addit bits of the README as package doc

commit - 8e6a76fccc8bc82eb3ba4a42772e2c86454a2819
commit + 4f7fe71a69e872546a5355d91e178b0a03a87ef5
blob - 3103d430e3936754da279dee9fb8aa5c7aeb5ade
blob + 5a79c3513a6c7317331ff57602e97fd827933cde
--- README.md
+++ README.md
@@ -2,15 +2,15 @@
 
 	go get git.omarpolo.com/acmetag
 
-`acmetag` is a tool to programmatically interact with `acme(1)` tag.  It
-provides two flag:
+`acmetag` is a tool to programmatically interact with `acme(1)` tag
+bar.  It provides two flag:
 
  * `-g` prints the tag content (mnemonic: get)
  * `-c` clears the tag content (mnemonic: clear)
 
-any other arguments if passed will be appended to the tag.
+Any other argument (if passed) will be appended to the tag bar.
 
-Of course you can combine the flags:
+Of course, you can combine the flags:
 
 	acmetag -g -c fmt
 
blob - 07d7a485a894735202e3babd24496f29e74190e4
blob + e1676d137eb4a3a2bff227d00c2577f96bbb302a
--- main.go
+++ main.go
@@ -1,3 +1,17 @@
+// acmetag is a tool to programmatically interact with acme(1) tag
+// bar.  It provides two flag:
+//
+// 	* -g prints the tag content (mnemonic: get)
+// 	* -c clears the tag content (mnemonic: clear)
+//
+// Any other argument (if passed) will be appended to the tag bar.
+//
+// Of course, you can combine the flags:
+//
+// 	acmetag -g -c fmt
+//
+// BUG(op) it cannot change the text before the | character.
+// AFAIK that's not possible
 package main
 
 import (