mirror of
https://git.kernel.org/pub/scm/libs/libgpiod/libgpiod.git
synced 2026-10-24 00:48:53 +03:00
3b4a2ced02
Extend the build files under man/ to also generate man pages for gpio-manager, gpiocli and each of the former's sub-commands. Reviewed-by: Vincent Fazio <vfazio@xes-inc.com> Link: https://lore.kernel.org/r/20250211-improve-docs-v4-11-dc56702c2ca8@linaro.org Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
71 lines
1.5 KiB
Makefile
71 lines
1.5 KiB
Makefile
# SPDX-License-Identifier: GPL-2.0-or-later
|
|
# SPDX-FileCopyrightText: 2017-2021 Bartosz Golaszewski <bartekgola@gmail.com>
|
|
# SPDX-FileCopyrightText: 2025 Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
|
|
|
|
MAN_ENTRIES =
|
|
MAN_DEPS =
|
|
|
|
if WITH_TOOLS
|
|
|
|
TOOLS = \
|
|
gpiodetect \
|
|
gpioinfo \
|
|
gpioget \
|
|
gpioset \
|
|
gpiomon \
|
|
gpionotify
|
|
|
|
MAN_ENTRIES += $(TOOLS)
|
|
MAN_DEPS += $(foreach dep,$(TOOLS),$(top_builddir)/tools/$(dep))
|
|
|
|
endif
|
|
|
|
if WITH_DBUS
|
|
|
|
GPIOCLI_CMDS = \
|
|
detect \
|
|
find \
|
|
info \
|
|
get \
|
|
monitor \
|
|
notify \
|
|
reconfigure \
|
|
release \
|
|
request \
|
|
requests \
|
|
set \
|
|
wait
|
|
|
|
MAN_ENTRIES += \
|
|
gpio-manager \
|
|
gpiocli \
|
|
$(foreach cmd,$(GPIOCLI_CMDS),gpiocli-$(cmd))
|
|
|
|
MAN_DEPS += \
|
|
$(top_builddir)/dbus/manager/gpio-manager
|
|
$(top_builddir)/dbus/client/gpiocli
|
|
|
|
endif
|
|
|
|
dist_man1_MANS := $(foreach entry,$(MAN_ENTRIES),$(entry).man)
|
|
|
|
%.man: $(MAN_DEPS)
|
|
$(AM_V_GEN)export PATH=$(top_builddir)/dbus/manager/:$(top_builddir)/dbus/client/:$(top_builddir)/tools/:$$PATH; \
|
|
if [ "$(*F)" = "gpio-manager" ]; then \
|
|
EXEC=$(*F); \
|
|
NAME="libgpiod D-Bus daemon"; \
|
|
HELP=--help-option=--help; \
|
|
else \
|
|
EXEC=$(if $(findstring -,$(*F)),$(word 1,$(subst -, ,$(*F))),$(*F)); \
|
|
NAME=$(if $(findstring -,$(*F)),$(word 2,$(subst -, ,$(*F))),"libgpiod command-line utility"); \
|
|
HELP=$(if $(findstring -,$(*F)),--help-option="$(word 2,$(subst -, ,$(*F))) --help",--help-option=--help); \
|
|
fi; \
|
|
help2man $$EXEC \
|
|
--include=$(srcdir)/template --output=$(builddir)/$@ --no-info \
|
|
--name="$$NAME" "$$HELP" --manual=$(*F)
|
|
|
|
clean-local:
|
|
rm -f $(dist_man1_MANS)
|
|
|
|
EXTRA_DIST = template
|