documentation and README updates and some code reorganization

codec/binc.go

@@ -1173,7 +1173,7 @@ func bincDecodeTime(bs []byte) (tt time.Time, err error) {
 		return
 	}
 	// In stdlib time.Parse, when a date is parsed without a zone name, it uses "" as zone name.
-	// However, we need name here, so it can be shown when time is printed.
+	// However, we need name here, so it can be shown when time is printf.d.
 	// Zone name is in form: UTC-08:00.
 	// Note that Go Libs do not give access to dst flag, so we ignore dst bits
 

codec/codec_test.go

@@ -1012,7 +1012,7 @@ func testCodecEmbeddedPointer(t *testing.T, h Handle) {
 func testCodecUnderlyingType(t *testing.T, h Handle) {
 	testOnce.Do(testInitAll)
 	// Manual Test.
-	// Run by hand, with accompanying print statements in fast-path.go
+	// Run by hand, with accompanying printf.statements in fast-path.go
 	// to ensure that the fast functions are called.
 	type T1 map[string]string
 	v := T1{"1": "1s", "2": "2s"}

codec/decode.go

@@ -2544,7 +2544,7 @@ func (d *Decoder) mustDecode(v interface{}) {
 
 	d.bi.calls++
 	d.decode(v)
-	// xprintf(">>>>>>>> >>>>>>>> num decFns: %v\n", d.cf.sn)
+	// xprintf.(">>>>>>>> >>>>>>>> num decFns: %v\n", d.cf.sn)
 	d.bi.calls--
 	if !d.h.ExplicitRelease && d.bi.calls == 0 {
 		d.bi.release()

codec/helper.go

@@ -2667,7 +2667,7 @@ func (z *sfiRvPooler) get(newlen int) (fkvs []sfiRv) {
 	return
 }
 
-// xdebugf prints the message in red on the terminal.
+// xdebugf printf. the message in red on the terminal.
 // Use it in place of fmt.Printf (which it calls internally)
 func xdebugf(pattern string, args ...interface{}) {
 	var delim string
@@ -2701,7 +2701,7 @@ func xdebugf(pattern string, args ...interface{}) {
 // 		return "UTC"
 // 	}
 // 	var tzname = []byte("UTC+00:00")
-// 	//tzname := fmt.Sprintf("UTC%s%02d:%02d", tzsign, tz/60, tz%60) //perf issue using Sprintf. inline below.
+// 	//tzname := fmt.Sprintf("UTC%s%02d:%02d", tzsign, tz/60, tz%60) //perf issue using Sprintf.. inline below.
 // 	//tzhr, tzmin := tz/60, tz%60 //faster if u convert to int first
 // 	var tzhr, tzmin int16
 // 	if tzint < 0 {

go.mod

@@ -1,2 +1,5 @@
 module github.com/ugorji/go
 
+go 1.13
+
+require golang.org/x/tools v0.0.0-20190424220101-1e8e1cfdf96b