docs(godoc): improve formatting of DNSLabel docs

This commit is contained in:
2021-01-20 08:54:18 +00:00
parent 48449585e8
commit 16e33f432c

View File

@@ -164,11 +164,11 @@ func UnicodeString(n int, alphabet []rune) (string, error) {
} }
// DNSLabel returns a random string of n length in a DNS label compliant format // DNSLabel returns a random string of n length in a DNS label compliant format
// as defined in RFC 1035, section 2.3.1, Preferred name syntax: // as defined in RFC 1035, section 2.3.1:
// https://tools.ietf.org/html/rfc1035#section-2.3.1 // https://www.rfc-editor.org/rfc/rfc1035.html#section-2.3.1
// //
// It also adheres to RFC 5891, section 4.2.3.1, Hyphen Restrictions: // It also adheres to RFC 5891, section 4.2.3.1:
// https://tools.ietf.org/html/rfc5891#section-4.2.3.1 // https://www.rfc-editor.org/rfc/rfc5891.html#section-4.2.3.1
// //
// In summary, the generated random string will: // In summary, the generated random string will:
// //
@@ -177,7 +177,7 @@ func UnicodeString(n int, alphabet []rune) (string, error) {
// - last character will be one of a-z or 0-9 // - last character will be one of a-z or 0-9
// - in-between first and last characters consist of a-z, 0-9, or "-" // - in-between first and last characters consist of a-z, 0-9, or "-"
// - potentially contain two or more consecutive "-", except the 3rd and 4th // - potentially contain two or more consecutive "-", except the 3rd and 4th
// characters, as that would violate RFC 5891. // characters, as that would violate RFC 5891, section 4.2.3.1.
func DNSLabel(n int) (string, error) { func DNSLabel(n int) (string, error) {
switch { switch {
case n < 1 || n > 63: case n < 1 || n > 63: