Commit 5c8f65b9 authored by Martin Sucha's avatar Martin Sucha Committed by Brad Fitzpatrick

crypto/x509: reformat template members in docs

It's easier to skim a list of items visually when the
items are each on a separate line. Separate lines also
help reduce diff size when items are added/removed.

The list is indented so that it's displayed preformatted
in HTML output as godoc doesn't support formatting lists
natively yet (see #7873).

Change-Id: Ibf9e92437e4b464ba58ea3ccef579e8df4745d75
Reviewed-on: https://go-review.googlesource.com/113915Reviewed-by: default avatarBrad Fitzpatrick <bradfitz@golang.org>
parent 37c11dc0
...@@ -2039,11 +2039,26 @@ func signingParamsForPublicKey(pub interface{}, requestedSigAlgo SignatureAlgori ...@@ -2039,11 +2039,26 @@ func signingParamsForPublicKey(pub interface{}, requestedSigAlgo SignatureAlgori
var emptyASN1Subject = []byte{0x30, 0} var emptyASN1Subject = []byte{0x30, 0}
// CreateCertificate creates a new X.509v3 certificate based on a template. // CreateCertificate creates a new X.509v3 certificate based on a template.
// The following members of template are used: AuthorityKeyId, // The following members of template are used:
// BasicConstraintsValid, DNSNames, ExcludedDNSDomains, ExtKeyUsage, //
// IsCA, KeyUsage, MaxPathLen, MaxPathLenZero, NotAfter, NotBefore, // - AuthorityKeyId
// PermittedDNSDomains, PermittedDNSDomainsCritical, SerialNumber, // - BasicConstraintsValid
// SignatureAlgorithm, Subject, SubjectKeyId, and UnknownExtKeyUsage. // - DNSNames
// - ExcludedDNSDomains
// - ExtKeyUsage
// - IsCA
// - KeyUsage
// - MaxPathLen
// - MaxPathLenZero
// - NotAfter
// - NotBefore
// - PermittedDNSDomains
// - PermittedDNSDomainsCritical
// - SerialNumber
// - SignatureAlgorithm
// - Subject
// - SubjectKeyId
// - UnknownExtKeyUsage
// //
// The certificate is signed by parent. If parent is equal to template then the // The certificate is signed by parent. If parent is equal to template then the
// certificate is self-signed. The parameter pub is the public key of the // certificate is self-signed. The parameter pub is the public key of the
...@@ -2365,9 +2380,18 @@ func parseCSRExtensions(rawAttributes []asn1.RawValue) ([]pkix.Extension, error) ...@@ -2365,9 +2380,18 @@ func parseCSRExtensions(rawAttributes []asn1.RawValue) ([]pkix.Extension, error)
} }
// CreateCertificateRequest creates a new certificate request based on a // CreateCertificateRequest creates a new certificate request based on a
// template. The following members of template are used: Attributes, DNSNames, // template. The following members of template are used:
// EmailAddresses, ExtraExtensions, IPAddresses, URIs, SignatureAlgorithm, and //
// Subject. The private key is the private key of the signer. // - Attributes
// - DNSNames
// - EmailAddresses
// - ExtraExtensions
// - IPAddresses
// - URIs
// - SignatureAlgorithm
// - Subject
//
// The private key is the private key of the signer.
// //
// The returned slice is the certificate request in DER encoding. // The returned slice is the certificate request in DER encoding.
// //
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment