mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2025-12-28 04:00:09 +01:00
c14486984e
Move the settings/plugins doc generation from libnm-util to libnm-core, since libnm-util isn't being updated for all new properties. With this commit, the keyfile and ifcfg-rh documentation is basically unchanged, except that deprecated properties are now gone, and new properties have been added, and the sections are in a different order. (generate-plugin-docs.pl just outputs the settings in Makefile order, and they were unsorted in libnm-util, but are sorted in libnm-core). The settings documentation used for nm-settings.5, the D-Bus API docs, and the nmcli help is changed a bit more at this point, and mostly for the worse, since the libnm-core setting properties don't match up with the D-Bus API as well as the libnm-util ones do. To be fixed... (I also removed the "plugins docs" line in each plugin docs comment block while moving them, since those blocks will be used for more than just plugins soon, and it's sort of obvious anyway.)
112 lines
2.5 KiB
Makefile
112 lines
2.5 KiB
Makefile
man_MANS =
|
|
CLEANFILES =
|
|
EXTRA_DIST =
|
|
|
|
XSLTPROC = xsltproc
|
|
|
|
XSLTPROC_FLAGS = --xinclude --nonet
|
|
|
|
XSLTPROC_MAN_FLAGS = \
|
|
$(XSLTPROC_FLAGS) \
|
|
--stringparam man.output.quietly 1 \
|
|
--stringparam funcsynopsis.style ansi \
|
|
--stringparam man.th.extra1.suppress 1 \
|
|
--stringparam man.authors.section.enabled 0 \
|
|
--stringparam man.copyright.section.enabled 0 \
|
|
http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
|
|
|
|
if ENABLE_GTK_DOC
|
|
|
|
%.8: %.xml
|
|
$(AM_V_GEN) xsltproc $(XSLTPROC_MAN_FLAGS) $<
|
|
|
|
%.5: %.xml
|
|
$(AM_V_GEN) xsltproc $(XSLTPROC_MAN_FLAGS) $<
|
|
|
|
endif
|
|
|
|
if BUILD_SETTING_DOCS
|
|
|
|
nm-settings.xml: nm-settings.xsl $(top_builddir)/libnm/nm-setting-docs.xml
|
|
$(AM_V_GEN) xsltproc \
|
|
--output $@ \
|
|
--stringparam version $(NM_VERSION) \
|
|
--stringparam date "`date +'%d %B %Y'`" \
|
|
$^
|
|
|
|
nm-settings-keyfile.xml: nm-settings-keyfile.xsl $(top_builddir)/libnm/nm-keyfile-docs.xml
|
|
$(AM_V_GEN) xsltproc \
|
|
--output $@ \
|
|
--stringparam version $(NM_VERSION) \
|
|
--stringparam date "`date +'%d %B %Y'`" \
|
|
$^
|
|
|
|
nm-settings-ifcfg-rh.xml: nm-settings-ifcfg-rh.xsl $(top_builddir)/libnm/nm-ifcfg-rh-docs.xml
|
|
$(AM_V_GEN) xsltproc \
|
|
--output $@ \
|
|
--stringparam version $(NM_VERSION) \
|
|
--stringparam date "`date +'%d %B %Y'`" \
|
|
$^
|
|
|
|
CLEANFILES += \
|
|
nm-settings.xml \
|
|
nm-settings-keyfile.xml \
|
|
nm-settings-ifcfg-rh.xml
|
|
|
|
endif
|
|
|
|
configure_generated_man_pages = \
|
|
nmcli.1 \
|
|
nmtui.1 \
|
|
nm-online.1 \
|
|
nm-system-settings.conf.5
|
|
|
|
docbook_generated_man_pages = \
|
|
NetworkManager.8 \
|
|
NetworkManager.conf.5 \
|
|
nmcli-examples.5
|
|
|
|
docbook_autogenerated_man_pages = \
|
|
nm-settings.5 \
|
|
nm-settings-keyfile.5 \
|
|
nm-settings-ifcfg-rh.5
|
|
|
|
EXTRA_DIST += \
|
|
nm-settings.xml \
|
|
nm-settings.xsl \
|
|
nm-settings-keyfile.xml \
|
|
nm-settings-keyfile.xsl \
|
|
nm-settings-ifcfg-rh.xml \
|
|
nm-settings-ifcfg-rh.xsl \
|
|
$(docbook_generated_man_pages:.%=.xml) \
|
|
$(docbook_autogenerated_man_pages)
|
|
|
|
man_MANS += $(configure_generated_man_pages)
|
|
|
|
links = nmtui-edit nmtui-connect nmtui-hostname
|
|
|
|
install-data-hook:
|
|
for link in $(links); do \
|
|
ln -f $(DESTDIR)$(mandir)/man1/nmtui.1 $(DESTDIR)$(mandir)/man1/$$link.1; \
|
|
done
|
|
|
|
uninstall-hook:
|
|
for link in $(links); do \
|
|
rm -f $(DESTDIR)$(mandir)/man1/$$link.1; \
|
|
done
|
|
|
|
if ENABLE_GTK_DOC
|
|
man_MANS += $(docbook_generated_man_pages)
|
|
CLEANFILES += $(docbook_generated_man_pages)
|
|
if BUILD_SETTING_DOCS
|
|
man_MANS += $(docbook_autogenerated_man_pages)
|
|
CLEANFILES += $(docbook_autogenerated_man_pages)
|
|
endif
|
|
else
|
|
if INSTALL_PREGEN_MANPAGES
|
|
man_MANS += \
|
|
$(docbook_generated_man_pages) \
|
|
$(docbook_autogenerated_man_pages)
|
|
endif
|
|
endif
|
|
|