build-sys: update intructions for Makefile-man.am regeneration

1 files changed, 17 insertions, 9 deletions

diff --git a/Makefile-man.am b/Makefile-man.am
index c232f486de..73afdd8c9b 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 <refentry> 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 \