"segments.gen" and "segments_3" files ?

[Caolán McNamara]

On Sun, 2024-01-14 at 12:36 +0100, Jérôme Bouat wrote:
> Hello.
> 
> Is there a documentation in order to understand what those files are
> used for ?
> 
> share/extensions/nlpsolver/help/*/help.idxl/segments.gen
> share/extensions/wiki-publisher/help/*/help.idxl/segments.gen
> share/extensions/wiki-publisher/help/*/help.idxl/segments_3

We index "help" with clucene the C++ version of lucene, so we can
implement search in our (offline) help. These "segments" files are
created/used by [c]lucene.

lucene has some documentation on these segments files
at https://lucene.apache.org/core/3_0_3/fileformats.html#File%20Naming
(which I've never actually read)

Their existence in extensions probably dates back to:
https://wiki.openoffice.org/wiki/Extensible_Help_Project_Plan
FWIW