[bug#62348] [PATCH 1/3] gnu: psmisc: Make description more informative.

[Nicolas Goaziou]

Hello,

Bruno Victal <mirai@makinata.eu> writes:

> From: mikadoZero <mikadozero@yandex.com>
>
> The text for the description is taken from the psmisc readme.
>
> * gnu/packages/linux.scm (psmisc)[description]: Make description more
> informative.

Thanks.

> +     "A package of small utilities that use the proc file-system.

This should be a complete sentence, e.g.,

  Psmisc is a set of small utilities…

> +@itemize @bullet
> +@item @command{fuser} - Identifies processes using files or sockets
> +@item @command{killall} - kills processes by name, e.g. @samp{killall -HUP 
> @var{name}}
> +@item @command{prtstat} - prints statistics of a process
> +@item @command{pslog} - prints log path(s) of a process
> +@item @command{pstree} - shows the currently running processes as a tree
> +@item @command{peekfd} - shows the data travelling over a file descriptor
> +@end itemize")

I suggest to remove the dashes, and probably add semicolons at the end
of all but last item:

  @item @command{fuser} identifies processes using files or sockets;

I suggest to add a comma after "e.g.", so Texinfo cannot consider it to
be the end of a sentence:

  @item @command{killall} kills processes by name, e.g., @samp{killall -HUP 
@var{name}};

Actually, I even wonder if providing an example if worth being in
a generic description. I probably belongs to a user manual:

  @item @command{killall} kills processes by name;

Regards,
-- 
Nicolas Goaziou