man: depmod.d: document the config file order handling

The depmod.d configuration order/handling aligns with existing tools
such as sysctl.d, even though there is no mention in the manual.

Reorder the list in SYNOPSIS and add a bit of verbiage describing things.

Section is inspired by sysctl.d(5) and sysctl(8).

Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
This commit is contained in:
Emil Velikov 2024-07-08 14:43:15 +01:00 committed by Lucas De Marchi
parent 52a9d42464
commit 12ca199bd7
2 changed files with 19 additions and 6 deletions

View File

@ -15,6 +15,7 @@ CLEANFILES = $(filter-out $(MAN_STUB), $(dist_man_MANS))
define generate_manpage
$(AM_V_SCDOC)cat $< | \
sed -e 's|@SYSCONFDIR@|$(sysconfdir)|g' | \
sed -e 's|@DISTCONFDIR@|$(distconfdir)|g' | \
sed -e 's|@MODULE_DIRECTORY@|$(module_directory)|g' | \
$(SCDOC) > $@

View File

@ -6,15 +6,15 @@ depmod.d - Configuration directory for depmod
# SYNOPSIS
/lib/depmod.d/\*.conf
@DISTCONFDIR@/depmod.d/\*.conf
/usr/local/lib/depmod.d/\*.conf
@SYSCONFDIR@/depmod.d/\*.conf
/run/depmod.d/\*.conf
/etc/depmod.d/\*.conf
/usr/local/lib/depmod.d/\*.conf
@DISTCONFDIR@/depmod.d/\*.conf
/lib/depmod.d/\*.conf
# DESCRIPTION
@ -29,6 +29,18 @@ lines and lines starting with '#' ignored (useful for adding comments). A '\\'
at the end of a line causes it to continue on the next line, which makes the
files a bit neater.
# CONFIGURATION DIRECTORIES AND PRECEDENCE
Configuration files are read from directories in listed in SYNOPSYS in that
order of precedence. Once a file of a given filename is loaded, any file of the
same name in subsequent directories is ignored.
All configuration files are sorted in lexicographic order, regardless of the
directory they reside in. Configuration files can either be completely replaced
(by having a new configuration file with the same name in a directory of higher
priority) or partially replaced (by having a configuration file that is ordered
later).
# COMMANDS
search _subdirectory..._