Skip to content

Commit b7c53b6

Browse files
Clarified handling of naming conflicts
1 parent 714d67f commit b7c53b6

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

Diff for: docs/kiwix-serve.rst

+10-1
Original file line numberDiff line numberDiff line change
@@ -820,6 +820,14 @@ Glossary
820820
library XML file (for a ``kiwix-serve`` started with the
821821
-:option:`--library` option).
822822

823+
.. note::
824+
825+
Two or more books may have the same name in the library. That's not
826+
considered a conflict, because there may be multiple versions of the
827+
"same" book (differing by the settings of the scraper, date, etc).
828+
:ref:`Library filtering <library-filtering>` by name will return all
829+
matching books.
830+
823831
ZIM filename
824832

825833
Name of a ZIM file on the server filesystem.
@@ -843,7 +851,8 @@ Glossary
843851
ZIM names are expected to be unique across the library. Any name conflicts
844852
(including those caused by the usage of the
845853
:option:`-z`/:option:`--nodatealiases` option) are reported on STDERR but,
846-
otherwise, are ignored.
854+
otherwise, are ignored (i.e. only one of the entries can be accessed via
855+
the conflicting name).
847856

848857
ZIM title
849858

0 commit comments

Comments
 (0)