fix(doclink): fix issue where doclink could sometimes check the first line inside a function as if it was a top-level definition.

Author: cconstable

internal/cmd/tools/doclink/doclink.go

@@ -390,8 +390,10 @@ func processInternal(cfg config, file *os.File, pairs map[string]map[string]stri
 			trimmedNextLine = nextLine
 		}
 
-		// Check for new doc links to add
-		if !inFunc && !inInterface && isValidDefinition(trimmedNextLine, &inGroup, &inStruct) {
+		// Only check top-level definitions.
+		// Example: on a line like "func f() {", inFunc is still false here.
+		// Without the explicit func check, the next line could be treated like a top-level definition.
+		if !inFunc && !inInterface && !strings.HasPrefix(trimmedLine, "func ") && isValidDefinition(trimmedNextLine, &inGroup, &inStruct) {
 			// Find the "Exposed As" line in the doc comment
 			var existingDoclink string
 			comScanner := bufio.NewScanner(strings.NewReader(commentBlock))