From b6cc16f3301251f5d48f354120c2b6dde9bd3e6c Mon Sep 17 00:00:00 2001 From: Jan Tuomi Date: Mon, 7 Oct 2024 18:54:05 +0300 Subject: Improve docs --- log_db/src/lib.rs | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/log_db/src/lib.rs b/log_db/src/lib.rs index 9c25dd8..49caabc 100644 --- a/log_db/src/lib.rs +++ b/log_db/src/lib.rs @@ -46,15 +46,16 @@ impl<'a, Field: Eq + Clone + Debug> ConfigBuilder { } } - /// Directory where the database will store its data. + /// The directory where the database will store its data. pub fn data_dir(&mut self, data_dir: &str) -> &mut Self { self.data_dir = Some(data_dir.to_string()); self } /// The maximum size of a segment file in bytes. - /// Once a segment file reaches this size, it is closed and a new one is created. - /// Closed segment files can be compacted. + /// Once a segment file reaches this size, it can be closed, rotated and compacted. + /// Note that this is not a hard limit: if `db.do_maintenance_tasks()` is not called, + /// the segment file may continue to grow. pub fn segment_size(&mut self, segment_size: usize) -> &mut Self { self.segment_size = Some(segment_size); self -- cgit v1.3