1
0
Fork 0
mirror of https://github.com/actix/actix-web.git synced 2025-03-06 11:31:15 +00:00

Doc cleanup

This commit is contained in:
Park Joon-Kyu 2024-11-08 13:23:07 +09:00
parent e3f3c055db
commit 5cadd2cec7

View file

@ -9,7 +9,7 @@ use super::{OpCode, ProtocolError, RsvBits};
use crate::header::{HeaderName, HeaderValue, TryIntoHeaderPair, SEC_WEBSOCKET_EXTENSIONS}; use crate::header::{HeaderName, HeaderValue, TryIntoHeaderPair, SEC_WEBSOCKET_EXTENSIONS};
// NOTE: according to [RFC 7692 §7.1.2.1] window bit size should be within 8..=15 // NOTE: according to [RFC 7692 §7.1.2.1] window bit size should be within 8..=15
// but we have to limit the range to 9..=15 because [flate2] only supports window bit within 9..=15. // but we have to limit the range to 9..=15 because [flate2] only supports window bit within 9..=15.
// //
// [RFC 6792 §7.1.2.1]: https://datatracker.ietf.org/doc/html/rfc7692#section-7.1.2.1 // [RFC 6792 §7.1.2.1]: https://datatracker.ietf.org/doc/html/rfc7692#section-7.1.2.1
// [flate2]: https://docs.rs/flate2/latest/flate2/struct.Compress.html#method.new_with_window_bits // [flate2]: https://docs.rs/flate2/latest/flate2/struct.Compress.html#method.new_with_window_bits
@ -64,13 +64,15 @@ impl std::error::Error for DeflateHandshakeError {}
/// Maximum size of client's DEFLATE sliding window. /// Maximum size of client's DEFLATE sliding window.
#[derive(Copy, Clone, Debug, Eq, PartialEq)] #[derive(Copy, Clone, Debug, Eq, PartialEq)]
pub enum ClientMaxWindowBits { pub enum ClientMaxWindowBits {
/// Unspecified. Indicates server should decide its size. /// Unspecified. Indicates client will follow server configuration.
NotSpecified, NotSpecified,
/// Specified size of client's DEFLATE sliding window size in bits, between 9 and 15. /// Specified size of client's DEFLATE sliding window size in bits, between 9 and 15.
Specified(u8), Specified(u8),
} }
/// DEFLATE negotiation parameter. It can be used both client and server side. /// Per-session DEFLATE configuration parameter.
///
/// It can be used both client and server side.
/// At client side, it can be used to pass desired configuration to server. /// At client side, it can be used to pass desired configuration to server.
/// At server side, negotiated parameter will be sent to client with this. /// At server side, negotiated parameter will be sent to client with this.
/// This can be represented in HTTP header form as it implements [`TryIntoHeaderPair`] trait. /// This can be represented in HTTP header form as it implements [`TryIntoHeaderPair`] trait.