From 433010a900f51bf6c16f945c4b2496236f4ad489 Mon Sep 17 00:00:00 2001 From: Veloman Yunkan Date: Wed, 6 Mar 2024 19:56:30 +0400 Subject: [PATCH] Clarified handling of naming conflicts --- docs/kiwix-serve.rst | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/kiwix-serve.rst b/docs/kiwix-serve.rst index 24dbad8..553fb0e 100644 --- a/docs/kiwix-serve.rst +++ b/docs/kiwix-serve.rst @@ -820,6 +820,14 @@ Glossary library XML file (for a ``kiwix-serve`` started with the :option:`--library` option). + .. note:: + + Two or more books may have the same name in the library. That's not + considered a conflict, because there may be multiple versions of the + "same" book (differing by the settings of the scraper, date, etc). + :ref:`Library filtering ` by name will return all + matching books. + ZIM filename Name of a ZIM file on the server filesystem. @@ -843,7 +851,8 @@ Glossary ZIM names are expected to be unique across the library. Any name conflicts (including those caused by the usage of the :option:`-z`/:option:`--nodatealiases` option) are reported on STDERR but, - otherwise, are ignored. + otherwise, are ignored (i.e. only one of the entries can be accessed via + the conflicting name). ZIM title