summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthieu Pignolet <matthieu@puffer.fish>2025-05-19 12:39:55 +0400
committerMatthieu Pignolet <matthieu@puffer.fish>2025-05-19 12:39:55 +0400
commit78db603625e1ef0900249bc42413955458a520cc (patch)
tree544285286b60689728267dd5736bbf444b51eb9a
parent4a21aec69b320c0428255917341d716c0ddb6b84 (diff)
feat: include readme in lib.rs
-rw-r--r--src/lib.rs42
1 files changed, 1 insertions, 41 deletions
diff --git a/src/lib.rs b/src/lib.rs
index 3a20e7f..ff2ec56 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,44 +1,4 @@
-//! ALINE
-//! <https://webdocs.cs.ualberta.ca/~kondrak/>
-//! Copyright 2002 by Grzegorz Kondrak.
-//!
-//! ALINE is an algorithm for aligning phonetic sequences, described in \[1\].
-//! This module is a port of Kondrak's (2002) ALINE. It provides functions for
-//! phonetic sequence alignment and similarity analysis. These are useful in
-//! historical linguistics, sociolinguistics and synchronic phonology.
-//!
-//! ALINE has parameters that can be tuned for desired output. These parameters are:
-//! - C_skip, C_sub, C_exp, C_vwl
-//! - Salience weights
-//! - Segmental features
-//!
-//! In this implementation, some parameters have been changed from their default
-//! values as described in \[1\], in order to replicate published results. All changes
-//! are noted in comments.
-//!
-//! # Get optimal alignment of two phonetic sequences
-//!
-//! ```
-//! use aline::align;
-//!
-//! let alignment = align("θin", "tenwis", 0.0);
-//!
-//! assert_eq!(
-//! alignment,
-//! vec![
-//! vec![
-//! ("θ", "t"),
-//! ("i", "e"),
-//! ("n", "n")
-//! ].iter()
-//! .map(|(a, b)| (a.to_string(), b.to_string()))
-//! .collect::<Vec<(String, String)>>()
-//! ]
-//! );
-//! ```
-//!
-//! \[1\] G. Kondrak. Algorithms for Language Reconstruction. PhD dissertation,
-//! University of Toronto.
+#![doc = include_str!("../README.md")]
use std::{collections::HashSet, f64};