Order of configuration items in Firebird Configuration Reference

[Mark Rotteveel]

Currently, the Firebird Configuration Reference[1] lists the
configuration items in the order they appear in the example
configuration files.

This is less than ideal, as it makes it harder to find a configuration
item by eyeballing the list in the table of contents than if they were
listed in alphabetical order (e.g. see the TOC to the left on [2] or on
[3]).

On the other hand, in the current order, usually, related items are
close together.

The simplest solution would be to sort the list alphabetically, but then
this grouping gets lost.

I could also group by topic and sort within the group, but this would
need groups with an appropriate granularity (i.e. not have groups with
only one or two items, but also not groups so broad they become
meaningless).

Any thoughts on this, and if grouping: what kind of groups to go for?

Mark

[1]:
https://firebirdsql.org/file/documentation/html/en/refdocs/fbconf/firebird-configuration-reference.html
[2]:
https://firebirdsql.org/file/documentation/html/en/refdocs/fbconf/firebird-configuration-reference.html#fbconf-firebird-cfg
[3]:
https://firebirdsql.org/file/documentation/chunk/en/refdocs/fbconf/firebird-configuration-reference.html
--
Mark Rotteveel

[Dimitry Sibiryakov]

'Mark Rotteveel' via firebird-devel wrote 07.06.2026 14:01:
>
> The simplest solution would be to sort the list alphabetically, but then this
> grouping gets lost.

Usual solution is "both": two separate tables "items by alphabet" and "item
by group" with links to topics. Often seen as "TOC" and "Index" (or "Glossary").


--
WBR, SD.