1
0
mirror of git://git.sv.gnu.org/coreutils.git synced 2026-02-10 09:21:58 +02:00

doc: kill: adjust documentation to produce html anchors for --help

* doc/coreutils.texi (kill invocation): Adjust documentation to use the
@optItem macros.
Fixes https://bugs.gnu.org/80339
Fixes https://github.com/coreutils/coreutils/issues/185
This commit is contained in:
Collin Funk
2026-02-05 21:18:25 -08:00
committed by Pádraig Brady
parent 417e43327c
commit 088c011bfc

View File

@@ -18354,18 +18354,30 @@ The first form of the @command{kill} command succeeds if every @var{pid}
argument specifies at least one process that the signal was sent to.
The second form of the @command{kill} command lists signal information.
Either the @option{-l} or @option{--list} option, or the @option{-t}
or @option{--table} option must be specified. Without any
@var{signal} argument, all supported signals are listed. The output
of @option{-l} or @option{--list} is a list of the signal names, one
per line; if @var{signal} is already a name, the signal number is
printed instead. The output of @option{-t} or @option{--table} is a
table of signal numbers, names, and descriptions. This form of the
@command{kill} command succeeds if all @var{signal} arguments are valid
and if there is no output error.
This form of the @command{kill} command succeeds if all @var{signal}
arguments are valid and if there is no output error.
The @command{kill} command also supports the @option{--help} and
@option{--version} options. @xref{Common options}.
The program accepts the following options. Also see @ref{Common options}.
@table @samp
@optAnchor{kill,-SIGNAL}
@optItem{kill,-s,}
@optItemx{kill,--signal,}
Specify the name or number of the signal to be sent.
@optItem{kill,-l,}
@optItemx{kill,--list,}
List the supported signal names one per line if the @var{signal} option
is omitted. If one or more @var{signal} options are provided, they are
converted between signal names and signal numbers.
@optItem{kill,-t,}
@optItemx{kill,--table,}
This option behaves the same way as @option{--list} except it prints a
table of signal numbers, names, and descriptions.
@end table
A @var{signal} may be a signal name like @samp{HUP}, or a signal
number like @samp{1}, or an exit status of a process terminated by the