From 8b1c0d0dc1796c6c4233e1d6244e3e26230216c0 Mon Sep 17 00:00:00 2001
From: CismonX <admin@cismon.net>
Date: Mon, 20 Jan 2025 20:08:06 +0800
Subject: [PATCH] doc: misc update

---
 doc/bookmarkfs.texi | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/doc/bookmarkfs.texi b/doc/bookmarkfs.texi
index bba3030..2d2caf1 100644
--- a/doc/bookmarkfs.texi
+++ b/doc/bookmarkfs.texi
@@ -134,6 +134,9 @@ on FreeBSD, which includes:
 @item Online filesystem check (@pxref{Online Filesystem Check})
 @end itemize
 
+Meanwhile, FreeBSD does not support @code{FUSE_READDIRPLUS} and directory
+entry caching, which makes listing directory entries less efficient.
+
 
 @node Sandboxing
 @section Sandboxing
@@ -261,8 +264,8 @@ This behavior may be inefficient, but makes applications that depend on ctime
 less fragile.
 @end table
 
-The kernel may cache file attributes, making ctime appear more ``correct''
-than what we claim.
+The kernel may automatically update and cache ctime,
+making it more ``correct'' than what we expect.
 However, this behavior should not be relied upon.
 
 @item -o eol
@@ -410,6 +413,8 @@ Always backup the bookmark storage before repairing, or risk losing your data!
 Readline application name in interactive mode.
 Defaults to @samp{fsck.bookmarkfs}.
 
+@xref{Conditional Init Constructs,,, readline, GNU Readline Library}.
+
 @item -o type=bookmark|tag|keyword
 Subsystem type (@pxref{Hierarchy}).
 Defaults to @samp{bookmark}.
@@ -706,7 +711,7 @@ If the original file is already associated with another keyword,
 
 When a filesystem operation fails, the kernel returns an error code for the
 system call.
-In addition to common error codes, there's few more in BookmarkFS:
+In addition to common error codes, there are a few more in BookmarkFS:
 
 @table @code
 @item EPERM
@@ -1370,7 +1375,8 @@ Defaults to @samp{% }.
 This option is ignored in non-interactive mode.
 
 @item translit=@var{char}
-Transliterate bad characters into @var{char}.
+Transliterate bad (@samp{/}) characters into @var{char}
+(must be a single ASCII character).
 Defaults to @samp{_}.
 @end table