Bugfix: Resolve source line link offset

`godoc` always subtracted 10 from the the line number which results
in the wrong line being linked to.
Copies the code from `godoc` to remove the single line to fix the
formatting issue.

Enables the source link hash to be configurable to support source
control platforms other than Github. The default value remains the
same as before but is now configurable for other platforms.

Regenerate examples to verify the only changes are due to fix applied
as part of this commit.

Author: kenjones-cisco

examples/build/README.md

@@ -216,7 +216,7 @@ ToolDir is the directory containing build tools.
 
 
 
-## <a name="ArchChar">func</a> [ArchChar](/src/target/build.go?s=45435:45479#L1553)
+## <a name="ArchChar">func</a> [ArchChar](/src/target/build.go?s=45435:45479#L1563)
 ``` go
 func ArchChar(goarch string) (string, error)
 ```
@@ -228,7 +228,7 @@ no longer vary by architecture; they are compile, link, .o, and a.out, respectiv
 
 
 
-## <a name="IsLocalImport">func</a> [IsLocalImport](/src/target/build.go?s=44955:44991#L1543)
+## <a name="IsLocalImport">func</a> [IsLocalImport](/src/target/build.go?s=44955:44991#L1553)
 ``` go
 func IsLocalImport(path string) bool
 ```
@@ -238,7 +238,7 @@ a local import path, like ".", "..", "./foo", or "../foo".
 
 
 
