docs: cleanup warnings

This commit is contained in:
Josh McKinney 2024-08-26 13:05:32 -07:00
parent b056370038
commit e628d53980
No known key found for this signature in database
GPG Key ID: 722287396A903BC5
6 changed files with 9 additions and 12 deletions

View File

@ -13,7 +13,7 @@ use crate::{
/// The top left cell is represented as `(0, 0)`. /// The top left cell is represented as `(0, 0)`.
/// ///
/// On unix systems, this function will block and possibly time out while /// On unix systems, this function will block and possibly time out while
/// [`crossterm::event::read`](crate::event::read) or [`crossterm::event::poll`](crate::event::poll) are being called. /// [`crossterm::event::read`](crate::event::read()) or [`crossterm::event::poll`](crate::event::poll) are being called.
pub fn position() -> io::Result<(u16, u16)> { pub fn position() -> io::Result<(u16, u16)> {
if is_raw_mode_enabled() { if is_raw_mode_enabled() {
read_position_raw() read_position_raw()

View File

@ -251,10 +251,7 @@ mod command;
pub(crate) mod macros; pub(crate) mod macros;
#[cfg(all(windows, not(feature = "windows")))] #[cfg(all(windows, not(feature = "windows")))]
compile_error!("Compiling on Windows with \"windows\" feature disabled. Feature \"windows\" should only be disabled when project will never be compiled on Windows."); compile_error!(
"Compiling on Windows with \"windows\" feature disabled. \
#[cfg(all(winapi, not(feature = "winapi")))] Feature \"windows\" should only be disabled when project will never be compiled on Windows."
compile_error!("Compiling on Windows with \"winapi\" feature disabled. Feature \"winapi\" should only be disabled when project will never be compiled on Windows."); );
#[cfg(all(crossterm_winapi, not(feature = "crossterm_winapi")))]
compile_error!("Compiling on Windows with \"crossterm_winapi\" feature disabled. Feature \"crossterm_winapi\" should only be disabled when project will never be compiled on Windows.");

View File

@ -184,7 +184,7 @@ pub fn available_color_count() -> u16 {
/// ///
/// # Notes /// # Notes
/// ///
/// crossterm supports NO_COLOR (https://no-color.org/) to disabled colored output. /// crossterm supports NO_COLOR (<https://no-color.org/>) to disabled colored output.
/// ///
/// This API allows applications to override that behavior and force colorized output /// This API allows applications to override that behavior and force colorized output
/// even if NO_COLOR is set. /// even if NO_COLOR is set.

View File

@ -71,7 +71,7 @@ impl Colored {
} }
/// Checks whether ansi color sequences are disabled by setting of NO_COLOR /// Checks whether ansi color sequences are disabled by setting of NO_COLOR
/// in environment as per https://no-color.org/ /// in environment as per <https://no-color.org/>
pub fn ansi_color_disabled() -> bool { pub fn ansi_color_disabled() -> bool {
!std::env::var("NO_COLOR") !std::env::var("NO_COLOR")
.unwrap_or("".to_string()) .unwrap_or("".to_string())

View File

@ -148,7 +148,7 @@ pub struct WindowSize {
/// Returns the terminal size `[WindowSize]`. /// Returns the terminal size `[WindowSize]`.
/// ///
/// The width and height in pixels may not be reliably implemented or default to 0. /// The width and height in pixels may not be reliably implemented or default to 0.
/// For unix, https://man7.org/linux/man-pages/man4/tty_ioctl.4.html documents them as "unused". /// For unix, <https://man7.org/linux/man-pages/man4/tty_ioctl.4.html> documents them as "unused".
/// For windows it is not implemented. /// For windows it is not implemented.
pub fn window_size() -> io::Result<WindowSize> { pub fn window_size() -> io::Result<WindowSize> {
sys::window_size() sys::window_size()

View File

@ -181,7 +181,7 @@ fn set_terminal_attr(fd: impl AsFd, termios: &Termios) -> io::Result<()> {
/// Queries the terminal's support for progressive keyboard enhancement. /// Queries the terminal's support for progressive keyboard enhancement.
/// ///
/// On unix systems, this function will block and possibly time out while /// On unix systems, this function will block and possibly time out while
/// [`crossterm::event::read`](crate::event::read) or [`crossterm::event::poll`](crate::event::poll) are being called. /// [`event::read`](crate::event::read()) or [`event::poll`](crate::event::poll) are being called.
#[cfg(feature = "events")] #[cfg(feature = "events")]
pub fn supports_keyboard_enhancement() -> io::Result<bool> { pub fn supports_keyboard_enhancement() -> io::Result<bool> {
if is_raw_mode_enabled() { if is_raw_mode_enabled() {