docs: Link out to specifics

Author: epage

crates/anstyle-hyperlink/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "anstyle-hyperlink"
 version = "1.0.0"
-description = "ANSI escape code hyperlinks"
+description = "ANSI escape code hyperlinks (OSC 8)"
 categories = ["command-line-interface"]
 keywords = ["ansi", "terminal", "color", "no_std"]
 repository.workspace = true

crates/anstyle-hyperlink/README.md

@@ -1,6 +1,6 @@
 # anstyle-hyperlink
 
-> ANSI escape code hyperlinks
+> ANSI escape code hyperlinks (OSC 8)
 
 [![Documentation](https://img.shields.io/badge/docs-master-blue.svg)][Documentation]
 ![License](https://img.shields.io/crates/l/anstyle-hyperlink.svg)

crates/anstyle-hyperlink/src/file.rs

@@ -18,6 +18,7 @@ pub fn path_to_url(path: &std::path::Path) -> Option<String> {
 ///
 /// For hyperlink escape codes, the hostname is used to avoid issues with opening a link scoped to
 /// the computer you've SSH'ed into
+/// ([reference](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda#file-uris-and-the-hostname))
 pub fn file_to_url(hostname: Option<&str>, path: &std::path::Path) -> Option<String> {
     if !path.is_absolute() {
         return None;
@@ -51,6 +52,7 @@ pub fn file_to_url(hostname: Option<&str>, path: &std::path::Path) -> Option<Str
 ///
 /// For hyperlink escape codes, the hostname is used to avoid issues with opening a link scoped to
 /// the computer you've SSH'ed into
+/// ([reference](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda#file-uris-and-the-hostname))
 pub fn dir_to_url(hostname: Option<&str>, path: &std::path::Path) -> Option<String> {
     let mut url = file_to_url(hostname, path)?;
     if !url.ends_with(URL_PATH_SEP) {

crates/anstyle-hyperlink/src/lib.rs

@@ -1,4 +1,7 @@
-//! ANSI escape code hyperlink
+//! ANSI escape code hyperlink (OSC 8)
+//!
+//! For details on the protocol, see
+//! [Hyperlinks (a.k.a. HTML-like anchors) in terminal emulators](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda)
 //!
 //! To detect support, see [supports-hyperlinks](https://crates.io/crates/supports-hyperlinks)