Minor readme update
authorIan Kelling <ian@iankelling.org>
Thu, 12 Jun 2014 22:16:45 +0000 (15:16 -0700)
committerIan Kelling <ian@iankelling.org>
Thu, 12 Jun 2014 22:16:45 +0000 (15:16 -0700)
README

diff --git a/README b/README
index 3e79fecfcf6e3ba1b81913916dd732cb7053c470..8bbec69b987e37ab2163d092e5b0eba9e8e95d9f 100644 (file)
--- a/README
+++ b/README
@@ -1,14 +1,17 @@
-This program's main documentation is not here. It is in near the top of any of
-the bash script file(s) which sit next to this file. If there is an executable
-script in this repo, the documentation is also available by passing --help to
-the script/function.
+The main usage documentation is near the top of any bash script files which sit
+next to this file.
 
-This program is also part of a collection of programs,
-https://gitlab.com/iankelling/bash-programs-by-ian, which are unrelated except
-a few small things like this file.
+Files ending in -function are for sourcing then calling as a function. Files
+without -function are exactly the same except they are for calling as a script.
+
+Patches and bugs are very welcome via gitlab.
 
-For programs with 2 files named like foo and foo-function, they are the same but
-provide the flexibility of calling foo the script, or sourcing foo-function and
-calling foo the function.
+Questions, feedback, etc are very welcome via email to Ian Kelling
+<ian@iankelling.org>. I will add any useful questions, answers, etc. to this
+file. The scope/userbase of this project doesn't justify a mailing list, but if
+it ever did I would start a discourse instance category to act as a mailing list
+and forum.
 
-Patches, bugs, opinions are welcome via gitlab or email Ian Kelling <ian@iankelling.org>
+This program is also part of a collection of programs,
+https://gitlab.com/iankelling/bash-programs-by-ian, which are unrelated except
+having the same author and being being bash programs.