Add spec links to public items (#591)

* dtls: Add spec links to public items

* ice: Add spec links to public items

* rtcp: Add spec links to public items

* rtp: Add spec links to public items

* sctp: Add spec links to public items

* sdp: Add spec links to public items

* webrtc: Add spec links to public items

Author: Serial-ATA

dtls/src/alert/mod.rs

@@ -144,7 +144,11 @@ impl From<u8> for AlertDescription {
 // preventing the failed session from being used to establish new
 // connections.  Like other messages, alert messages are encrypted and
 // compressed, as specified by the current connection state.
-// https://tools.ietf.org/html/rfc5246#section-7.2
+/// ## Specifications
+///
+/// * [RFC 5246 §7.2]
+///
+/// [RFC 5246 §7.2]: https://tools.ietf.org/html/rfc5246#section-7.2
 #[derive(Copy, Clone, PartialEq, Debug)]
 pub struct Alert {
     pub(crate) alert_level: AlertLevel,

dtls/src/application_data.rs

@@ -7,7 +7,11 @@ use crate::error::Result;
 // fragmented, compressed, and encrypted based on the current connection
 // state.  The messages are treated as transparent data to the record
 // layer.
-// https://tools.ietf.org/html/rfc5246#section-10
+/// ## Specifications
+///
+/// * [RFC 5246 §10]
+///
+/// [RFC 5246 §10]: https://tools.ietf.org/html/rfc5246#section-10
 #[derive(Clone, PartialEq, Eq, Debug)]
 pub struct ApplicationData {
     pub data: Vec<u8>,

dtls/src/change_cipher_spec/mod.rs

@@ -12,7 +12,11 @@ use super::error::*;
 // ciphering strategies.  The protocol consists of a single message,
 // which is encrypted and compressed under the current (not the pending)
 // connection state.  The message consists of a single byte of value 1.
-// https://tools.ietf.org/html/rfc5246#section-7.1
+/// ## Specifications
+///
+/// * [RFC 5246 §7.1]
+///
+/// [RFC 5246 §7.1]: https://tools.ietf.org/html/rfc5246#section-7.1
 #[derive(Clone, PartialEq, Eq, Debug)]
 pub struct ChangeCipherSpec;
 

dtls/src/content.rs

@@ -6,7 +6,11 @@ use super::change_cipher_spec::*;
 use super::handshake::*;
 use crate::error::*;
 
-// https://tools.ietf.org/html/rfc4346#section-6.2.1
+/// ## Specifications
+///
+/// * [RFC 4346 §6.2.1]
+///
+/// [RFC 4346 §6.2.1]: https://tools.ietf.org/html/rfc4346#section-6.2.1
 #[derive(Default, Copy, Clone, PartialEq, Eq, Debug)]
 pub enum ContentType {
     ChangeCipherSpec = 20,

dtls/src/extension/extension_supported_elliptic_curves.rs

@@ -6,7 +6,11 @@ use crate::curve::named_curve::*;
 
 const EXTENSION_SUPPORTED_GROUPS_HEADER_SIZE: usize = 6;
 
-// https://tools.ietf.org/html/rfc8422#section-5.1.1
+/// ## Specifications
+///
+/// * [RFC 8422 §5.1.1]
+///
+/// [RFC 8422 §5.1.1]: https://tools.ietf.org/html/rfc8422#section-5.1.1
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct ExtensionSupportedEllipticCurves {
     pub elliptic_curves: Vec<NamedCurve>,

dtls/src/extension/extension_supported_point_formats.rs

@@ -9,7 +9,11 @@ pub type EllipticCurvePointFormat = u8;
 
 pub const ELLIPTIC_CURVE_POINT_FORMAT_UNCOMPRESSED: EllipticCurvePointFormat = 0;
 
-// https://tools.ietf.org/html/rfc4492#section-5.1.2
+/// ## Specifications
+///
+/// * [RFC 4492 §5.1.2]
+///
+/// [RFC 4492 §5.1.2]: https://tools.ietf.org/html/rfc4492#section-5.1.2
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct ExtensionSupportedPointFormats {
     pub(crate) point_formats: Vec<EllipticCurvePointFormat>,

dtls/src/extension/extension_supported_signature_algorithms.rs

@@ -6,7 +6,11 @@ use crate::signature_hash_algorithm::*;
 
 const EXTENSION_SUPPORTED_SIGNATURE_ALGORITHMS_HEADER_SIZE: usize = 6;
 
-// https://tools.ietf.org/html/rfc5246#section-7.4.1.4.1
+/// ## Specifications
+///
+/// * [RFC 5246 §7.4.1.4.1]
+///
+/// [RFC 5246 §7.4.1.4.1]: https://tools.ietf.org/html/rfc5246#section-7.4.1.4.1
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct ExtensionSupportedSignatureAlgorithms {
     pub(crate) signature_hash_algorithms: Vec<SignatureHashAlgorithm>,

dtls/src/extension/extension_use_extended_master_secret.rs

@@ -5,7 +5,11 @@ use super::*;
 
 const EXTENSION_USE_EXTENDED_MASTER_SECRET_HEADER_SIZE: usize = 4;
 
-// https://tools.ietf.org/html/rfc8422
+/// ## Specifications
+///
+/// * [RFC 8422]
+///
+/// [RFC 8422]: https://tools.ietf.org/html/rfc8422
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct ExtensionUseExtendedMasterSecret {
     pub(crate) supported: bool,

dtls/src/extension/extension_use_srtp.rs

@@ -4,7 +4,11 @@ mod extension_use_srtp_test;
 use super::*;
 
 // SRTPProtectionProfile defines the parameters and options that are in effect for the SRTP processing
-// https://tools.ietf.org/html/rfc5764#section-4.1.2
+/// ## Specifications
+///
+/// * [RFC 5764 §4.1.2]
+///
+/// [RFC 5764 §4.1.2]: https://tools.ietf.org/html/rfc5764#section-4.1.2
 #[allow(non_camel_case_types)]
 #[derive(Copy, Clone, Debug, PartialEq, Eq)]
 pub enum SrtpProtectionProfile {
@@ -29,7 +33,11 @@ impl From<u16> for SrtpProtectionProfile {
 
 const EXTENSION_USE_SRTPHEADER_SIZE: usize = 6;
 
-// https://tools.ietf.org/html/rfc8422
+/// ## Specifications
+///
+/// * [RFC 8422]
+///
+/// [RFC 8422]: https://tools.ietf.org/html/rfc8422
 #[allow(non_camel_case_types)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct ExtensionUseSrtp {

dtls/src/extension/renegotiation_info.rs

@@ -8,7 +8,12 @@ const RENEGOTIATION_INFO_HEADER_SIZE: usize = 5;
 
 /// RenegotiationInfo allows a Client/Server to
 /// communicate their renegotiation support
-/// https://tools.ietf.org/html/rfc5746
+///
+/// ## Specifications
+///
+/// * [RFC 5746]
+///
+/// [RFC 5746]: https://tools.ietf.org/html/rfc5746
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct ExtensionRenegotiationInfo {
     pub(crate) renegotiated_connection: u8,