Bug#566352: mention when does one run this program

[jid...@jidanni.org]

Package: insserv
Version: 1.12.0-14
Severity: wishlist
File: /usr/share/man/man8/insserv.8.gz

I think the man page perhaps could mention:
*just exactly when is this program is usually run, and by who (OK, root)
*why must one run it, etc.

--
To UNSUBSCRIBE, email to debian-bugs-...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org

[jid...@jidanni.org]

KM> Thanks for taking the time to make this report, do you think you'd also
KM> have the time to patch the manual page to your liking and submit that?
Actually I just found it on my TODO list of things to report, and I had
trouble at first figuring out what I meant. Anyway, definitely a TODO
item. (P.S., I don't know when one is supposed to run this program
myself. :-))

[Kel Modderman]

On Saturday 23 January 2010 15:00:24 jid...@jidanni.org wrote:
> Package: insserv
> Version: 1.12.0-14
> Severity: wishlist
> File: /usr/share/man/man8/insserv.8.gz
>
> I think the man page perhaps could mention:
> *just exactly when is this program is usually run, and by who (OK, root)
> *why must one run it, etc.

Thanks for taking the time to make this report, do you think you'd also

have the time to patch the manual page to your liking and submit that?

Kel.

[Kel Modderman]

On Saturday 23 January 2010 16:07:14 jid...@jidanni.org wrote:
> KM> Thanks for taking the time to make this report, do you think you'd also
> KM> have the time to patch the manual page to your liking and submit that?
> Actually I just found it on my TODO list of things to report, and I had
> trouble at first figuring out what I meant. Anyway, definitely a TODO
> item. (P.S., I don't know when one is supposed to run this program
> myself. :-))
>

You should not run this program normally. It is called by update-rc.d which is
already documentend as the interface for managinig boot services for sysv-rc.

Kel.

[jid...@jidanni.org]

>>>>> "KM" == Kel Modderman <k...@otaku42.de> writes:

KM> You should not run this program normally. It is called by update-rc.d which is
KM> already documentend as the interface for managinig boot services for sysv-rc.

OK, please add that to the man page! Thanks.

[Kel Modderman]

On Sunday 24 January 2010 06:11:17 jid...@jidanni.org wrote:
> >>>>> "KM" == Kel Modderman <k...@otaku42.de> writes:
>
> KM> You should not run this program normally. It is called by update-rc.d which is
> KM> already documentend as the interface for managinig boot services for sysv-rc.
>
> OK, please add that to the man page! Thanks.
>

Can you make a patch? I'd be happy to organise for it to be applied in the
Debian package and upstream.

Kel.

[jid...@jidanni.org]

tags 566352 patch
thanks
--- /tmp/insserv.8.OLD 2009-10-02 02:07:58.000000000 +0800
+++ /tmp/insserv.8 2010-01-24 17:59:37.290380633 +0800
@@ -9,7 +9,7 @@
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
-.TH INSSERV 8 "Jul 29, 2008" "Version 1.11"
+.TH INSSERV 8 "Jan 24, 2010" "Version 1.11"
.UC 8
.SH NAME
insserv \- Enable an installed system init script
@@ -66,6 +66,10 @@
.in -1l
.sp 1
and calculating the dependencies between all scripts.
+.PP
+** One should not run insserv normally. It is called by update-rc.d
+which is the interface for managinig boot services for sysv-rc. **
+.PP
Please be aware that the line
.sp 1
.in +1l
@@ -375,7 +379,8 @@
.\"
.SH SEE ALSO
.BR init (7),
-.BR startpar (8).
+.BR startpar (8),
+.BR update-rc.d (8).
.SH COPYRIGHT
2000\-2008 Werner Fink,
.br