chore: fix godoc comments for functions and structs (#24736)

testutil/ioutil.go

@@ -50,7 +50,7 @@ func ApplyMockIODiscardOutErr(c *cobra.Command) BufferReader {
 	return mockIn
 }
 
-// Write the given string to a new temporary file.
+// WriteToNewTempFile writes the given string to a new temporary file.
 // Returns an open file for the test to use.
 func WriteToNewTempFile(tb testing.TB, s string) *os.File {
 	tb.Helper()

testutil/network/network.go

@@ -88,9 +88,9 @@ func init() {
 	}
 }
 
-// AppConstructor defines a function which accepts a network configuration and
-// creates an ABCI Application to provide to CometBFT.
 type (
+	// AppConstructor defines a function which accepts a network configuration and
+	// creates an ABCI Application to provide to CometBFT.
 	AppConstructor     = func(val ValidatorI) servertypes.Application
 	TestFixtureFactory = func() TestFixture
 )

testutil/network/util.go

@@ -231,7 +231,7 @@ func writeFile(name, dir string, contents []byte) error {
 	return nil
 }
 
-// Get a free address for a test CometBFT server
+// FreeTCPAddr gets a free address for a test CometBFT server
 // protocol is either tcp, http, etc
 func FreeTCPAddr() (addr, port string, closeFn func() error, err error) {
 	l, err := net.Listen("tcp", "127.0.0.1:0")