Merge pull request #12 from myitcv/mdreplace_self_document

cmd/mdreplace: self-document usage in README

_scripts/run_tests.sh

@@ -37,16 +37,17 @@ then
 	export GOPROXY="file://$PWD"
 
 	popd > /dev/null
+
+	$go version
+	$go env
+
+	# can potentially go when we get a resolution on
+	# https://github.com/golang/go/issues/24748
+	echo "GOPROXY=\"${GOPROXY:-}\""
 fi
 
 export PATH=$GOPATH/bin:$PATH
 
-$go version
-$go env
-
-# can potentially go when we get a resolution on
-# https://github.com/golang/go/issues/24748
-echo "GOPROXY=\"${GOPROXY:-}\""
 
 # get all packages that do not belong to a module that has its
 # own _scripts/run_tests.sh file

cmd/mdreplace/README.md

@@ -40,6 +40,29 @@ hello world today
 _To see this in action, look at the [source of the
 `README.md`](https://raw.githubusercontent.com/myitcv/x/master/cmd/mdreplace/README.md) you are currently reading._
 
+### Usage
+
+<!-- __TEMPLATE: mdreplace -h
+```
+{{.}}
+```
+-->
+```
+Usage:
+
+  mdreplace file1 file2 ...
+  mdreplace
+
+When called with no file arguments, mdreplace works with stdin
+
+Flags:
+  -h	show usage information
+  -strip
+    	whether to strip special comments from the file
+  -w	whether to write back to input files (cannot be used when reading from stdin)
+
+```
+<!-- END -->
 
 ### Code fences