For example, lxc.container.conf manpage contains many config options sometimes applicable or not varying on operating environment with its LXC version.
I often need to look for LXC 2.0.0 release notes to know if a config value or feature is supported by LXC version I’m using at that time. I also need to look for LXC 3.0.0 release notes for the same.
Manpages should be more structured, like in the lxc.container.conf case:
OneOption or OneSubOption
- Requirements (1. such as lxc.net.[i].veth.mode requires lxc.net.[i].type = veth ) (2. such as privileged container)
- Allowed values and example if convenient. Each LXC version required if different values are introduced in different LXC version.
- Default value
- Minimal LXC/LXD/LXCfs version