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

[Michael Biebl]

On Mon, 6 Jul 2020 16:26:58 +0200 Helge Kreutzmann 
<debian at 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.
> > 
> > Ideally such a change request is submitted via salsa as merge request.
> 
> As stated in my introduction, this is not (easily) possible, sorry. 
> 
> > 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/
> > 
> > > Man page: deb-systemd-invoke.1p
> > > Issue: Groff code broken?
> > > 
> > > "\\&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?
> > That man pages is generated via pod2man, could this be a toolchain issue?
> 
> Probably.
> 
> > > --
> > > Man page: deb-systemd-invoke.1p
> > > Issue: 206 → 2006?
> > > 
> > > "Jan 206"
> > 
> > 
> > I can't find any reference to "Jan 206" in the deb-systemd-invoke man
> > 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
> 
> Yes, my fault, it was service(8). 
> 
> > > --
> > > Man page: deb-systemd-invoke.1p
> > > Issue: s/it to/to/
> > > 
> > > "The I<SCRIPT> parameter specifies a System V init script, located in B</etc/"
> > > "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."
> > 
> > Can't find that paragraph either
> 
> Sorry, this is also in service.8
> 
> > > --
> > > Man page: update-rc.d.8


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

Thanks,
Michael
-------------- next part --------------
A non-text attachment was scrubbed...
Name: OpenPGP_signature
Type: application/pgp-signature
Size: 840 bytes
Desc: OpenPGP digital signature
URL: <http://alioth-lists.debian.net/pipermail/pkg-systemd-maintainers/attachments/20220523/48597440/attachment-0001.sig>