Bug#964383: Issues in init-system-helpers man pages

[Michael Biebl]

On Mon, 6 Jul 2020 16:26:58 +0200 Helge Kreutzmann <deb...@helgefjell.de> wrote:

Hello Michael,
On Mon, Jul 06, 2020 at 04:18:22PM +0200, Michael Biebl wrote:
> Am 06.07.20 um 15:41 schrieb Helge Kreutzmann:
> > I'm now reporting the errors for your project. If future reports
> > should use another channel, please let me know.




> This makes it much easier to comment on the individual changes.

I can send each change individually, some other projects (like
man-pages itself) request this. Do you want this in future reports (if
any)?

> https://salsa.debian.org/debian/init-system-helpers/

> > Issue: Groff code broken?

> That man pages is generated via pod2man, could this be a toolchain issue?

Probably.

> > --
> > Man page: deb-systemd-invoke.1p
> > Issue: 206 → 2006?

> page. Can you point the source location?
> Did you by chance confuse that with the service(8) man page which was
> fixed just recently:
> 
https://salsa.debian.org/debian/init-system-helpers/-/commit/f1b835dcb2d6198addfab045676351d70d2930e9


> > --
> > Man page: deb-systemd-invoke.1p
> > Issue: s/it to/to/

> > "init.d/>I<SCRIPT>.  The supported values of I<COMMAND> depend on the invoked 
"
> > "script, B<service> passes I<COMMAND> and I<OPTIONS> it to the init script "
> > "unmodified.  All scripts should support at least the B<start> and B<stop> "
> > "commands.  As a special case, if I<COMMAND> is B<--full-restart>, the script 
"
> > "is run twice, first with the B<stop> command, then with the B<start> 
command."


Sorry, this is also in service.8

> > --
> > Man page: update-rc.d.8

> > Ideally such a change request is submitted via salsa as merge request. As stated in my introduction, this is not (easily) possible, sorry. > > > Man page: deb-systemd-invoke.1p > > > > "\\&B<deb-systemd-invoke> start|stop|restart I<unitÂ\\ file>Â\\ ..." > > Can't really comment on that one. The resulting man page looks fine to me? > > > > "Jan 206" > > > I can't find any reference to "Jan 206" in the deb-systemd-invoke man Yes, my fault, it was service(8). > > > > "The I<SCRIPT> parameter specifies a System V init script, located in B</etc/" > > Can't find that paragraph either

Afaics, all those issues have been resolved or are toolchain issues.
Those closing the bug report.

Thanks,
Michael

OpenPGP_signature
Description: OpenPGP digital signature