-## <a name="Context">type</a> [Context](/src/target/build.go?s=450:3568#L20)
+## <a name="Context">type</a> [Context](/src/target/build.go?s=450:3568#L30)
 ``` go
 type Context struct {
     GOARCH      string // target architecture
@@ -321,7 +321,7 @@ if set, or else the compiled code's GOARCH, GOOS, and GOROOT.
 
 
 
-### <a name="Context.Import">func</a> (\*Context) [Import](/src/target/build.go?s=16697:16787#L476)
+### <a name="Context.Import">func</a> (\*Context) [Import](/src/target/build.go?s=16697:16787#L486)
 ``` go
 func (ctxt *Context) Import(path string, srcDir string, mode ImportMode) (*Package, error)
 ```
@@ -345,7 +345,7 @@ If an error occurs, Import returns a non-nil error and a non-nil
 
 
 
-### <a name="Context.ImportDir">func</a> (\*Context) [ImportDir](/src/target/build.go?s=14860:14937#L424)
+### <a name="Context.ImportDir">func</a> (\*Context) [ImportDir](/src/target/build.go?s=14860:14937#L434)
 ``` go
 func (ctxt *Context) ImportDir(dir string, mode ImportMode) (*Package, error)
 ```
@@ -355,7 +355,7 @@ the named directory.
 
 
 
-### <a name="Context.MatchFile">func</a> (\*Context) [MatchFile](/src/target/build.go?s=30989:31061#L1022)
+### <a name="Context.MatchFile">func</a> (\*Context) [MatchFile](/src/target/build.go?s=30989:31061#L1032)
 ``` go
 func (ctxt *Context) MatchFile(dir, name string) (match bool, err error)
 ```
@@ -369,7 +369,7 @@ read some or all of the file's content.
 
 
 
-### <a name="Context.SrcDirs">func</a> (\*Context) [SrcDirs](/src/target/build.go?s=7522:7561#L228)
+### <a name="Context.SrcDirs">func</a> (\*Context) [SrcDirs](/src/target/build.go?s=7522:7561#L238)
 ``` go
 func (ctxt *Context) SrcDirs() []string
 ```
@@ -380,7 +380,7 @@ that do not exist.
 
 
 
-## <a name="ImportMode">type</a> [ImportMode](/src/target/build.go?s=9780:9800#L315)
+## <a name="ImportMode">type</a> [ImportMode](/src/target/build.go?s=9780:9800#L325)
 ``` go
 type ImportMode uint
 ```
@@ -441,7 +441,7 @@ const (
 
 
 
-## <a name="MultiplePackageError">type</a> [MultiplePackageError](/src/target/build.go?s=15413:15621#L441)
+## <a name="MultiplePackageError">type</a> [MultiplePackageError](/src/target/build.go?s=15413:15621#L451)
 ``` go
 type MultiplePackageError struct {
     Dir      string   // directory containing files
@@ -461,14 +461,14 @@ multiple buildable Go source files for multiple packages.
 
 
 
-### <a name="MultiplePackageError.Error">func</a> (\*MultiplePackageError) [Error](/src/target/build.go?s=15623:15668#L447)
+### <a name="MultiplePackageError.Error">func</a> (\*MultiplePackageError) [Error](/src/target/build.go?s=15623:15668#L457)
 ``` go
 func (e *MultiplePackageError) Error() string
 ```
 
 
 
-## <a name="NoGoError">type</a> [NoGoError](/src/target/build.go?s=15165:15202#L431)
+## <a name="NoGoError">type</a> [NoGoError](/src/target/build.go?s=15165:15202#L441)
 ``` go
 type NoGoError struct {
     Dir string
@@ -487,14 +487,14 @@ test files, files hidden by build tags, and so on.)
 
 
 
-### <a name="NoGoError.Error">func</a> (\*NoGoError) [Error](/src/target/build.go?s=15204:15238#L435)
+### <a name="NoGoError.Error">func</a> (\*NoGoError) [Error](/src/target/build.go?s=15204:15238#L445)
 ``` go
 func (e *NoGoError) Error() string
 ```
 
 
 
-## <a name="Package">type</a> [Package](/src/target/build.go?s=11686:14547#L362)
+## <a name="Package">type</a> [Package](/src/target/build.go?s=11686:14547#L372)
 ``` go
 type Package struct {
     Dir           string   // directory containing package sources
@@ -557,14 +557,14 @@ A Package describes the Go package found in a directory.
 
 
 
-### <a name="Import">func</a> [Import](/src/target/build.go?s=33366:33433#L1107)
+### <a name="Import">func</a> [Import](/src/target/build.go?s=33366:33433#L1117)
 ``` go
 func Import(path, srcDir string, mode ImportMode) (*Package, error)
 ```
 Import is shorthand for Default.Import.
 
 
-### <a name="ImportDir">func</a> [ImportDir](/src/target/build.go?s=33531:33592#L1112)
+### <a name="ImportDir">func</a> [ImportDir](/src/target/build.go?s=33531:33592#L1122)
 ``` go
 func ImportDir(dir string, mode ImportMode) (*Package, error)
 ```
@@ -574,7 +574,7 @@ ImportDir is shorthand for Default.ImportDir.
 
 
 
-### <a name="Package.IsCommand">func</a> (\*Package) [IsCommand](/src/target/build.go?s=14705:14739#L418)
+### <a name="Package.IsCommand">func</a> (\*Package) [IsCommand](/src/target/build.go?s=14705:14739#L428)
 ``` go
 func (p *Package) IsCommand() bool
 ```

examples/fs/README.md

@@ -35,7 +35,7 @@ Package fs provides filesystem-related functions.
 
 
 
-## <a name="FileSystem">type</a> [FileSystem](/src/target/filesystem.go?s=121:774#L1)
+## <a name="FileSystem">type</a> [FileSystem](/src/target/filesystem.go?s=121:774#L10)
 ``` go
 type FileSystem interface {
 
@@ -67,7 +67,7 @@ FileSystem defines the methods of an abstract filesystem.
 
 
 
-## <a name="Walker">type</a> [Walker](/src/target/walk.go?s=494:580#L5)
+## <a name="Walker">type</a> [Walker](/src/target/walk.go?s=494:580#L15)
 ``` go
 type Walker struct {
     // contains filtered or unexported fields
@@ -87,14 +87,14 @@ Walker does not follow symbolic links.
 
 
 
-### <a name="Walk">func</a> [Walk](/src/target/walk.go?s=692:722#L19)
+### <a name="Walk">func</a> [Walk](/src/target/walk.go?s=692:722#L29)
 ``` go
 func Walk(root string) *Walker
 ```
 Walk returns a new Walker rooted at root.
 
 
-### <a name="WalkFS">func</a> [WalkFS](/src/target/walk.go?s=826:873#L24)
+### <a name="WalkFS">func</a> [WalkFS](/src/target/walk.go?s=826:873#L34)
 ``` go
 func WalkFS(root string, fs FileSystem) *Walker
 ```
@@ -104,7 +104,7 @@ WalkFS returns a new Walker rooted at root on the FileSystem fs.
 
 
 
-### <a name="Walker.Err">func</a> (\*Walker) [Err](/src/target/walk.go?s=2325:2353#L77)
+### <a name="Walker.Err">func</a> (\*Walker) [Err](/src/target/walk.go?s=2325:2353#L87)
 ``` go
 func (w *Walker) Err() error
 ```
@@ -115,7 +115,7 @@ an error, w will not descend into that directory.
 
 
 
-### <a name="Walker.Path">func</a> (\*Walker) [Path](/src/target/walk.go?s=1946:1976#L64)
+### <a name="Walker.Path">func</a> (\*Walker) [Path](/src/target/walk.go?s=1946:1976#L74)
 ``` go
 func (w *Walker) Path() string
 ```
@@ -127,7 +127,7 @@ a directory containing the file "a", Path will return "dir/a".
 
 
 
-### <a name="Walker.SkipDir">func</a> (\*Walker) [SkipDir](/src/target/walk.go?s=2496:2522#L83)
+### <a name="Walker.SkipDir">func</a> (\*Walker) [SkipDir](/src/target/walk.go?s=2496:2522#L93)
 ``` go
 func (w *Walker) SkipDir()
 ```
@@ -137,7 +137,7 @@ If w is not on a directory, SkipDir has no effect.
 
 
 
-### <a name="Walker.Stat">func</a> (\*Walker) [Stat](/src/target/walk.go?s=2090:2125#L70)
+### <a name="Walker.Stat">func</a> (\*Walker) [Stat](/src/target/walk.go?s=2090:2125#L80)
 ``` go
 func (w *Walker) Stat() os.FileInfo
 ```
@@ -147,7 +147,7 @@ visited by a call to Step.
 
 
 
-### <a name="Walker.Step">func</a> (\*Walker) [Step](/src/target/walk.go?s=1176:1204#L36)
+### <a name="Walker.Step">func</a> (\*Walker) [Step](/src/target/walk.go?s=1176:1204#L46)
 ``` go
 func (w *Walker) Step() bool
 ```