From d86dd07d462fb8502b1c7b4a9a4df4fba8318bdd Mon Sep 17 00:00:00 2001 From: =?utf8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Thu, 6 Mar 2014 23:24:30 -0500 Subject: [PATCH] build-sys: update intructions for Makefile-man.am regeneration --- Makefile-man.am | 26 +++++++++++++++++--------- man/systemd.link.xml | 4 ++-- tools/make-man-rules.py | 12 ++++++++++-- 3 files changed, 29 insertions(+), 13 deletions(-) diff --git a/Makefile-man.am b/Makefile-man.am index c232f486d..73afdd8c9 100644 --- a/Makefile-man.am +++ b/Makefile-man.am @@ -1,6 +1,12 @@ # Do not edit. Generated by make-man-rules.py. -# Regenerate with 'make all update-man-list'. - +# To regenerate: +# 1. Create, update, or remove source .xml files in man/ +# 2. Run 'make update-man-list' +# 3. Run 'make man' to generate manpages +# +# To make a man page conditional on a configure switch add +# attribute conditional="ENABLE_WHAT" or conditional="WITH_WHAT" +# to element. MANPAGES += \ man/bootup.7 \ man/busctl.1 \ @@ -85,6 +91,7 @@ MANPAGES += \ man/systemd.exec.5 \ man/systemd.journal-fields.7 \ man/systemd.kill.5 \ + man/systemd.link.5 \ man/systemd.mount.5 \ man/systemd.path.5 \ man/systemd.preset.5 \ @@ -100,9 +107,6 @@ MANPAGES += \ man/systemd.time.7 \ man/systemd.timer.5 \ man/systemd.unit.5 \ - man/systemd.link.5 \ - man/systemd.netdev.5 \ - man/systemd.network.5 \ man/telinit.8 \ man/tmpfiles.d.5 \ man/udev.7 \ @@ -1007,7 +1011,9 @@ endif if ENABLE_NETWORKD MANPAGES += \ - man/systemd-networkd.service.8 + man/systemd-networkd.service.8 \ + man/systemd.netdev.5 \ + man/systemd.network.5 MANPAGES_ALIAS += \ man/systemd-networkd.8 man/systemd-networkd.8: man/systemd-networkd.service.8 @@ -1345,6 +1351,8 @@ MANPAGES_ALIAS += \ endif +# Really, do not edit this file. + EXTRA_DIST += \ man/binfmt.d.xml \ man/bootchart.conf.xml \ @@ -1490,7 +1498,10 @@ EXTRA_DIST += \ man/systemd.index.xml \ man/systemd.journal-fields.xml \ man/systemd.kill.xml \ + man/systemd.link.xml \ man/systemd.mount.xml \ + man/systemd.netdev.xml \ + man/systemd.network.xml \ man/systemd.path.xml \ man/systemd.preset.xml \ man/systemd.resource-control.xml \ @@ -1505,9 +1516,6 @@ EXTRA_DIST += \ man/systemd.time.xml \ man/systemd.timer.xml \ man/systemd.unit.xml \ - man/systemd.link.xml \ - man/systemd.netdev.xml \ - man/systemd.network.xml \ man/systemd.xml \ man/telinit.xml \ man/timedatectl.xml \ diff --git a/man/systemd.link.xml b/man/systemd.link.xml index debe65ee5..718eb8efd 100644 --- a/man/systemd.link.xml +++ b/man/systemd.link.xml @@ -53,12 +53,12 @@ Description - Network link configuration is performed by the net_setup_link + Network link configuration is performed by the net_setup_link udev builtin. The link files are read from the files located in the system network directory /usr/lib/systemd/network, - the volatile runtime network directory /run/systemd/network + the volatile runtime network directory /run/systemd/network, and the local administration network directory /etc/systemd/network. Link files must have the extension .link; other extensions are ignored. All link files are collectively sorted and processed in lexical order, diff --git a/tools/make-man-rules.py b/tools/make-man-rules.py index 6224de3cc..9f46f7b88 100644 --- a/tools/make-man-rules.py +++ b/tools/make-man-rules.py @@ -42,8 +42,14 @@ endif HEADER = '''\ # Do not edit. Generated by make-man-rules.py. -# Regenerate with 'make all update-man-list'. - +# To regenerate: +# 1. Create, update, or remove source .xml files in man/ +# 2. Run 'make update-man-list' +# 3. Run 'make man' to generate manpages +# +# To make a man page conditional on a configure switch add +# attribute conditional="ENABLE_WHAT" or conditional="WITH_WHAT" +# to element. ''' HTML_ALIAS_RULE = '''\ @@ -53,6 +59,8 @@ HTML_ALIAS_RULE = '''\ FOOTER = '''\ +# Really, do not edit this file. + EXTRA_DIST += \\ {files} ''' -- 2.30.2