From c4a06ca230ad87da093da8c8cfd68bdb41b0ccdf Mon Sep 17 00:00:00 2001 From: Niels Thykier Date: Sun, 28 Oct 2018 14:59:12 +0000 Subject: dh_installsystemd.1: Improve docs about --name Signed-off-by: Niels Thykier --- dh_installsystemd | 28 ++++++++++++++++++++++------ 1 file changed, 22 insertions(+), 6 deletions(-) (limited to 'dh_installsystemd') diff --git a/dh_installsystemd b/dh_installsystemd index d052037e..d1ba5708 100755 --- a/dh_installsystemd +++ b/dh_installsystemd @@ -82,12 +82,19 @@ should not be started. =item B<--name=>I -Install the service file as I instead of the default -filename I. When this parameter is used, -B looks for and installs files named -F instead of the usual -F. Moreover, maintainer scripts are only -generated for units that match the given I. +This option controls several things. + +It changes the name that B uses when it looks for +maintainer provided systemd unit files as listed in the L +section. As an example, B will look for +F<<< IB<< I >>I<.service> >>> instead of +F<< I >>). These unit files are installed as F<< +I >> (in the example, it would be installed as +F<<< B<< I >>I<.service> >>>). + +Furthermore, if no unit files are passed explicitly as command line +arguments, B will only act on unit files called +I (rather than all unit files found in the package). =item B<--restart-after-upgrade> @@ -122,6 +129,15 @@ B that this option does not affect whether the services are enabled. Please remember to also use B<--no-enable> if the services should not be enabled. +=item S ...> + +Only process and generate maintscripts for the installed unit files +with the (base)name I. + +Note: B will still install unit files from +F but it will not generate any maintscripts for them unless +they are explicitly listed in S ...> + =back =head1 NOTES -- cgit v1.2.3