Update Go doc comments to Go 1.19's format

This patch is the result of running Go 1.19's `gofmt` on the codebase,
which automatically updates all Go doc comments to the new format.

https://tip.golang.org/doc/go1.19#go-doc

internal/aliases/aliases.go

@@ -3,8 +3,7 @@
 // The resolver can parse many files for different domains, and perform
 // lookups to resolve the aliases.
 //
-//
-// File format
+// # File format
 //
 // It generally follows the traditional aliases format used by sendmail and
 // exim.
@@ -27,8 +26,7 @@
 // If the user is the string "*", then it is considered a "catch-all alias":
 // emails that don't match any known users or other aliases will be sent here.
 //
-//
-// Recipients
+// # Recipients
 //
 // Recipients can be of different types:
 //   - Email: the usual user@domain we all know and love, this is the default.
@@ -37,8 +35,7 @@
 //     Command and arguments are space separated. No quoting, escaping, or
 //     replacements of any kind.
 //
-//
-// Lookups
+// # Lookups
 //
 // The resolver will perform lookups recursively, until it finds all the final
 // recipients.
@@ -46,8 +43,7 @@
 // There are recursion limits to avoid alias loops. If the limit is reached,
 // the entire resolution will fail.
 //
-//
-// Suffix removal
+// # Suffix removal
 //
 // The resolver can also remove suffixes from emails, and drop characters
 // completely. This can be used to turn "user+blah@domain" into "user@domain",

internal/auth/auth.go

@@ -162,6 +162,7 @@ func (a *Authenticator) Reload() error {
 // DecodeResponse decodes a plain auth response.
 //
 // It must be a a base64-encoded string of the form:
+//
 //	<authorization id> NUL <authentication id> NUL <password>
 //
 // https://tools.ietf.org/html/rfc4954#section-4.1.

internal/smtp/smtp.go

@@ -3,7 +3,6 @@
 //
 //   - Supports SMTPUTF8, via MailAndRcpt.
 //   - Adds IsPermanent.
-//
 package smtp
 
 import (

internal/sts/sts.go

@@ -3,7 +3,6 @@
 // Note that "report" mode is not supported.
 //
 // Reference: https://tools.ietf.org/html/rfc8461
-//
 package sts
 
 import (

internal/userdb/userdb.go

@@ -1,7 +1,6 @@
 // Package userdb implements a simple user database.
 //
-//
-// Format
+// # Format
 //
 // The user database is a file containing a list of users and their passwords,
 // encrypted with some scheme.
@@ -13,21 +12,18 @@
 // Users must be UTF-8 and NOT contain whitespace; the library will enforce
 // this.
 //
-//
-// Schemes
+// # Schemes
 //
 // The default scheme is SCRYPT, with hard-coded parameters. The API does not
 // allow the user to change this, at least for now.
 // A PLAIN scheme is also supported for debugging purposes.
 //
-//
-// Writing
+// # Writing
 //
 // The functions that write a database file will not preserve ordering,
 // invalid lines, empty lines, or any formatting.
 //
 // It is also not safe for concurrent use from different processes.
-//
 package userdb
 
 //go:generate protoc --go_out=. --go_opt=paths=source_relative userdb.proto

test/util/minidns/minidns.go

@@ -16,7 +16,6 @@
 //
 // It's only meant to be used for testing, so it's not robust, performant, or
 // standards compliant.
-//
 package main
 
 import (