AuxXxilium/kmod
1
0
Fork 0
mirror of https://github.com/AuxXxilium/kmod.git synced 2024-11-23 23:10:53 +07:00
Code Issues Actions Packages Projects Releases Wiki Activity
master
kmod/man/Makefile.am

29 lines
734 B
Makefile
Raw Permalink Normal View History

man: build modules.dep{,.bin} man pages
2012-01-12 22:34:09 +07:00
MAN5 = depmod.d.5 modprobe.d.5 modules.dep.5
Add the man page for kmod(8)
2014-09-17 10:12:27 +07:00
MAN8 = kmod.8 depmod.8 insmod.8 lsmod.8 rmmod.8 modprobe.8 modinfo.8
fix manpage build and install. just build and install manpages if tools are enabled. List stub modules.dep.bin in proper variable.
2012-02-01 07:16:47 +07:00
MAN_STUB = modules.dep.bin.5
build-sys: build man pages
2012-01-12 20:48:21 +07:00
man: build the scdoc based man pages Note that scdoc does not handle natively handle the dummy modules.dep.bin.5 entry, so we need to create one manually. Not a big deal, since it's single static line anyway. Also: pkg-config --variable=scdoc scdoc, produces the full executable and path, although for now we stick with the AC_PATH_PROG approach. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> [ Do not add the stub man page (modules.dep.bin.5) to CLEANFILES to avoid removing a file that is tracked by git. Also fix a typo s/AM_V_SCDOR_/AM_V_SCDOC_/ to make silent rules to work ] Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-06-11 22:05:03 +07:00
AM_V_SCDOC = $(AM_V_SCDOC_$(V))
AM_V_SCDOC_ = $(AM_V_SCDOC_$(AM_DEFAULT_VERBOSITY))
AM_V_SCDOC_0 = @echo " SCDOC " $@;
man: make error message clearer for missing xstlproc We can't do at configure phase since we actually ship the built man pages with dist, so it's fine not having xsltproc if building from dist. If building from the repository, it's better to have have a better message saying xsltproc was not found than trying to execute the argument to xsltproc. Now message is: XSLT depmod.d.5 /bin/sh: line 1: xsltproc: command not found Instead of: XSLT depmod.d.5 /bin/sh: --nonet: command not found
2017-02-24 09:28:27 +07:00
fix manpage build and install. just build and install manpages if tools are enabled. List stub modules.dep.bin in proper variable.
2012-02-01 07:16:47 +07:00
if BUILD_TOOLS
man: build modules.dep{,.bin} man pages
2012-01-12 22:34:09 +07:00
dist_man_MANS = $(MAN5) $(MAN8) $(MAN_STUB)
fix manpage build and install. just build and install manpages if tools are enabled. List stub modules.dep.bin in proper variable.
2012-02-01 07:16:47 +07:00
endif
build-sys: build man pages
2012-01-12 20:48:21 +07:00
man: build the scdoc based man pages Note that scdoc does not handle natively handle the dummy modules.dep.bin.5 entry, so we need to create one manually. Not a big deal, since it's single static line anyway. Also: pkg-config --variable=scdoc scdoc, produces the full executable and path, although for now we stick with the AC_PATH_PROG approach. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> [ Do not add the stub man page (modules.dep.bin.5) to CLEANFILES to avoid removing a file that is tracked by git. Also fix a typo s/AM_V_SCDOR_/AM_V_SCDOC_/ to make silent rules to work ] Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-06-11 22:05:03 +07:00
EXTRA_DIST = $(MAN5:%.5=%.5.scd) $(MAN8:%.8=%.8.scd)
CLEANFILES = $(filter-out $(MAN_STUB), $(dist_man_MANS))
fix building and cleaning of manpages - add modules.dep as an explicit dependency of modules.dep.bin to ensure parallel builds don't fail - add generated man pages to CLEANFILES
2012-02-03 05:24:03 +07:00
man: silence autoconf warnings Currently we have a pattern rule, which effective states that two output files are produced - %.5 and %.8. Although that's not the case in practise, since each input xml will be generated to a single manual page. Add the manpage section as part of the xml filename and tweak the pattern (match) rule, accordingly. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> Link: https://lore.kernel.org/r/20240217-autoconf-manpage-warns-v1-1-e1570cfc286e@gmail.com Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-02-17 23:01:26 +07:00
define generate_manpage
man: stop removing DISTCONFDIR lines Presently when DISTCONFDIR is identical to /lib we remove the whole line, since the man pages already have an /lib instance. At the same time, there are in-text DISTCONFDIR entries, and removing the whole line outright breaks the documentation. Drop the removal line - worst case scenario we get a duplicate entry in the synopsis. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-07-08 20:43:14 +07:00
$(AM_V_SCDOC)cat $< | \
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>
2024-07-08 20:43:15 +07:00
sed -e 's|@SYSCONFDIR@|$(sysconfdir)|g' | \
man: stop removing DISTCONFDIR lines Presently when DISTCONFDIR is identical to /lib we remove the whole line, since the man pages already have an /lib instance. At the same time, there are in-text DISTCONFDIR entries, and removing the whole line outright breaks the documentation. Drop the removal line - worst case scenario we get a duplicate entry in the synopsis. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-07-08 20:43:14 +07:00
sed -e 's|@DISTCONFDIR@|$(distconfdir)|g' | \
libkmod, depmod, modprobe: Make directory for kernel modules configurable Now that modprobe.d is searched under ${prefix}/lib, allow a complete transition to files only under ${prefix} by adding a ${module_directory} configuration. This specifies the directory where to search for kernel modules and should match the location where the kernel/distro installs them. With this distributions that do not want to ship files in /lib can also move kernel modules to /usr while others can keep them in /lib. Signed-off-by: Michal Suchanek <msuchanek@suse.de> Link: https://lore.kernel.org/r/a3765f4e8ae3ce29c0847a0132d4a8d51ad040a9.1699618135.git.msuchanek@suse.de Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2023-11-10 19:13:54 +07:00
sed -e 's|@MODULE_DIRECTORY@|$(module_directory)|g' | \
man: build the scdoc based man pages Note that scdoc does not handle natively handle the dummy modules.dep.bin.5 entry, so we need to create one manually. Not a big deal, since it's single static line anyway. Also: pkg-config --variable=scdoc scdoc, produces the full executable and path, although for now we stick with the AC_PATH_PROG approach. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> [ Do not add the stub man page (modules.dep.bin.5) to CLEANFILES to avoid removing a file that is tracked by git. Also fix a typo s/AM_V_SCDOR_/AM_V_SCDOC_/ to make silent rules to work ] Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-06-11 22:05:03 +07:00
$(SCDOC) > $@
man: silence autoconf warnings Currently we have a pattern rule, which effective states that two output files are produced - %.5 and %.8. Although that's not the case in practise, since each input xml will be generated to a single manual page. Add the manpage section as part of the xml filename and tweak the pattern (match) rule, accordingly. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> Link: https://lore.kernel.org/r/20240217-autoconf-manpage-warns-v1-1-e1570cfc286e@gmail.com Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-02-17 23:01:26 +07:00
endef
man: build the scdoc based man pages Note that scdoc does not handle natively handle the dummy modules.dep.bin.5 entry, so we need to create one manually. Not a big deal, since it's single static line anyway. Also: pkg-config --variable=scdoc scdoc, produces the full executable and path, although for now we stick with the AC_PATH_PROG approach. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> [ Do not add the stub man page (modules.dep.bin.5) to CLEANFILES to avoid removing a file that is tracked by git. Also fix a typo s/AM_V_SCDOR_/AM_V_SCDOC_/ to make silent rules to work ] Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-06-11 22:05:03 +07:00
%.5: %.5.scd
man: silence autoconf warnings Currently we have a pattern rule, which effective states that two output files are produced - %.5 and %.8. Although that's not the case in practise, since each input xml will be generated to a single manual page. Add the manpage section as part of the xml filename and tweak the pattern (match) rule, accordingly. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> Link: https://lore.kernel.org/r/20240217-autoconf-manpage-warns-v1-1-e1570cfc286e@gmail.com Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-02-17 23:01:26 +07:00
$(generate_manpage)
man: build the scdoc based man pages Note that scdoc does not handle natively handle the dummy modules.dep.bin.5 entry, so we need to create one manually. Not a big deal, since it's single static line anyway. Also: pkg-config --variable=scdoc scdoc, produces the full executable and path, although for now we stick with the AC_PATH_PROG approach. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> [ Do not add the stub man page (modules.dep.bin.5) to CLEANFILES to avoid removing a file that is tracked by git. Also fix a typo s/AM_V_SCDOR_/AM_V_SCDOC_/ to make silent rules to work ] Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-06-11 22:05:03 +07:00
%.8: %.8.scd
man: silence autoconf warnings Currently we have a pattern rule, which effective states that two output files are produced - %.5 and %.8. Although that's not the case in practise, since each input xml will be generated to a single manual page. Add the manpage section as part of the xml filename and tweak the pattern (match) rule, accordingly. Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com> Link: https://lore.kernel.org/r/20240217-autoconf-manpage-warns-v1-1-e1570cfc286e@gmail.com Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-02-17 23:01:26 +07:00
$(generate_manpage)
Reference in New Issue Copy Permalink