fdo-mirrors/NetworkManager
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git synced 2026-01-01 04:50:11 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
NetworkManager/man/Makefile.am

74 lines
1.5 KiB
Text
Raw Normal View History

man: Fix previous commit to honor --disable-doc In that mode, we shouldn't attempt to generate any manpages. While we're here, rewrite this file (using nonrecursive style) so we don't install non-generated ones either. Signed-off-by: Colin Walters <walters@verbum.org>
2013-02-09 11:54:35 -05:00
man_MANS =
CLEANFILES =
man: fix distcheck Also, we can get rid of tools/manpages-docbook.xsl and just specify the canonical URL directly.
2013-05-02 11:20:42 -04:00
EXTRA_DIST =
man: generate nm-settings.5 manual page (bgo #673520) We only generate the page when configured "--with-docs", because we need xsl stylesheets that are pulled in by gtk-doc.
2013-01-16 19:37:42 +01:00
man: fix distcheck Also, we can get rid of tools/manpages-docbook.xsl and just specify the canonical URL directly.
2013-05-02 11:20:42 -04:00
XSLTPROC = xsltproc
man: generate nm-settings.5 manual page (bgo #673520) We only generate the page when configured "--with-docs", because we need xsl stylesheets that are pulled in by gtk-doc.
2013-01-16 19:37:42 +01:00
man: generate nm-settings.xml from libnm-util/nm-setting-docs.xml Generate man/nm-settings.xml via an XSLT stylesheet applied to libnm-util/nm-setting-docs.xml.
2014-06-13 11:08:56 -04:00
XSLTPROC_FLAGS = --xinclude --nonet
XSLTPROC_MAN_FLAGS = \
$(XSLTPROC_FLAGS) \
man: fix distcheck Also, we can get rid of tools/manpages-docbook.xsl and just specify the canonical URL directly.
2013-05-02 11:20:42 -04:00
--stringparam man.output.quietly 1 \
--stringparam funcsynopsis.style ansi \
--stringparam man.th.extra1.suppress 1 \
--stringparam man.authors.section.enabled 0 \
man: generate nm-settings.xml from libnm-util/nm-setting-docs.xml Generate man/nm-settings.xml via an XSLT stylesheet applied to libnm-util/nm-setting-docs.xml.
2014-06-13 11:08:56 -04:00
--stringparam man.copyright.section.enabled 0 \
http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
man: rewrite NetworkManager.8 and NetworkManager.conf.5 in DocBook DocBook is not my favorite thing in the world, but it's <lots-of-emphasis>far</lots-of-emphasis> saner than troff. Some style parts cribbed from systemd. This is preparatory work for actually improving the content of the man pages.
2013-04-09 16:41:00 -04:00
build: always generate docs at dist time (bgo #700093) dist tarballs shouldn't ever be released without the documentation, and this allows us to build the tarballs with pre-generated docs that get installed on the end system, but don't need to be built there. So the end system doesn't need gtk-doc installed, only the dist system does. https://bugzilla.gnome.org/show_bug.cgi?id=700093
2013-05-10 09:55:09 -05:00
if ENABLE_GTK_DOC
man: rewrite NetworkManager.8 and NetworkManager.conf.5 in DocBook DocBook is not my favorite thing in the world, but it's <lots-of-emphasis>far</lots-of-emphasis> saner than troff. Some style parts cribbed from systemd. This is preparatory work for actually improving the content of the man pages.
2013-04-09 16:41:00 -04:00
%.8: %.xml
$(AM_V_GEN) xsltproc $(XSLTPROC_MAN_FLAGS) $<
%.5: %.xml
$(AM_V_GEN) xsltproc $(XSLTPROC_MAN_FLAGS) $<
man: generate nm-settings.xml from libnm-util/nm-setting-docs.xml Generate man/nm-settings.xml via an XSLT stylesheet applied to libnm-util/nm-setting-docs.xml.
2014-06-13 11:08:56 -04:00
nm-settings.xml: nm-settings.xsl $(top_builddir)/libnm-util/nm-setting-docs.xml
$(AM_V_GEN) xsltproc \
--output $@ \
--stringparam version $(NM_VERSION) \
--stringparam date "`date +'%d %B %Y'`" \
$^
man: fix distcheck Also, we can get rid of tools/manpages-docbook.xsl and just specify the canonical URL directly.
2013-05-02 11:20:42 -04:00
build: always generate docs at dist time (bgo #700093) dist tarballs shouldn't ever be released without the documentation, and this allows us to build the tarballs with pre-generated docs that get installed on the end system, but don't need to be built there. So the end system doesn't need gtk-doc installed, only the dist system does. https://bugzilla.gnome.org/show_bug.cgi?id=700093
2013-05-10 09:55:09 -05:00
endif
man: fix distcheck Also, we can get rid of tools/manpages-docbook.xsl and just specify the canonical URL directly.
2013-05-02 11:20:42 -04:00
configure_generated_man_pages = \
man: generate nm-settings.5 manual page (bgo #673520) We only generate the page when configured "--with-docs", because we need xsl stylesheets that are pulled in by gtk-doc.
2013-01-16 19:37:42 +01:00
nmcli.1 \
man: fix distcheck Also, we can get rid of tools/manpages-docbook.xsl and just specify the canonical URL directly.
2013-05-02 11:20:42 -04:00
nm-online.1 \
nm-system-settings.conf.5
docbook_generated_man_pages = \
NetworkManager.8 \
man: add 'nmcli-examples' manual page with examples of nmcli usage (and add a reference to 'nmcli-examples' to other man pages)
2013-05-07 09:55:05 +02:00
NetworkManager.conf.5 \
nmcli-examples.5
man: fix distcheck Also, we can get rid of tools/manpages-docbook.xsl and just specify the canonical URL directly.
2013-05-02 11:20:42 -04:00
docbook_autogenerated_man_pages = \
build: Don't install generated xml file as man page
2013-02-09 17:09:44 +01:00
nm-settings.5
2006-01-20 Robert Love <rml@novell.com> * Makefile.am, configure.in: Add new man subdirectory. * man, man/NetworkManager.1.in, man/NetworkManagerDispatcher.1.in, man/Makefile.am: Add man pages for NetworkManager and its crime-solving bumbling buddy, NetworkManagerDispatcher. git-svn-id: http://svn-archive.gnome.org/svn/NetworkManager/trunk@1367 4912f4e0-d625-0410-9fb7-b9a5a253dbdc
2006-01-20 21:10:33 +00:00
build: always generate docs at dist time (bgo #700093) dist tarballs shouldn't ever be released without the documentation, and this allows us to build the tarballs with pre-generated docs that get installed on the end system, but don't need to be built there. So the end system doesn't need gtk-doc installed, only the dist system does. https://bugzilla.gnome.org/show_bug.cgi?id=700093
2013-05-10 09:55:09 -05:00
generated_man_pages = \
$(docbook_generated_man_pages) \
$(docbook_autogenerated_man_pages)
man: fix distcheck Also, we can get rid of tools/manpages-docbook.xsl and just specify the canonical URL directly.
2013-05-02 11:20:42 -04:00
build: always generate docs at dist time (bgo #700093) dist tarballs shouldn't ever be released without the documentation, and this allows us to build the tarballs with pre-generated docs that get installed on the end system, but don't need to be built there. So the end system doesn't need gtk-doc installed, only the dist system does. https://bugzilla.gnome.org/show_bug.cgi?id=700093
2013-05-10 09:55:09 -05:00
EXTRA_DIST += \
man: generate nm-settings.xml from libnm-util/nm-setting-docs.xml Generate man/nm-settings.xml via an XSLT stylesheet applied to libnm-util/nm-setting-docs.xml.
2014-06-13 11:08:56 -04:00
nm-settings.xml \
nm-settings.xsl \
build: always generate docs at dist time (bgo #700093) dist tarballs shouldn't ever be released without the documentation, and this allows us to build the tarballs with pre-generated docs that get installed on the end system, but don't need to be built there. So the end system doesn't need gtk-doc installed, only the dist system does. https://bugzilla.gnome.org/show_bug.cgi?id=700093
2013-05-10 09:55:09 -05:00
$(docbook_generated_man_pages:.%=.xml) \
man: fix distcheck Also, we can get rid of tools/manpages-docbook.xsl and just specify the canonical URL directly.
2013-05-02 11:20:42 -04:00
$(docbook_autogenerated_man_pages)
man: generate nm-settings.xml from libnm-util/nm-setting-docs.xml Generate man/nm-settings.xml via an XSLT stylesheet applied to libnm-util/nm-setting-docs.xml.
2014-06-13 11:08:56 -04:00
DISTCLEANFILES = \
build: always generate docs at dist time (bgo #700093) dist tarballs shouldn't ever be released without the documentation, and this allows us to build the tarballs with pre-generated docs that get installed on the end system, but don't need to be built there. So the end system doesn't need gtk-doc installed, only the dist system does. https://bugzilla.gnome.org/show_bug.cgi?id=700093
2013-05-10 09:55:09 -05:00
nm-settings.xml
man_MANS += $(configure_generated_man_pages)
if ENABLE_GTK_DOC
man_MANS += $(generated_man_pages)
man: only remove the man pages in "make clean" if we built them doing: ./configure --disable-gtk-doc make clean make from a tarball build (or from a dirty tree that had previously had an --enable-gtk-doc build) would fail, because configure would see the pre-existing man pages and set INSTALL_PREGEN_MANPAGES, but "make clean" would delete them, and there'd be no rule to regenerate them.
2013-06-13 17:45:52 -03:00
CLEANFILES += \
$(docbook_autogenerated_man_pages) \
$(docbook_generated_man_pages)
build: always generate docs at dist time (bgo #700093) dist tarballs shouldn't ever be released without the documentation, and this allows us to build the tarballs with pre-generated docs that get installed on the end system, but don't need to be built there. So the end system doesn't need gtk-doc installed, only the dist system does. https://bugzilla.gnome.org/show_bug.cgi?id=700093
2013-05-10 09:55:09 -05:00
else
if INSTALL_PREGEN_MANPAGES
man_MANS += $(generated_man_pages)
man: Fix previous commit to honor --disable-doc In that mode, we shouldn't attempt to generate any manpages. While we're here, rewrite this file (using nonrecursive style) so we don't install non-generated ones either. Signed-off-by: Colin Walters <walters@verbum.org>
2013-02-09 11:54:35 -05:00
endif
build: always generate docs at dist time (bgo #700093) dist tarballs shouldn't ever be released without the documentation, and this allows us to build the tarballs with pre-generated docs that get installed on the end system, but don't need to be built there. So the end system doesn't need gtk-doc installed, only the dist system does. https://bugzilla.gnome.org/show_bug.cgi?id=700093
2013-05-10 09:55:09 -05:00
endif
Reference in a new issue Copy permalink