Add a license and some docsHEADv0.0.1master

2 files changed, 42 insertions, 0 deletions

diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..403a7bc
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,13 @@
+Copyright 2025 Mitchell Riedstra
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.
diff --git a/main.go b/main.go
index 8c50dc3..84dedb5 100644
--- a/main.go
+++ b/main.go
@@ -1,6 +1,35 @@
 // Package envflag is an extremely small bit of code to make configuration
 // via environment variables a little bit less of a hassle when using
 // the flag package in the standard library.
+//
+// Example:
+//
+//	package main
+//
+//	import (
+//		"flag"
+//		"fmt"
+//		"os"
+//
+//		"riedstra.dev/go/envflag"
+//	)
+//
+//	func main() {
+//		fl := flag.NewFlagSet("envflag", flag.ExitOnError)
+//
+//		var aFlag string = "some default"
+//		fmt.Println("aFlag:", aFlag)
+//
+//		envflag.String(fl, &aFlag, "a", "FLAG_A", "Set's the value of -a")
+//
+//		// By default, command line flags override environment vars.
+//		fl.Parse(os.Args[1:])
+//
+//		fmt.Println("aFlag:", aFlag)
+//	}
+//
+// Known caveat, variables set in the environment will override what the flag
+// package sees as the "default" value.
 package envflag
 
 import (